Ocean-optics Jaz Scripting Language and Scripting Engine Manual de usuario

Scripting Language and Scripting Engine Programming Guide Document Number 013-RD000-000-12- 201010 Offices:OcOcean Optics, Inc.830 Douglas

1: Introduction2 013-RD000-000-12- 201010Operating System Support Microsoft Windows – Windows 7, 2000, XP; 32-b

013-RD000-000-12- 201010 3Chapter 2Jaz Scripting Engine ArchitectureOverviewThe Jaz Scripting engine comprises the linguistic a

2: Jaz Scripting Engine Architecture4 013-RD000-000-12- 201010All variables are global in scope. That means that

2: Jaz Scripting Engine Architecture013-RD000-000-12- 201010 5TEXT LiteralsA literal of type text may need to have carriage re

2: Jaz Scripting Engine Architecture6 013-RD000-000-12- 201010 Symbol Name Type> Greater than Boolean< Le

2: Jaz Scripting Engine Architecture013-RD000-000-12- 201010 7The DO ... DONE construct is a special iteration construct. It b

2: Jaz Scripting Engine Architecture8 013-RD000-000-12- 201010Variable Type Constant Typical Use/ValueELECTRIC_DA

013-RD000-000-12- 201010 9Chapter 3InstallationOverviewThe JSL can be run under Jaz, Linux or Windows and installed from either

3: Installation10 013-RD000-000-12- 201010Downloading from the Ocean Optics WebsiteInstalling on a Windows Platfo

013-RD000-000-12- 201010 11Chapter 4Windows Scriptor LauncherIntroductionScriptor Launcher provides a graphical interface for O

AdditionalOffices:Ocean Optics Asia666 Gubei Road, Kirin Tower, Suite 601B, Changning District, Shanghai, 200336 PRCPhone 86.21.6295.6600Fax 86.21.629

4: Windows Scriptor Launcher12 013-RD000-000-12- 201010Running the ApplicationScriptor Launcher Main WindowDouble

013-RD000-000-12- 201010 13Script OptionsOption MeaningVerbose Corresponds to the -v option and provides the most detailed out

4: Windows Scriptor Launcher14 013-RD000-000-12- 201010

013-RD000-000-12- 201010 15Chapter 5Using the Jaz Scripting EngineOverviewThe scripting engine is a program named Scriptor. Scr

5: Using the Jaz Scripting Engine16 013-RD000-000-12- 201010Flag Arguments Meaning-p IP Port number of Jaz unitDe

013-RD000-000-12- 201010 17Chapter 6Functions ReferenceACOSSyntax: ACos(A,B)ArgumentsName Type Special ConsiderationsA INT_16 o

6: Functions Reference18 013-RD000-000-12- 201010ArgumentsName Type Special ConsiderationsA SpectralB SpectralC S

6: Functions Reference013-RD000-000-12- 201010 19Call -- UserFunctionInvocationSyntax: Call MyProcedureArgumentsName Type Spec

6: Functions Reference20 013-RD000-000-12- 201010Name Type Special ConsiderationsIN Operator for membershipOUTSID

6: Functions Reference013-RD000-000-12- 201010 21CompSyntax: Comp(A,B,C)ArgumentsName Type Special ConsiderationsA SpectralB S

013-RD000-000-12- 201010 iiiTable of ContentsAbout This Manual...

6: Functions Reference22 013-RD000-000-12- 201010ArgumentsName Type Special ConsiderationsA INT_16 or REAL variab

6: Functions Reference013-RD000-000-12- 201010 23Do … DoneSyntax: Do V SV,EV,SS DoneExample:Do I 1,10,1Sum := Sum + IDoneThis

6: Functions Reference24 013-RD000-000-12- 201010ArgumentsName Type Special ConsiderationsA INT_16 or REAL variab

6: Functions Reference013-RD000-000-12- 201010 25Intent: Fetch current value of light source bulb intensity setting.GetLampShu

6: Functions Reference26 013-RD000-000-12- 201010ArgumentsName Type Special ConsiderationsLabel A labeled stateme

6: Functions Reference013-RD000-000-12- 201010 27ArgumentsName Type Special ConsiderationsLabel Name Tagged instruction in the

6: Functions Reference28 013-RD000-000-12- 201010Intent:Compute the element-wise logarithm base 10 of A and store

6: Functions Reference013-RD000-000-12- 201010 29ArgumentsName Type Special ConsiderationsA SpectralB SpectralC Spectral Ci =

6: Functions Reference30 013-RD000-000-12- 201010ArgumentsName Type Special ConsiderationsButtonSelection INT_16

6: Functions Reference013-RD000-000-12- 201010 31ArgumentsName Type Special ConsiderationsLabel A labeled statement in the scr

Table of Contentsiv 013-RD000-000-12- 201010Chapter 6: Functions Reference...

6: Functions Reference32 013-RD000-000-12- 201010Name Type Special ConsiderationsSequence INT_16 variable or lite

6: Functions Reference013-RD000-000-12- 201010 33ArgumentsName Type Special ConsiderationsA INT_16 or REAL variable or literal

6: Functions Reference34 013-RD000-000-12- 201010ReadRealVectorSyntax: ReadRealVector(F,V,Length)ArgumentsName Ty

