Table of Contents

Advertisement

Malvern Instruments Zetasizer Series Basic Reference Manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Zetasizer Series and is the answer not in the manual?

Questions and answers

Summary of Contents for Malvern Instruments Zetasizer Series

  • Page 2 Manual Number MAN 0179 Issue 1.0 February 1997 © Malvern Instruments Ltd, 1997. Spring Lane South, Malvern, Worcs.WR14 1XZ Telephone: +44 (0) 1684 892456 Fax: +44 (0) 1684 892789 Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 3  Malvern Instruments Ltd. 1997 Malvern Instruments makes every effort to ensure that this document is correct. However, due to Malvern Instruments policy of continual product development we are unable to guarantee the accuracy of this, or any other document after the date of publication.
  • Page 4: Table Of Contents

    Contents MAN 0179 CHAPTER 1 Welcome Systems covered by this manual Asumed information Windows Terms Menu Commands Where to find information Reporting Problems Other reading CHAPTER 2 Introduction Building blocks of programs Commands and functions Constants and variables Arrays Expressions and operators Control Structures 2.7.1 Tests and Branches...
  • Page 5 MAN0179 4.17 Calculate Command 4-11 4.18 CalcZimm Command 4-11 4.19 Capscan Command 4-11 4.20 ChangeTable Command 4-11 4.21 ChDir Command 4-11 4.22 Chr$(character) Function 4-11 4.23 Clear Command 4-12 4.24 Comm Command 4-12 4.25 Common Command 4-12 4.26 Copy Command 4-13 4.27 Corr Command...
  • Page 6 Contents MAN 0179 4.72 If Command 4-32 4.73 Inp Function 4-33 4.74 Input Command 4-33 4.75 InRange Function 4-33 4.76 InStr function. 4-34 4.77 Int Function 4-34 4.78 Intensity Function 4-34 4.79 Iscan Mode command 4-34 4.80 InstrumentType Function 4-35 4.81 LastPoint Function 4-35...
  • Page 7 MAN0179 4.127 RecordNumber Function 4-53 4.128 Reference Function 4-53 4.129 Residuals 4-53 4.130 Return 4-53 4.131 4-53 4.132 Right$ Function 4-54 4.133 RTrim$ Function 4-54 4.134 4-54 4.135 RunMode 4-54 4.136 SampleTime 4-55 4.137 Save Command 4-55 4.138 ScaledCount 4-55 4.139 ScanAngle 4-55...
  • Page 8 Contents MAN 0179 4.182 ZAnal2 4-69 4.183 ZAveMean Function 4-69 4.184 ZeroFieldWidth Function 4-70 4.185 ZetaChannels Function 4-70 4.186 ZetaPotential Function 4-70 4.187 ZetaSpectrum 4-70 4.188 ZetaVar 4-70 4.189 ZimmError Function 4-71 4.190 ZimmFitOrder Function 4-71 4.191 ZimmNumConcs 4-71 4.192 ZimmNumAngles 4-71 4.193...
  • Page 9 MAN0179 Page 6 Zetasizer 1000/2000/3000/4000/5000/4700 Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 10 CHAPTER 1 Introduction to this manual Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 11 Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 12: Welcome

    Introduction MAN 0179 1.1 Welcome Welcome to the Malvern Basic Reference manual. This manual has been designed to give a detailed description of the operation and use of Malvern Basic. It gives details on the structure of a Malvern Basic program and details all commands available. Warning: You must remember that the Zetasizer or the samples to be measured are potentially dangerous if misused.
  • Page 13 MAN0179 Double-click - Press and release the mouse button twice in quick succession. If this is not qualified with a button description then assume it is the left button. Use the Mouse icon in Program Managers Control Panel to change the double-click speed. Dialogue Box - A window containing controls.
  • Page 14: Menu Commands

    Introduction MAN 0179 Drag - An action with the mouse which involves moving the mouse while holding down the left mouse button. This is used for moving icons or making multiple selections in a list box. 1.5 Menu Commands Menu commands from the Malvern software are referred to in the form main menu-menu item. As an example, the command File-Save Sample refers to selecting the Save Sample item in the File menu.
  • Page 15 CHAPTER 2 Introduction to Zetasizer basic Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 16 Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 17: Introduction

    Introduction to Zetasizer basic MAN 0179 2.1 Introduction The program language used in the Zetasizer software is similar to many other variants of Basic. Some features of other versions are not needed for our application and many extra functions have been added for specific use in particle sizing. Throughout these notes the term Basic will mean the specific Malvern Zetasizer version of the language.
  • Page 18: Building Blocks Of Programs

    MAN0179 The use of line numbers with tests to change the order of execution. Basic is not case sensitive. That is, you can use upper and lower case characters in any combination. Spaces are not significant. Thus, RectWidth = Val ( X$ ) RectWidth = Val ( X$ ) are equivalent.
  • Page 19: Commands And Functions

    Introduction to Zetasizer basic MAN 0179 2.3 Commands and functions Commands may perform a variety of actions depending on the choice made by additional parameters. They may also modify those actions with further parameters. Functions may be similarly modified. The full list of all functions and commands (over 200 items and all their variant parameters) will not be described in detail here.
  • Page 20: Arrays

    MAN0179 There is space for 50 user variables in any program. An error is reported if this number is exceeded. If one program calls another the variables in the calling program are not accessible from the called program (but see below for arrays). It is good practice to choose variable names which describe the values they will contain.
  • Page 21: Expressions And Operators

    Introduction to Zetasizer basic MAN 0179 Array elements may be used in any place in which a simple variable is used. For example: Dim X ( 5 ), Y ( 5 ) For i = 0 To 5 A$ = InputBox$ ( “ ”, “ ”, “1.0" ) X ( i ) = Val ( A$ ) Y ( i ) = Log10 ( X ( i ) ) Next...
  • Page 22: Control Structures

    MAN0179 * / % Multiply, divide and modulo. Addition and subtraction. < >= Relational operators. >= Relational operator. <= Relational operator. <> Relational operator. Bit-wise OR operator. & Bit-wise AND operator. The expressions are evaluated left to right except with exponentiation which evaluates right to left.
  • Page 23 Introduction to Zetasizer basic MAN 0179 When the program reaches this line it evaluates the expression and if the answer is false (i.e. the expression evaluates to 0.0) the rest of the line is ignored. Otherwise the command is executed. example: If CountsPerSec <...
  • Page 24: Subroutines

    MAN0179 If the test is false the block is ignored and the Print Report will be executed. But, if it is true we will get the warning and still get the Print Report. We could get round this in two ways. The GoTo command could be used: If CountsPerSec <...
  • Page 25: Loops

    Introduction to Zetasizer basic MAN 0179 2.7.3 Loops It is often useful to be able to perform a group of operations a number of times in a loop. achieve this Basic has the structure: For variable = expression1 To expression2 Next The counter variable...
  • Page 26: Nesting

    MAN0179 For i = 1 To LastRecord Step 2 Load Record i DifferenceRecord i + 1 View Difference Pause 10 Next 2.7.4 Nesting Control structures may be nested, that is placed one inside another. If .. Then can be placed inside For ...
  • Page 27: Functions - A Review

    Introduction to Zetasizer basic MAN 0179 A program may also be run automatically when the Zetasizer software is first started. This may be used, for example, to automatically start a measurement sequence. See Control-Assign Program in the Software Reference Manual for more information. 2.9 Functions - a review There are over 220 functions available but they will not all be dealt with individually here.
  • Page 28: Running A Program

    MAN0179 File-Exit Close the editor window Edit-Undo Undo the last edit Edit-Cut Cut the selected text to the clipboard Edit-Copy Copy the selected text to the clipboard Edit-Paste Paste at the cursor the text in the clipboard Edit-Delete Delete the selected text The Run button runs the program and changes to show Stop.
  • Page 29: Basic Errors

    Introduction to Zetasizer basic MAN 0179 Load Record N If Error = 0 Then Print Report Else X = Print Dialogue “Record no found” End if The values of any error codes which might be returned and their meanings are shown in the description of each individual command and function.
  • Page 30 MAN0179 Undefined label There is a Goto or Gosub which uses a label which you have not included in your Program. correct this check that you have typed the label correctly. Add the required label if necessary. THEN expected There is an statement which is incomplete.
  • Page 31 Introduction to Zetasizer basic MAN 0179 Next Load Record I Print Report Return Too many variables You are allowed a maximum of 50 variables in any program. Try reducing the number you use using expressions and not calculating intermediate values as variables. For example: X = I + 1 Y = 10 * X Z = J...
  • Page 32 MAN0179 End if Divide by Zero An attempt has been made to divide by an expression which evaluates to zero. This is often caused by mis-spelling a variable name or forgetting to assign a value. For example: NewX = I + 3 Y = 1 / NwX Math domain error You have used a Math function with an illegal expression.
  • Page 33 CHAPTER 3 Designing pages and reports Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 34 Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 35: Introduction

    Designing pages and reports MAN 0179 3.1 Introduction The standard tables and reports provided with the Zetasizer system are produced by various page and report programs. A page (or report) program is a “script” written in Malvern Page Description Language (PDL), which allows selection of the display items, text, graphics, and font and format of the displayed text.
  • Page 36 MAN0179 page or report. This name appears in the View menu when the page is assigned and when the Info button is pressed in the Setup - Table dialogue. During editing your program you can use the Run button in the editor to test the program, the table or report you are editing will be shown on screen.
  • Page 37 CHAPTER 4 Zetasizer Basic reference Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 38 Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 39: List Of All Commands And Functions

    Zetasizer Basic reference MAN 0179 4.1 List of All commands and functions Abort Command ABS() Function Achannel Function ACOS Function AnalysisType Function Analysis Command Angle Command ASC Function Asin Function Asm Command BackGround Function BackGroundRatio Function Bchannel Function Beep Command Box Function CalcFarPoint Function Calculate Command...
  • Page 40 MAN0179 FirstPoint Function Fit Function Fitdata Function FitNum FitOrder Function FitTime Function FitResiduals Function Font Command For Command Format$ Frequency Function FrequencyChannels Function Get Function Gosub command Goto Graph Keep command If Command Inp Function Input Command InRange Function InStr function. Int Function Intensity Function Iscan Mode command...
  • Page 41 Zetasizer Basic reference MAN 0179 Number function NumChannels function NumFreq Function NumScans Function NumSizes Open Command OsmoticMob Function Out Command Page Command Pause Peak Command Picture Command Polydispersity Function Print Command Print Page Command Print Report Command Print ...Using command Range RawFreq Function RecordNumber Function...
  • Page 42 MAN0179 TotalSamples Transfer Command UCase$ Use Command Val Function View ViewNew Command Virial2 Function Virial3 Function Volume Write WriteAt Command Xchar Function Xpage Function Xpos Function Ychar Function Ypage Function Ypos Function ZAnal1 ZAnal2 ZAveMean Function ZeroFieldWidth Function ZetaChannels Function ZetaPotential Function ZetaSpectrum ZetaVar...
  • Page 43: Abort Command

    Zetasizer Basic reference MAN 0179 4.1 Abort Command Application Aborts measurement sequence. Syntax Abort 4.2 ABS() Function Application Return the absolute (constrained positive) value of the argument. Syntax Abs(x) Notes This function returns the absolute value of a number. Example b=-123 a=abs(b) print dialogue using “####”, a ‘prints 123 in a dialogue box.
  • Page 44: Analysistype Function

    MAN0179 4.5 AnalysisType Function Application Returns current analysis type of record. Syntax AnalysisType Notes The return value can be interpreted as follows:- 0 = monomodal(Cumulant method), 1 = multimodal sampling, 2 = Multi Angle, 3 = Contin 4 = NNLS 5 = Automatic 4.6 Analysis Command Application...
  • Page 45: Angle Command

    Zetasizer Basic reference MAN 0179 4.7 Angle Command Application Instrument control Syntax Angle (x) Notes Set angle on instrument connected if the instrument has multi-angle properties. 4.8 ASC Function Application Get ASCII code of string Syntax ASC(Str$ ) Notes This function returns the numerical ASCII value of the first character of Str$. Example ASC(“ALPHA”) ‘return 65 - the ASCII value of ‘A’...
  • Page 46 MAN0179 Asm Rows NumberRows Asm Columns NumberColumns Asm RackCode RackCode Asm Height Height Notes Asm Ini[,port,baud rate] Initialise Autosampler. Optionally set RS232 port number and baud rate. These can also be set under Setup RS232 from the menu. Wait Waits for string (if none “END”) File 10meSends ascii file to autosampler Ini iPortInitialises gilson on comm port i Tube Goto tube i...
  • Page 47: Background Function

    Zetasizer Basic reference MAN 0179 Syr [,n1][,n2] Define device to use for dilution. Default n1=0, n2=10000. (use diluter 0, volume 10000 microliters) RackCode Set the Autosampler rackcode. Consult your Gilson manual for details. Rows Number of rows in the sample tray. This is needed for the Tube command to address the correct row and column correctly.
  • Page 48: Bchannel Function

    MAN0179 Notes The background ratio is derived from the ratio of the far point, and the theoretical background or baseline value derived from the monitor channels. This is primarily used as an indication of signal quality for a size measurement. It is further used to derive In Range. 4.13 Bchannel Function Application Data information for Size and Zeta records.
  • Page 49: Calculate Command

    Zetasizer Basic reference MAN 0179 4.17 Calculate Command Application Does calculation with current analysis. Syntax Calculate Notes The calculate command operates on the record currently in memory. Note that the commands Select, Load Rec, Transfer implicitly load a record into memory. Size mode Does calculation with analysis set by the Analysis Analysistype command on the record currently in memory.
  • Page 50: Clear Command

    MAN0179 4.23 Clear Command Application Clears the live buffer of records. Close Command Application Closes specified device. Syntax Close File Close Comm Notes Close File Closes the ASCII file opened by the File command without deleting it, permitting input/output to start from the start of the file.
  • Page 51: Copy Command

    Zetasizer Basic reference MAN 0179 Examples common dim a(100) ‘ No separate declaration is needed. common b,c 4.26 Copy Command Application Copy information via the DDE to the Clipboard or another Application. Syntax Copy Graph Copy Table Copy Link Copy String Notes Copy Graph Copy Table...
  • Page 52 MAN0179 Corr divide Corr live Corr rate Corr select Corr test TestClock [,Test] Corr CountRate Notes Prescale This is applicable to the 7032 only. It sets the prescale values of the various sub-groups of the correlator. If no arguments are supplied, auto prescale is implied. Wait Wait for experiment to finish (use after Start) Clear...
  • Page 53: Cos( ) Function

    Zetasizer Basic reference MAN 0179 Config Bring up Config dialog from Correlator control window. Serial Brings up dialogue box for user to enter settings like sample time, duration etc. Parallel Brings up dialogue box for user to enter settings like sample time, duration etc. CountRate Returns the current countrate measured by the correlator.
  • Page 54: Countspersec Function

    MAN0179 Example a=3.14159 print dialog using “##.###”,cos(a) ‘will display -1.000 4.29 CountsPerSec Function Application Returns the value of the Counts per second stored in the data of the current record. Syntax CountsPerSec () Notes By definition this is equal to the contents of the A monitor channel divided by the time in seconds that the correlator ran to gather that data.
  • Page 55 Zetasizer Basic reference MAN 0179 Data QualityFactor Returns the quality factor (one or zero). The quality is satisfactory if the function returns one. Data Parameter_Function Returns the value of the particular Parameter_Function in the record. Valid values of Parameter_Function commands are:- data CellType Instrument CellType...
  • Page 56: Datatype Function

    MAN0179 4.33 DataType Function Application Sets data type of the function Syntax DataType n Notes In Size mode this flag determines whether the data is a first or second order correlation function, depending on whether the value is 1 or 2 respectively. In Zeta mode this flag determines whether the raw zerofield width is used or a voltage corrected zerofield width is used, depending on whether the value is 2 or 1 respectively.
  • Page 57: Delay Function

    Zetasizer Basic reference MAN 0179 conversation_number. The string item$ is the item name assigned to the data and is application dependent. The data sent will be the information held in the Basic system string if the parameter string$ is not supplied (see Print String) otherwise the data in string$ will be sent. DDE Execute converation_number, command$ The command allows the user to send a command to another application known as the server linked by conversation_number.
  • Page 58: Dilation Function

    MAN0179 Example File “tempdata.txt” Delete File 4.38 Dilation Function Application Result and data information from Size records. Syntax Dilation Notes The dilation setting of the correlator, ie. the sample time multiplier between the different store blocks. For the 7132 and 70128 correlators this is always two. 4.39 Dim Command Application Basic variable definition...
  • Page 59 Zetasizer Basic reference MAN 0179 Syntax Edit Note1 Edit Note2 Edit Note3 Edit Program Edit TimeArray i , Edit StoreChannel i, Edit Parameter_keyword, Edit AChannel Edit BChannel Edit SampleTime Edit TotalSamples Notes Alter the value of a parameter of the current record in memory. For a permanent change the record should be Saved.
  • Page 60: Elapsedtime Function

    MAN0179 4.42 ElapsedTime Function Application System command Syntax Elapsedtime Notes Returns the time elapsed since the start of the current session. 4.43 ElectroMobility Application Result information from Zeta record Syntax ElectroMobility Notes Returns the mobility calculated from a Capillary scan calculation (assuming a ZET5104 cell). 4.44 Else Command Part of the If ..
  • Page 61: Else Command

    Zetasizer Basic reference MAN 0179 value of cutoff defines the noise threshold as percentage of the maximum peak height. This command is intended for diagnostic purposes only. 4.46 Else Command Part of If ... Then ... Else... End If construct. See If for more information. 4.47 End Command Application Program control.
  • Page 62: Execute Command

    MAN0179 Notes The square root of the average of the squared residuals, ie SUM(FitData - Fit)2 /FitNum from the calculation of size distribution for the current record. 4.50 Execute Command Application Staring other windows applications. Syntax Execute Maximised program_name$, max_number_instances Execute Minimised program_name$, max_number_instances Execute Normal...
  • Page 63: Fillcolour

    Zetasizer Basic reference MAN 0179 Syntax File filename$ Notes This command names the file to be used with the Print, Delete, Input and Close File commands. filename$ is the full file name but without a pathname. The file is opened at the origin. Example NL$ = chr$(13) F$ = “Please enter a filename”...
  • Page 64: Fitdata Function

    MAN0179 Notes The value of channel ichannel of the fit. The fit is that distribution which exactly corresponds to a given size distribution. 4.57 Fitdata Function Application Results information for sizing records. Syntax FitData(iChannel) Notes The value of channel iChannel of the normalised correlation function from the set actually fitted, the delay time being returned using FitTime.
  • Page 65: Fitresiduals Function

    Zetasizer Basic reference MAN 0179 4.61 FitResiduals Function Application Results information for sizing records. Syntax FitResiduals i Notes The residual associated with the ith point actually included in the fitting process. 4.62 Font Command Application For use in page programs. Syntax Font iFont changes font i...
  • Page 66: Format

    MAN0179 For i = 1 to 10 For j = 1 to 20 print status count count = count + 1 Next Next 4.64 Format$ Application String formatting function. Syntax Format$( format_string$, variable1, variable2, ...) Notes variable1, variable2 and any other variables (represented by ...) in the list are converted according to format specifiers in format_string$.
  • Page 67 Zetasizer Basic reference MAN 0179 ModulatorFrequency RefIndex Viscosity Angle Temperature Wavelength Conductivity CalibrationConst FringeSpacing Dielectric CellType Density RFReal RFImag MarkhowinkA MarkhowinkK Cellposition Width LaserPower CellCUrrent VoltageDiff CurrentDiff CoreRatio RFRealCore RFImagCore Concentration RFStandard DnDc RayleighRatio Notes Zerofieldwidth returns the value of the ZeroFieldWidth ModulatorFrequency returns system modulator frequency RefIndex...
  • Page 68: Gosub Command

    MAN0179 CellCurrent returns system CellCurrent value VoltageDiff returns system VoltageDiff value CurrentDiff returns system CurrentDiff value CoreRatio returns system CoreRatio value RFRealCore returns system RFRealCore value RFImagCore returns system RFImagCore value returns system Fka value Concentration returns system Concentration value RFStandardcase returns system RFStandard value...
  • Page 69: Graph

    Zetasizer Basic reference MAN 0179 4.70 Graph Application Configuration of graphs. Syntax Graph Pref graph_type Graph Limits graph_type x_min ,x_max Graph Scaling graph_type x_min, x_max Graph Xlimits graph_type x_min,x_max Graph Ylimits graph_type y_min,y_max Graph Styles graph_type graticules, fill_type Notes In the following graph_type is a keyword that can be one of the following:- Size mode Intensity Number...
  • Page 70: Keep Command

    MAN0179 1 Colour fill 2 Histogram 3 Colour filled histogram 4.71 Keep command Application Record management for the live records buffer. Syntax Keep n Notes Keep n Saves the current record as record n of the live buffer. The companion function is Select n. Be aware that selecting a record and then modifying it by say analysing it will not permanently save the changes in the buffer.
  • Page 71: Inp Function

    Zetasizer Basic reference MAN 0179 4.73 Inp Function Application Computer port function. Syntax Inp address Notes The Inp function returns the value from an input port on a PC ISA bus. 4.74 Input Command Application Data input from external device. Syntax Input prompt_string$, input_value Input Prompt_string$, input_string$...
  • Page 72: Instr Function

    MAN0179 4.76 InStr function. Application String Function Syntax InStr( start, String$ ,SearchString$) Notes This function returns the position of the string search$ in string$ starting at position start. If start is omitted then the search starts at the first character. If search$ does not appear in string$ the function returns 0.
  • Page 73: Instrumenttype Function

    Zetasizer Basic reference MAN 0179 4.80 InstrumentType Function Application Instrument function. Syntax InstrumentType Notes The numbers currently defined are as follows:- AutoSizer 2C Lo-C Hi-C ZetaSizer 4 ZetaSizer 4S 4700 4700 Manual Zetamaster Zetamaster S ZetaSizer 1000 ZetaSizer 2000 ZetaSizer 3000 ZetaSizer 4000 ZetaSizer 5000 4700 with PCS78...
  • Page 74: Left$ Function

    MAN0179 4.83 Left$ Function Application String function. Syntax Left$(string$,n) Notes This function returns a string made up of the first ncharacters of string$. If n is greater than the number of characters in string$ then the whole string is returned. Example After the call A$ contains “Ab”...
  • Page 75: Ln Function

    Zetasizer Basic reference MAN 0179 Syntax LineColour n Notes This command changes the line colour of the lines draw on tables. n is the line colour as an index into the PCS colour palette. Use the Setup Table dialog to see the list of colours. Only values of n between 1 and 15 can be used.
  • Page 76: Log Function

    MAN0179 Loads record i from the current file into memory. If changes are made to this record that you wish to save, remember to use the Save Record command. Load Contin i Loads record i from the set of records produced by the last Contin analysis into memory. Load Configuration FileName$ Loads a PCS configuration file.
  • Page 77: Measure Command

    Zetasizer Basic reference MAN 0179 Notes Recalculate the answer on the currently selected records using the current analysis, replacing the changed records in their original places. 4.94 MDelete Command Application File system command. Syntax MDelete Notes Deletes all records in file. See clear.
  • Page 78: Merit Function

    MAN0179 Measure DocumentDocument dialog Initiates the Measure Document dialog Measure DurationMeasurement duration Sets experiment duration. Execution of this command will set the measurement duration of the measurement relevent to the current mode. For example in Intensity mode the durations of the TimeTrace/AngleScan measurements will be set.
  • Page 79: Mid$ Function

    Zetasizer Basic reference MAN 0179 Notes Caption$ Caption displayed by message box. Message$ Message string displayed by message box. Style The following values can be added together. OK button, No Icon Ok & Cancel Abort, Retry & Ignore Yes, No & Cancel Yes &...
  • Page 80: Mload Command

    MAN0179 Notes Returns scattering Intensity calculated by Lorentz Mie theory for a layered spherical particle. For a homogeneous particle CoreRatio=0. The wavelength of the illuminating light is set in the current record, and could be altered by set wavelength. The parameters are as follows:- diameter particle diameter in nm.
  • Page 81: Mobilitychannels Function

    Zetasizer Basic reference MAN 0179 4.102 MobilityChannels Function Application Result information from Zeta record Syntax MobilityChannels i Notes Returns ith channel of spectrum in mobility space. The channels are defined by the Fourier transform underlying the analysis. 4.103 MolecularWeight Application Result information from intensity record.
  • Page 82: Msave

    MAN0179 Syntax MPrint Notes Prints current selection of records. These have been selected using Select and MSelect. They are selected from the live records buffer or current file according to whether Use Buffer or Use Disk have been used. 4.106 Msave Application File and record management Syntax...
  • Page 83: Numchannels Function

    Zetasizer Basic reference MAN 0179 4.109 NumChannels function Application Results information from Size record. Syntax NumChannels Notes Returns the number of correlator channels used in current record. 4.110 NumFreq Function Application Results information from Size record. Syntax NumFreq Notes Number of frequency channels in Fourier transform result. 4.111 NumScans Function Application Data information from Intensity record.
  • Page 84: Osmoticmob Function

    MAN0179 Notes Open File file_name$ A file is opened in the current directory. If the file extension is omitted one of the same type as the current mode (ie .sz2, .zet etc.) will be included. Opens new data file for the current mode. If an extension is not given then one will be supplied.
  • Page 85: Page Command

    Zetasizer Basic reference MAN 0179 Notes Outputs a 16 bit digital value to the port address on the computer bus. 4.116 Page Command Application Page program design. Syntax page page_name$, x_extent, y_extent Notes Specifies page size (in mm). Program name is used as a label which is longer and therefore potentially more descriptive than the filename containing the page program.
  • Page 86: Picture Command

    MAN0179 Zeta Mobility Frequency The following keywords are valid:- Area Means Width Number Peak Area i Return the relative area of the ith mode of the distribution as a percentage of the complete distribution. The value of i must be greater than zero and less than or equal to the total number of peaks in the distribution.
  • Page 87: Polydispersity Function

    Zetasizer Basic reference MAN 0179 Picture number Picture volume Picture residuals Picture zetadata Picture sizedata Picture correlogram Picture Picture molecularweight Picture relaxationtime Picture diffusion Picture mobility Picture zeta Picture frequency Picture rawfreq Picture fringemodel Picture inverseQScan Picture Qscan Picture anglescan Picture zimmplot Picture...
  • Page 88: Print Page Command

    MAN0179 Print String, expression_list Print Dialog expression_list Print Comm expression_list Print Remote expression_list Print Printer expression_list Print a$ using expression_list Notes These commands print the result of a list of expressions to different destinations. expression_list is a list of expressions containing variables, constants, string variables or quoted strings. Each expression is separated by a comma or by a semi-colon.
  • Page 89: Print Report Command

    Zetasizer Basic reference MAN 0179 FitFit the graph to the page (when another option has been selected). If no parameters are supplied use print dialog 4.123 Print Report Command Application Prints report to paper Syntax Print Report [,PageFile1$] [, PageFile2$] Notes If no parameters are supplied, then the currently selected options are used.
  • Page 90: Range

    MAN0179 ###.### 123.456 ###.## 123.46 #### 1234 #.####^^^^ 1.2345ED2 String Characters To format a string variable, string functions or quoted strings use the $ character to represent each character of the string. The character string is left justified in the format string if the format string is longer than required., For long strings you do not need to use a large number of $ characters.
  • Page 91: Rawfreq Function

    Zetasizer Basic reference MAN 0179 Syntax RadiusOfGyration Notes Results of Zimm Calculation (Rg from all points fitted simultaneously, so not ,in general, equal to average Rg values for different records) 4.127 RawFreq Function Application Results information for Zeta record Syntax RawFreq (index) Notes Intensity of Fourier transform (for electrophoresis data) at given channel, the number of channels...
  • Page 92: Return

    MAN0179 4.131 Return Application Returns from GoSub. 4.132 Rg Application Result information for intensity record Syntax Notes Returns the radius of gyration from a Guinier plot. This is different from the Radius of gyration as calculated from a Zimm plot. 4.133 Right$ Function Application String function.
  • Page 93: Runmode

    Zetasizer Basic reference MAN 0179 4.136 RunMode Application Program control Syntax RunMode warning, exclusive Notes This command controls the current running mode of the program. If the expression warning is greater than zero then any command that fails will cause a message box to appear on the screen. Normally between each command in the BASIC program any pending Windows messages are processed.
  • Page 94: Scanangle

    MAN0179 Syntax ScaledCount i Notes Returns the ith scaled count monitor channel. 4.140 ScanAngle Application Data information from an Intensity record. Syntax ScanAngle i Notes Returns the angle at which the ith measurement of an angle scan was performed. 4.141 ScanDuration Application Data information from an Intensity record.
  • Page 95: Select Command

    Zetasizer Basic reference MAN 0179 values are valid:- Time trace scan Angle scan Zimm scan Standard scan Background scan Zeroconcentration scan Zero concentration standard scan. (Zero concentration measurement copied from standard scan) Debye scan 4.144 Select Command Application Record management Syntax Select irecord Notes...
  • Page 96: Setup Command

    MAN0179 Set CellSpacing Set RFReal Set RFImag Set MarkhowinkA Set MarkhowinkK Set Cellposition Set Ph Set LaserPower Set CellCurrent Set CoreRatio Set RFRealCore Set RFImagCore Set Fka Set Concentration Set RFStandard Set DnDc Set RayleighRatio Notes See Get command for details on the various commands. 4.146 Setup Command Application Setup system configuration.
  • Page 97: Setup Report

    Zetasizer Basic reference MAN 0179 Notes Setup Table Displays the Setup Table dialog. Setup Table name Set table for table type Table_name to a user defined page program , page_file$. 4.148 Setup Report Application Configure printed report setup. Syntax Setup Report [,page1$ ,page2$] Notes Set report pages to page1$ and page2$.
  • Page 98: Setup Userlogtable

    MAN0179 AngleEnd End angle of measurement ElapsedTime Time at which measurment was started Conductivity Conductivity NumPoints Number of points used in analysis Title Title 4.150 Setup Userlogtable Application Configure user log table. Syntax Setup Userlogtable x1, x2, ..Notes This command configures the user log table so that the table displays the options x1, x2 ... Valid option keywords are as for the Setup Userlogplot command.
  • Page 99: Size Mode Command

    Zetasizer Basic reference MAN 0179 4.152 Size Mode Command Application System command Syntax Size Mode Notes Put system into size mode. 4.153 Sizes Function Application Result information from a Size record. Syntax Sizes i Notes Size Class(i) in nanometres. i ranges from 1 to NumSizes. 4.154 Spacing Application Result information from a Size record.
  • Page 100: Storechannel

    MAN0179 4.157 StoreChannel Application Result information from an Size or Zeta record. Syntax StoreChannel i Notes Contents of the ith store channel of the correlator data stored in the current record 4.158 Str$ Function Application String command Syntax Str$(value) Notes Returns a string representaion for the number value (or result of numeric expression) 4.159 StrCmp Command Application...
  • Page 101: Textcolour

    Zetasizer Basic reference MAN 0179 WriteAt Xpage/2, 5, “Label centred on the page” 4.161 TextColour Application Table and report text output For use in pages and reports only. Syntax TextColour text [, background] Notes This command changes the colour of subsequent text output by the write command. Text and background are indices in the Zetasizer colour palette.
  • Page 102: Transfer Command

    MAN0179 4.165 To This is part of the For...To...Next construct See the For command for details 4.166 Transfer Command Application File and record management Syntax Transfer i Notes Transfers correlator data and associated parameters to ith position in buffer. If i is omitted the data block is appended to the existing contents of the buffer.
  • Page 103: View

    Zetasizer Basic reference MAN 0179 Syntax Val(String$) Notes This function returns the number represented by string$. If the string does not represent a number, 0, is returned. 4.170 View Application Displaying graphs and tables. Syntax Size mode View Details View View current View...
  • Page 104: Viewnew Command

    MAN0179 Notes Views selected records by adding them to the plot area in the selected type and style. 4.171 ViewNew Command As for the View command described above but clears the existing display first 4.172 Virial2 Function Application Virial coefficients from Zimm plot calculation Syntax Virial2 Notes...
  • Page 105: Writeat Command

    Zetasizer Basic reference MAN 0179 set by the last TextColour command and the alignment set by the last TextAlign command. expression_list is a list of expressions containing variables, constants, string variables or quoted strings. Each expresion is separated by a comma. The format$ contains information on how to format each item in the expression list and must not exceed 255 characters in length.
  • Page 106: Xchar Function

    MAN0179 Notes This command is similar to the write command but allows the starting point for the text to position as well. The anchor point is moved to x mm from the left margin and y mm from the top margin. 4.177 Xchar Function Application Page programming.
  • Page 107: Ypos Function

    Zetasizer Basic reference MAN 0179 Synax YPage Notes Returns length of the page in mm. 4.182 Ypos Function Application Report table position. Syntax YPos Notes Returns the current y (vertical) position in mm of the anchor point from the top margin of the page.
  • Page 108: Zerofieldwidth Function

    MAN0179 4.186 ZeroFieldWidth Function Application Data information for Zeta records. Syntax ZeroFieldWidth Notes Returns the width of the zerofield measurement performed when the data was collected. If no measurement was performed then the value will be zero. 4.187 ZetaChannels Function Application Result information from current Zeta record.
  • Page 109: Zimmerror Function

    Zetasizer Basic reference MAN 0179 Syntax ZetaVar Notes Width of Zeta potential distribution. 4.191 ZimmError Function Application Returns the fit error of a Zimm plot Syntax ZimmError Notes Returns the global fit error of the Zimm plot. 4.192 ZimmFitOrder Function Application Returns the order of fit of a Zimm plot.
  • Page 110: Zimmangle Function

    MAN0179 Syntax ZimmNumPoints Notes Total number of calculated points in Zimm plot 4.196 ZimmAngle Function Application Data information for intensity record. Syntax ZimmAngle (concentration, angle) Notes Return angle of a particular point on a Zimm plot 4.197 ZimmQ Function Application Returns wavevector of a particular point on a Zimm plot.
  • Page 111: Zimmfit

    Zetasizer Basic reference MAN 0179 4.200 ZimmFit Application Data information for intensity record. 4.201 ZimmConc Application ZimmFit(iConc, iAngle) Concentration of a particular point (g/l) 4.202 ZimmFitorder Application Result information from an intensity record Syntax ZimmFitOrder Notes Order of fit in concentration. 4.203 ZimmError Application Result information from an intensity record.
  • Page 112 MAN0179 Zeta Start Zeta Stop Zeta Angle (number) Zeta ReadTemperature Zeta Temperature (number) Zeta Inject (number) Zeta Flush (number) Zeta Shu (number) Zeta ModFreq (number) Zeta OnTime (number) Zeta OffTime (number) Zeta Strobe (number) Zeta OnTime (number) Zeta Shutter(number) Zeta Valve (number, number) Zeta Mode Zeta CellPosition (number) Zeta GetSystemArray (number)
  • Page 113: Zetapotential

    Zetasizer Basic reference MAN 0179 Zeta Inject x Send an Inject command to the optics. For a unit fitted with a sample handling unit, and that unit enabled an Inject sequence will start. The command will then terminate when the sample injection is complete.
  • Page 114: Zetavalue Function

    MAN0179 Notes Zeta potential result of current record. ie. the mean value. 4.207 ZetaValue Function Application Value of intensity at given zeta potential of current record. Syntax ZetaValue (z) Notes Returns the value of the intensity corresponding to the zeta value of number. 4.208 ZetaVar Function Application Zeta potential width of current record.
  • Page 115 CHAPTER 5 Advanced Features Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 116 Artisan Scientific - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisan-scientific.com...
  • Page 117: Exchange Of Data With Other Programs

    Advanced Features MAN 0179 5.1 Exchange of Data with other programs Two basic methods are available to the user. DDE (dynamic data exchange) is a message passing system which can be used to set up a link to other applications This is essentially a Macro program in the PCS program which is run to transmit the necessary data.
  • Page 118 MAN0179 We show such an example below for communication with the spreadsheet program Excel. Valid items for Excel include strings of the form “R1C1", which addresses row 1 column 1 in a spreadsheet document. In the example we make use of the Macro language string handling capability to randomly access the first two columns of the target spreadsheet.
  • Page 119: Transferring Data By File

    Advanced Features MAN 0179 5.1.2 Transferring data by File In the example listed below (PCOEX.PCM) a program has been written to dump the major parameters of a PCS correlation experiment to disk. This program is named PCOEX by analogy to a command (PCO) in previous DOS based Malvern software which ‘put the correlogram’ to a specified file or device, for processing by other programs.
  • Page 120 MAN0179 524296 520346 516587 512896 509013 505311 503627 499345 495914 541193 524698 509311 496582 485082 474354 464848 457085 450052 444154 438557 433481 428824 ————————————— 395565 395493 395372 394850 427010 400173 396249 395156 394904 394946 394994 395353 395009 395060 394969 394878 394742 395195 395048...
  • Page 121: Transferring Data By Macro Program Via The Clipboard

    Advanced Features MAN 0179 A simple variant of this program could readily be used to output results rather than data. Please refer to one of the supplied ‘page programs’ (sizerep1, zetarep1) that display results. The functions sizes intensity that return size classes and contents could easily be used with print file using rather than...
  • Page 122: Remote Control

    MAN0179 keyboard/mouse again. Alternately a startup program might be in control for the entire session, possibly responding to remotely signalled DDE events (running with the Autosampler Scheduler programme is a case in point). A program might run in a completely stand alone way, performing a series of processing steps, then terminate using the Exit command.

Table of Contents