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.
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...
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.
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.
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.
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.
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.
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.
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...
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 <...
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 <...
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...
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 ...
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.
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.
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.
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.
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...
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.
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...
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...
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.
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.
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.
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.
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...
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.
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...
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.
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.
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.
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 ..
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.
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...
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”...
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.
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...
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...
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...
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...
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.
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$...
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.
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”...
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.
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.
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.
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.
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 &...
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.
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.
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...
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.
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.
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.
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.
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.
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.
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.
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...
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.
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.
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.
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...
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.
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$.
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.
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.
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...
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.
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.
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...
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...
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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...
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.
Need help?
Do you have a question about the Zetasizer Series and is the answer not in the manual?
Questions and answers