6: Functions Reference013-RD000-000-12- 201010 35Intent:To read in a 2-dimensional array of real numbers from a file. The arra

6: Functions Reference36 013-RD000-000-12- 201010SetDisplayPrecisionSyntax: SetDisplayPrecision(W,P)ArgumentsName

6: Functions Reference013-RD000-000-12- 201010 37ArgumentsName Type Special ConsiderationsL Integer variable or literal Lamp u

6: Functions Reference38 013-RD000-000-12- 201010ShowMenuSyntax: ShowMenu(s1{,s2,s3,s4})Where: s = a string or a

6: Functions Reference013-RD000-000-12- 201010 39ArgumentsName Type Special ConsiderationsA SpectralB SpectralC Spectral A -B

6: Functions Reference40 013-RD000-000-12- 201010ArgumentsName Type Special ConsiderationsA SpectralV Integer val

6: Functions Reference013-RD000-000-12- 201010 41WriteSpectrumSyntax: WriteSpectrum(F,A)ArgumentsName Type Special Considerati

Table of Contents013-RD000-000-12- 201010 vScale ...

6: Functions Reference42 013-RD000-000-12- 201010

013-RD000-000-12- 201010 43Appendix AExample ScriptsBare Script TemplateSCRIPT Testing1VERSION 1.0.0VARIABLES /////////////////

A: Example Scripts44 013-RD000-000-12- 201010A script must have a name and a 3-digit version number. As the produ

A: Example Scripts013-RD000-000-12- 201010 45//// Set the integration time //Display("Setting$Integration$time to$"

A: Example Scripts46 013-RD000-000-12- 201010////////////////////////////////////////////////////////////////////

A: Example Scripts013-RD000-000-12- 201010 47FiveSpectrumDark SPECTRALSixSpectrumDark SPECTRALSevenSpectrumDark SPECTRALEightS

A: Example Scripts48 013-RD000-000-12- 201010SixBaseRatio REALSixPeakAbsorbance REALSixBaseAbsorbance REALSixAbso

A: Example Scripts013-RD000-000-12- 201010 49Slope1 REALSlope2 REALSlope3 REALSlope4 REALSlope5 REALSlope6 REALSlopeSum REALim

A: Example Scripts50 013-RD000-000-12- 201010LightPeak INT_16MaxPeak INT_16QuickPeak INT_16FivePeak INT_16SixPeak

A: Example Scripts013-RD000-000-12- 201010 51Light1 := 4000LABEL LightLoopSetLampIntensity(0,ALLBULBS,Light1)GetSpectrum(0,Lig

Table of Contentsvi 013-RD000-000-12- 201010

A: Example Scripts52 013-RD000-000-12- 201010Call RefreshGOTO TOPLABEL QUITDisplayMsg("Ending$Session")

A: Example Scripts013-RD000-000-12- 201010 53LABEL TOPShowMenu("Standardize","View pH","Refresh pK&qu

A: Example Scripts54 013-RD000-000-12- 201010Pause(1)GetSpectrum(0,DarkSpectrum)DisplayMsg("Taking Dark$Refe

A: Example Scripts013-RD000-000-12- 201010 55OpenFile(LowFile, ForWrite)WriteSpectrum(LowFile,LowpHSpectrumDark)CloseFile(LowF

A: Example Scripts56 013-RD000-000-12- 201010GOTO EXITLABEL Manual//Not yet a feature in ScriptorDisplayMsg("

A: Example Scripts013-RD000-000-12- 201010 57QuickAbsorbance1 := QuickPeakAbsorbance1 - QuickBaseAbsorbanceif(QuickAbsorbance1

A: Example Scripts58 013-RD000-000-12- 201010DisplayMsg("Make sure Dark,$Low, and Max Refs$have been taken&q

A: Example Scripts013-RD000-000-12- 201010 59GOTO FullMenuLABEL EightDisplayMsg("pH = 8 Buffer$Should Be$Present")Pa

A: Example Scripts60 013-RD000-000-12- 201010Display("pK = ",pK,"")Pause(2)Display("Slop

A: Example Scripts013-RD000-000-12- 201010 61[PROCESS CalculatepH]//Gets sample spectrum, calculates and displays pH, returns

013-RD000-000-12- 201010 viiAbout This ManualDocument Purpose and Intended AudienceThis document provides you with instructions to install and use the

A: Example Scripts62 013-RD000-000-12- 201010

013-RD000-000-12- 201010 63IndexAACOS, 17Adapt, 17Add, 17architecture, 3arithmetic, 5ASIN, 18AssignLampType, 18Bbuilt-in variab

A: Example Scripts64 013-RD000-000-12- 201010POW, 32Prompt, 33Ratio, 33ReadRealVector, 34ReadTable, 34Savereading

Index013-RD000-000-12- 201010 65template, 43TEXT literals, 5user-defined procedures, 6variable declaration, 3scripting enginea

A: Example Scripts66 013-RD000-000-12- 201010

About This Manualviii 013-RD000-000-12- 201010

013-RD000-000-12- 201010 1Chapter 1IntroductionOverviewJaz is a community of smart sensing instruments that consists of a high-