Programmer's Guide HP 71450B/1B/2B Optical Spectrum Analyzers
HP Part No. 70950-90050 Edition 1 Printed in USA June 1995 1400 Fountaingrove Parkway, Santa Rosa, CA 95403-1799, USA Notice. The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material, including but not limited to, the implied warranties of merchantability and tness for a particular purpose.
Remote operation with HP 71450B/1B/2B This introduction provides you with a quick overview of some basic concepts you will need to successfully program the HP 71450B/1B/2B optical spectrum analyzer (OSA).
Computer Model in Examples The programming examples provided in this book used an HP 9000 Series 300 technical computer and the HP-BASIC language. However, you can use other computers and languages with OSA commands and query data over HP-IB. As an example, you could use an HP Vectra PC compatible computer. Simply install an HP 82335A HP-IB Interface and Command Library card in the PC and use a compatible language such as Microsoft QuickC.
Safety Notes CAUTION WARNING The following safety notes are used throughout this manual. Familiarize yourself with each of the notes and its meaning before operating this instrument. The caution note denotes a hazard. It calls attention to a procedure which, if not correctly performed or adhered to, could result in damage to or destruction of the instrument. Do not proceed beyond a caution note until the indicated conditions are fully understood and met. The warning note denotes a hazard.
General Safety Considerations WARNING WARNING CAUTION Before this instrument is switched on, make sure it has been properly grounded through the protective conductor of the ac power cable to a socket outlet provided with protective earth contact. Any interruption of the protective (grounding) conductor, inside or outside the instrument, or disconnection of the protective earth terminal can result in personal injury. There are many points in the instrument which can, if contacted, cause personal injury.
Certi cation Hewlett-Packard Company certi es that this product met its published speci cations at the time of shipment from the factory. Hewlett-Packard further certi es that its calibration measurements are traceable to the United States National Institute of Standards and Technology, to the extent allowed by the Institute's calibration facility, and to the calibration facilities of other International Standards Organization members.
Warranty This Hewlett-Packard instrument product is warranted against defects in material and workmanship for a period of one year from date of shipment. During the warranty period, Hewlett-Packard Company will, at its option, either repair or replace products which prove to be defective. For warranty service or repair, this product must be returned to a service facility designated by Hewlett-Packard.
Assistance Product maintenance agreements and other customer assistance agreements are available for Hewlett-Packard products. For any assistance, contact your nearest Hewlett-Packard Sales and Service O ce.
Typesetting Conventions 4Front-Panel Key5 NNNNNNNNNNNNNNNNNNNNNNN Softkey Screen Text x This represents a key physically located on the instrument. This indicates a \softkey," a key whose label is determined by the instrument's rmware. This indicates text displayed on the instrument's screen.
Contents 1. Learning the Basics 2. Using Variables and Traces Preparing the OSA . . . . . . . . . . . . . . To prepare the OSA . . . . . . . . . . . . . To change the HP-IB address using switches . . To change the HP-IB address from the front panel Beginning Your Program . . . . . . . . . . . . To initialize the bus and the OSA . . . . . . . Sending Commands . . . . . . . . . . . . . . To send commands to the OSA . . . . . . . . Returning Data to the Computer . . . . . . . . To query a value . . . . .
Trace Math Rule 4 3. 4. 5. . . . . . . . . . . . . . . . . Controlling Memory . . . . . . . . . . . . . . . . . . . . . 3-4 3-6 3-6 3-6 3-6 3-7 3-9 . . . . . . . . . . . . . . . . . . . . . 3-9 3-9 3-10 3-10 3-12 3-13 3-13 . . . . . . . . . . . . . . . . . . . . Service . . . . . . . . . . . . . . . . . 4-4 4-5 4-5 4-6 4-7 . . . 4-11 4-12 4-12 . . . . . . . . . . . . . . . . . . . . 5-4 5-4 5-5 5-9 5-10 5-11 5-15 5-15 5-16 5-19 Saving and Recalling Items . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19 5-20 5-20 5-20 5-21 5-24 5-27 5-27 5-27 Creating a Downloadable Program . . . . . To store a function . . . . . . . . . . To con rm a function is stored . . . . . Creating an Active User-De ned Function . Branching, Looping, and Interrupting . . . To use a conditional branch . . . . . . . To use a looping construct . . . . . . .
ADCTRGSYN . . . . . . . . . . . . . . . . . . . ADD . . . . . . . . . . . . . . . . . . . . . . . . . ALIGN . . . ALIGNPRST . AMB . . . . AMBMC . . . AMBMCPL . AMBPL . . . AMC . . . . AMCPL . . . AMETER . . AMPCOR . . AMPMKR . . AMPU . . . . ANNOFF . . ANNOT . . . APB . . . . . APBDCTL . . AUNITS . . . AUTOALIGN . AUTOMDB . AUTOMEAS . AUTOMMKR AUTOMOPT . AUTOMSP . . AUTORNG . AVG . . . . . AXB . . . . . AXC . . . . . BIT . . . . . BLANK . . . BML . . . . BP . . . . . BTC . . . . . BXC . . . . . CAL . . . .
CENTERWL . . . . . . . . . . . . . . . . . . . . CHEIGHT . . . . . . . . . . . . . . . . . . . . . . . CHOP . . . CLRDSP . . CLRW . . . CLS . . . . COMPRESS CONCAT . CONFIG . . CONTS . . CORSEL . . CORTOLIM CWIDTH . DEBUG . . DELETE . . DFB . . . DISPOSE . DISPU . . . DIV . . . . DL . . . . DONE . . . DSPLY . . DSPMODE . DSPTEXT . DWINDOW ENTER . . ERASE . . ERR . . . . EXP . . . . FETCH . . FFT . . . . FFTKNL . . FORMAT . FP . . . . FP MKBW FP TH . . FS . . . . . FUNCDEF . GATESWP . GRAPH . . GRAT . . .
GRATORDER . . . . . . . . . . . . . . . . . . . GRATSCRL . . . . . . . . . . . . . . . . . . . . . . . GRID . . . . HD . . . . . ID . . . . . . IF/THEN . . IGEN . . . . IGENDTYCY IGENLIMIT . IGENPW . . INSTMODE . INT . . . . . IP . . . . . . IT . . . . . . IWINDOW . . KEYCLR . . KEYDEF . . KEYPST . . . LED . . . . LG . . . . . LIGHT . . . LIMIAMP . . LIMIBEEP . . LIMIBOT . . LIMIDEL . . LIMIDONE . LIMIEDIT . . LIMIFAIL . . LIMIHALF . . LIMILINE . . LIMINEXT . . LIMIRCL . . LIMIREL . . LIMISAV . . .
LINES . . . . . . . . . . . . . . . . . . . . . . . LINET . . . . . . . . . . . . . . . . . . . . . . . . . LN . . . LOAD . . LOG . . . MDS . . MEAN . . MEASU . MEASURE MEM . . MIN . . . MINH . . MK . . . MKA . . MKACT . MKAL . . MKAR . . MKBW . MKBWA . MKCONT MKCWL . MKD . . MKDACT? MKDREFA MKDREFF MKMIN . MKN . . MKNOISE MKOFF . MKP . . MKPABS MKPAUSE MKPITX . MKPK . . MKPX . . MKREAD MKRL . . MKSP . . MKSS . . MKSTOP MKT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MKTRACE . . . . . . . . . . . . . . . . . . . . MKTUNE . MKTV . . . MKTYPE . MKWL . . MOD . . . MODADD . MODID . . MOV . . . MPY . . . MSG . . . MSI . . . . MXM . . . MXMH . . NORM . . . NSTATE . . ONEOS . . ONMENU . ONMKR . . ONUSER . ONWINDOW OP . . . . OPTSW . . OR . . . . OUTPUT . OVRW . . . PA . . . . PAUSE . . PD . . . . PDA . . . . PDL . . . PDLCALC . PDLDEV . PDL DEV? PDLEXIT . PDLINIT . PDLREV . PDL REV? . PDLSCALE PDLSRC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PDL SRC? . . . . . . . . . . . . . . . . . . . . . PDMEAS . . . . . . . . . . . . . . . . . . . . . . . . PDWL . . . . . PEAKS . . . . PEN . . . . . . PERASE . . . . PERSIST . . . PLOT . . . . . POSU . . . . . POWERON . . PR . . . . . . PREFX . . . . PROTECT . . . PSTATE . . . . PU . . . . . . PURGE . . . . PWRBW . . . . RB . . . . . . RBR . . . . . . RCLD . . . . . RCLS . . . . . RCLT . . . . . RCLU . . . . . READMENU . . RELHPIB . . . REPEAT/ UNTIL RETURN . . . REV . . . . . . RL . . . . . . RLPOS . . .
SNGLS . . . . . . . . . . . . . . . . . . . . . . SP . . . . . . . . . . . . . . . . . . . . . . . . . . SQR . . . . . . SRINPUT . . . SRQ . . . . . . SS . . . . . . . ST . . . . . . STARTUP . . . STARTWL . . . STATE . . . . STB . . . . . . STDEV . . . . STOPWL . . . STOR . . . . . STORREF . . . SUB . . . . . . SUM . . . . . . SUMSQR . . . SWEEP . . . . SWPMODE? . . TDF . . . . . . TEST . . . . . TEXT . . . . . TH . . . . . . THREED . . . THREEDH . . . THREEDV . . . TIME . . . . . TITLE . . . . . TM . . .
USERKEY . . . . . . . . . . . . . . . . . . . . . USERLOCK . . . . . . . . . . . . . . . . . . . . . . USERMSG . USERWARN USTATE . . VARDEF . . VARIANCE VAVG . . . VB . . . . VIEW . . . VTDL . . . VTH . . . . VTL . . . . VW . . . . WAIT . . . WARN? . . WARNCTRL WLLIMIT . WLMKRL . WLMKRR . WLOFFSET WLUNITS . XAMPSW . XCH . . . . XERR . . . XWARN . . ZERO . . . ZOOMRB . 8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents
1 Learning the Basics
Learning the Basics This chapter contains basic, remote program information, for the operation of an optical spectrum analyzer. In addition to learning how to send commands and receive data, you can learn about a debugging feature for locating programming errors.
Learning the Basics Contents Preparing the OSA : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 1-4 To prepare the OSA : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 1-7 To change the HP-IB address using switches : : : : : : : : : : : : : : : : : : : : : : : : : 1-8 To change the HP-IB address from the front panel : : : : : : : : : : : : : : : : : : : 1-9 Beginning Your Program : : : : : : : : :
Preparing the OSA When preparing the OSA for programming, you must connect the HP-IB cables, con rm the HP-IB address, and reset all instruments connected to the bus. Typically, you will use the default address setting provided in the introduction of this book. However, the OSA's HP-IB address can be changed using front-panel keys or manually by changing SWITCHESnMEMORY on the HP 70950B/1B/2B module. The switches are located on the module cover.
Learning the Basics Preparing the OSA OSA Address Switches In this gure, switches ROW 1, ROW 2, and ROW 3 correspond to row-address numbers which position the module vertically in the address map. The row switches for the optical spectrum module address must be set to 0 to allow HP-IB control. The COLUMN switches select the HP-IB address and correspond to the column-address numbers on the address map.
Learning the Basics Preparing the OSA address of 23 is selected by setting column switches 1, 2, 3, and 5 to 1, and setting column switch 4 to 0. (23 = 1 + 2 + 4 + 0 + 16.) Illegal Addresses HP-IB address 31 and HP-MSIB address 0, 31 are illegal and cannot be used.
Learning the Basics Preparing the OSA To prepare the OSA 1. Connect an HP-IB cable between the computer's HP-IB connector and the HP-IB connector on the HP 70000 modular measurement system's rear panel. HP 70950B/1B/2B OSA modules do not have an HP-IB connector. Use the connector that is located on the mainframe in which the module is installed.
Learning the Basics Preparing the OSA To change the HP-IB address using switches The HP-IB address is forced to the switch address setting when the OSA module SWITCHES/MEMORY selector is set to SWITCHES. NOTE The SWITCHES setting must be selected. The MEMORY setting is the factory default setting. 1. Turn o any line-power, and remove the HP 70950B/1B/2B module from the mainframe. 2. Locate the switches on the top of the module. 3. Set the SWITCHES/MEMORY selector to the SWITCHES position. 4.
Learning the Basics Preparing the OSA To change the HP-IB address from the front panel The HP-IB address can be changed at the front panel when the OSA module's SWITCHES/MEMORY switch is set to MEM. (This is the default factory setting.) 1. Press 4DISPLAY5, Address Map . NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN 2. With the front-panel knob, position the box around the OSA module, then press HP-IB ADDRSET . NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN 3.
Beginning Your Program Programs should begin with system-level and OSA commands that initialize the system. Three such commands are discussed here: CLEAR, IP, and CLRDSP. The CLEAR command is an HP BASIC command that resets a device on HP-IB to a known state. As an example, CLEAR 723 clears the device (the OSA in this case) at address 23 on interface 7. CLEAR erases the OSA's input bu er, interrupts most incomplete operations, and prepares the OSA to receive instructions.
Sending Commands The commands listed in Chapter 7 are sent to the OSA as ASCII strings. The method used depends on the programming language and environment. The examples in this book use the HP-BASIC language with an HP 9000 Series 300 technical computer. Using HP-BASIC, the following example shows an output statement to send a command to the OSA: 10 OUTPUT 723;"CENTERWL 1300NM;" Set the center wavelength. Be sure to place a semicolon between commands and at the end of any command string.
Learning the Basics Sending Commands Units Codes Units Wavelength Meters Millimeters Time Current Ratio Measurements Power Code M MM Micrometer UM Nanometer NM Angstrom ANG Picometer PM Second S Millisecond MS Microsecond US Ampere A Milliampere MA Microampere UA Decibel DB Watt W Milliwatt MW Microwatt UW Nanowatt NW Picowatt PW Decibels relative to units.
Learning the Basics Sending Commands To send commands to the OSA 1. Locate the appropriate commands in Chapter 7. 2. Construct a ASCII string of the commands, placing a semicolon between each command in the string. 3. Use your programming language's output statement to send the command string to the address of the OSA.
Returning Data to the Computer Data is requested from the OSA using a query. Queries usually take the form of a command with the question-mark character. For example, CENTERWL? requests the OSA's center wavelength setting. The syntax diagrams in Chapter 7 document available command queries. Most command queries and variable queries are normally sent in the form of ASCII strings. However, binary query results are returned for some commands.
Learning the Basics Returning Data to the Computer 10 20 30 40 50 60 70 80 90 100 110 CLEAR 723 OUTPUT 723;"IP;SNGLS;TS;" OUTPUT 723;"CENTERWL 1300NM;SPANWL 10NM;RL -5DBM;" OUTPUT 723;"TS;" OUTPUT 723;"MKPK HI;" OUTPUT 723;"MKWL?;" ENTER 723;W OUTPUT 723;"MKA?;" ENTER 723;A W=W/1.E09 PRINT W,A Initialize analyzer. Set measurement range. Sweep trace A. Mark highest signal level. Return wavelength at marker. Assign wavelength to computer variable. Return amplitude at marker.
Learning the Basics Returning Data to the Computer To query a value 1. Allocate a variable to hold the data returned by the query. 2. Use an output statement to send the query to the OSA. 3. Enter the returned data to the variable. For example, to return the sensitivity setting, send SENS?. OUTPUT 723;"SENS?";" ENTER 723;S 1-16 Send the sensitivity query string. Assign value to computer variable.
Using Commands as Arguments Some OSA commands accept other commands as arguments. The following example shows the MKA command used as an argument for the MOV command. 10 OUTPUT 723;"MOV DL,MKA;" The value of the command MKA is returned as input to the calling command, MOV. Commands that accept command arguments have syntax diagrams that show prede ned function as an argument. Refer to Chapter 7. When using a command as an argument, the value returned is similar to the query value.
Using the MOV Command It is recommended that the MOV command be used to execute all programming commands that load variables. Using the MOV command is faster and avoids displaying text on the analyzer screen.
Controlling Program Timing Most remote controlled measurements require control of the sweep. The TS (take sweep) command initiates a sweep when the trigger conditions are met. When TS is executed as part of a command sequence, the analyzer starts and completes one full sweep before the next analyzer command is executed. Use the SNGLS (single sweep) command to maintain absolute control over the sweep and to reduce execution time.
Learning the Basics Controlling Program Timing trace information is needed, a TS command must be executed after these commands are executed. In all cases, executing TS invokes at least one entire sweep. However, TS invokes more than one sweep when certain commands are active, such as video averaging (VAVG) or marker tracking (MKTRACK). Program timing can also be controlled with the RQS, DONE, and WAIT commands.
Entering Data from the Front Panel Data may be entered from the front panel when the OSA is under remote control by using the EP (enable) argument with a command. EP halts execution of analyzer commands so that values may be entered with the front-panel numeric keypad, step keys, knob, and unit-code keys. Data may be entered from the front-panel until the ACCEPT VALUE key is pressed. The syntax diagrams in Chapter 7 provide the commands that can be followed by EP.
Controlling Advanced Measurement Programs The FP , DFB , and LED measurement keys available under the 4USER5 menu activate advanced measurement routines. You can also make these measurements over HP-IB. Refer to Chapter 7, \Language Reference" for more information about the following advanced measurement program commands: \FP " for characterizing a Fabry-Perot laser source. \DFB " for characterizing a distributed feedback laser source. \LED " for characterizing a light-emitting diode laser source.
Learning the Basics 3. To measure an LED laser source and obtain measurement data, enter the following command lines: 30 OUTPUT 723;"AUTOMEAS;" 40 OUTPUT 723;"LED_;" 50 OUTPUT 723;"LED_ ?;" Locate and display the output of the laser source. Measure the output of the LED source. Return the measurement data. 4.
Learning the Basics
2 Using Variables and Traces
Using Variables and Traces This chapter can help you learn to create variables and process both prede ned and user-de ned trace arrays. Prede ned traces, for example trace A, exist permanently in reserved memory. User-de ned variables and trace arrays are created by the user, given preset values, and stored in internal memory. User-de ned variables and trace arrays remain in internal memory, even when power is turned o .
Using Variables and Traces Contents De ning Variables : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 2-4 To create a user-de ned variable : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 2-5 To erase a user-de ned variable : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 2-5 De ning Traces : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :
De ning Variables The OSA retains in reserved memory a set of prede ned variables. Each prede ned variable stores a current OSA setting or state. Note the two characteristics of these variables: 1. Values depend on current instrument settings. 2. Names are identical with associated programming commands. Programming commands which have the same name as a prede ned variable load that variable. For example, the command CENTERWL sets the OSA's center wavelength.
Using Variables and Traces De ning Variables To create a user-de ned variable Use the VARDEF command. 10 OUTPUT 723;"VARDEF MY_VAR,0;" Create variable called MY VAR and assign it a value of 0. To erase a user-de ned variable Use the DISPOSE command.
De ning Traces The OSA stores data for traces A, B, and C in reserve-memory trace arrays. These arrays comprise a series of data points (elements) that contain amplitude information. Position units describe the position of an element (point) along the horizontal axis of a trace. The point at the left end of the trace has a position-unit value of 1. The point at the right end of an 800-point trace has a position-unit value of 800.
Using Variables and Traces De ning Traces To create a user-de ned trace Use the TRDEF command. 10 OUTPUT 723;"TRDEF TRACE_Z,1000;" To erase a user-de ned trace Use the DISPOSE command.
Using Amplitude Data Measurement results are expressed in either parameter units or measurement units. A parameter unit is a standard scienti c unit such as Watts, decibels, seconds, hertz, amperes, and ohms. Measurement units are an internal representation of the data. Measurement units apply only to traces and trace elements. In its preset state, the analyzer returns all measurement results in parameter units. The amplitude parameter units used are shown in the following table.
Using Variables and Traces Using Amplitude Data To select the amplitude units Use the AUNITS command. To convert measurement and parameter units Use the AMPU command to convert measurement units to parameter units. Use the MEASU command to convert parameter units to measurement units. To return wavelength and position values Use the POSU command to determines the trace point that corresponds to a wavelength value. Use the WLU command determines the wavelength value of a given trace point.
Formatting Trace-Data Output The trace-data format (TDF) command controls the format of trace-amplitude data output from the OSA. All the available format modes return amplitude information in measurement units except for TDF P, which returns parameter units. The output formats are summarized in the following table. (Parenthetical numbers in the table are decimal values representing binary, 8-bit numbers.
Using Variables and Traces Formatting Trace-Data Output TDF M formats data as ASCII, integer values in measurement units. (Thus, the AUNITS command has no a ect on returned data.) A line feed (ASCII code 10) follows data output. The end-or-identify state (EOI) is sent with line feed. The TDF M format is faster than the TDF P format, but requires conversion to parameter units. TDF B formats data in measurement units as binary numbers. Numbers are transmitted usually as words. (A word is two 8-bit bytes.
Using Variables and Traces Formatting Trace-Data Output Transmission Sequence for Trace-Data Formats TDF P TDF M TDF B TDF A TDF I Byte 1 1 1 (3) # # Byte 2 0 0 (232-EOI) A I Byte 3 . 0 (0) (3) Byte 4 0 0 (2) (232-EOI) Byte 5 0 10 (EOI) (3) Byte 6 10(EOI) (232) (10-EOI) The format of the computer must be compatible with the output format of the analyzer. The following table and programming examples illustrate this concept.
Using Variables and Traces Formatting Trace-Data Output Computer Formats Analyzer Format Computer-Format Requirements Example in HP BASIC TDF M Free eld 10 ENTER 723;Amplitude TDF P Free eld 10 ENTER 723;Amplitude TDF B Binary. Read twice for each value if data size 10 ASSIGN @Sa TO 723;FORMAT OFF is words. (See MDS.) 20 ENTER @Sa USING \#,W";Z(*) TDF A Initially read four values (for #, A, and 10 ASSIGN @Sa TO 723;FORMAT OFF length) in any format. Use integer format for data that follows.
Using Variables and Traces Formatting Trace-Data Output 20 30 40 50 60 ASSIGN ASSIGN OUTPUT OUTPUT OUTPUT @Sa TO 723 @Sa_fast TO 723;FORMAT OFF @Sa;"MDS W;" @Sa;"TDF B;" @Sa;"TRA?;" 70 ENTER @Sa_fast USING "#,W";Z(*) Assign fast I/O path to 723. De ne data size as one word. Activate binary data format. Return amplitude of all trace elements in measurement units. Load binary values into array Z. \#" speci es that line execution is terminated when last ENTER item is terminated.
Using Math and Move Commands This section covers math and move commands which modify data and store the results in memory. In addition, four rules are provided for using math with trace arrays and elements. Each math and move command requires both source and destination arguments. The value of the source is used to obtain the data stored in the destination. Only variables or traces can be a destination. Sources can be variables, traces, real numbers, or any command listed in the following table.
Using Variables and Traces Using Math and Move Commands 10 OUTPUT 723;"MOV WAVELENGTH,CENTERWL;" Copy center wavelength value into WAVELENGTH variable. The next example uses the multiple command, MPY, to increase the center wavelength by 10%. 10 OUTPUT 723;"MPY CENTERWL,CENTERWL,1.1;" Trace Math Rule 1 Avoid truncating data from using a destination length that is shorter than the source length.
Using Variables and Traces Using Math and Move Commands Trace Math Rule 2 Trace elements greater than +32,767 and less than 032,768 are truncated. Math operations are restricted to the legal range of measurement units when trace arrays or elements form the destination or source. 10 OUTPUT 723;"MPY TRA[100],1000,1000;" Multiplies 1000 times 1000, then stores truncated value (32,767) in trace element.
Using Variables and Traces Using Math and Move Commands The following table lists math and move commands that may require the use of the MEASU command. Math and Move Commands Requiring Conversion with MEASU Command 2-18 De nition ABS Compute absolute value. ADD Add sources, point by point. AVG Average source with destination, point by point. BIT Store or return value of bit. CONCAT Concatenate traces. DIV Divide sources, point by point, then discard remainder.
Using Variables and Traces Trace Math Rule 4 For greatest , use single point destinations, such as a trace element or a variable. If the destination consists of multiple points, the math functions round the sources rst, then perform the requested operation. If the destination is a single point, the math functions compute the results in oating point, and then rounds the results if necessary. The following example shows how the product of 2.45 and 3.45 is 6 or 8 depending on the destination.
Using Variables and Traces
3 Controlling Memory
Controlling Memory Memory is an area where information can be stored for future recall. Memory that is available for the user is called user memory.
Controlling Memory Contents Saving and Recalling Items : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 3-4 To select user memory : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 3-6 To catalog memory : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 3-6 To save a le : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :
Saving and Recalling Items You can save the following items in internal memory. The commands for saving are shown in parentheses.
Controlling Memory Saving and Recalling Items until the MSI command or the catalog & MSI softkey selects another storage device. The catalog of user memory gives a description of articles stored in the currently selected user memory. To view the catalog, execute DSPMODE CAT. To return the catalog to the computer, use the DSPTEXT command. Stored articles are listed by name, followed by the article type, and the size of the article in bytes.
Controlling Memory Saving and Recalling Items To select user memory Send the MSI command. To catalog memory Send the DSPMODE CAT command to display catalog on OSA. or Send the DSPTEXT command to return the catalog to the computer. To save a le Use the SAVE and STOR commands when saving to external memory. or Use the ACTDEF, AMPCOR, FUNCDEF, LIMISAV, LOAD, NSTATE, ONEOS, SAVES, SAVET, SAVEU, STOR, TRDEF, and VARDEF commands when saving to internal memory.
Erasing Memory CAUTION Use the DISPOSE command to erase items from internal memory. DISPOSE ALL erases all contents of internal memory. Use the PURGE command to erase items from either internal or external memory, depending on the storage device selected. The ERASE command erases all memory in the OSA for security purposes, including internal memory, instrument settings, user-entered serial-number information, trace data, user-entered correction factors, and o sets.
Controlling Memory Erasing Memory Commands that Erase User Memory Memory Components Storing Commands Shown in Parentheses Commands that Erase or Reset Memory PURGE DISPOSE* NSTATE FORMAT PERASE* ERASE* user-de ned variable (VARDEF, LOAD, RCLD) X X user-de ned trace (TRDEF, LOAD, RCLD) X X user-de ned function (FUNCDEF, LOAD, RCLD) X X active user-de ned function (ACTDEF, LOAD, RCLD) X X on-end-of-sweep-algorithm (ONEOS, LOAD, RCLD) X X trace-amplitude correction factors (AMPCOR) X X
Controlling Memory Erasing Memory To erase les Use the DISPOSE, ERASE, FORMAT, PERASE, or PURGE command. To erase all memory except correction factors and serial-number Execute the PERASE command. To erase all memory for security CAUTION Use the ERASE command for security purposes only. ERASE destroys all contents of internal memory. 1. Execute the ERASE command. 2. Execute system-level command, CLEAR 723 (in HP BASIC), to reset the OSA's input bu er. 3. Recycle the OSA's power. 4.
Protecting Memory The PROTECT command protects internal memory against erasure by the PERASE, FORMAT and DISPOSE commands. The PSTATE command protects state-register les on both internal or external memory. On memory cards, the write-protect switch, when set to SAFE, protects the card's contents from erasure. For other HP-MSIB or HP-IB devices, refer to protection instructions for your particular mass storage device.
Controlling Memory Protecting Memory Commands that Erase or Protect User Memory Memory Components Storing Commands Shown in Parentheses Commands that Protect Memory PROTECT user-de ned variable (VARDEF, LOAD, RCLD) X user-de ned trace (TRDEF, LOAD, RCLD) X user-de ned function (FUNCDEF, LOAD, RCLD) X active user-de ned function (ACTDEF, LOAD, RCLD) X on-end-of-sweep-algorithm (ONEOS, LOAD, RCLD) X trace-amplitude correction factors (AMPCOR) X state register le (instrument settings and title
Freeing Memory When internal memory is full, an over ow message appears on the screen. You can increase available internal memory by erasing user-de ned traces, variables, and functions. Use the PURGE and DISPOSE commands to erase these items. Reduce trace size using the TRDEF command. An 800 element trace occupies 1646 bytes of memory, that is, 2 bytes for each element and 46 bytes for trace overhead.
Controlling Memory To free the greatest amount of internal memory 10 OUTPUT 723;"MSI INT;" 20 OUTPUT 723;"PROTECT ALL,OFF;" 30 OUTPUT 723;"DISPOSE ALL;" Select internal memory. Disable protection. Dispose all unprotected variables, traces, functions, keys, and on-end-of-sweep algorithms. To reduce the size of user-de ned functions Suppress any carriage-return/line-feeds located at the end of source-code lines.
Controlling Memory
4 Monitoring System Operation
Monitoring System Operation This chapter describes how service requests are used to monitor system operation. Service requests can be set to occur automatically. You can also monitor system operation without using service requests, as explained in this chapter.
Monitoring System Operation Contents Monitoring System Operation : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 4-4 Interrupt Process : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 4-5 Analyzer Status-Byte Register : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 4-5 Service-Request Mask : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :
Monitoring System Operation The programming techniques discussed so far describe communication between the analyzer and the computer, where the sequence of all data transfer is controlled by a computer program. This section tells how the analyzer can interrupt computer operation when the analyzer has attained a particular state. The interrupting process is called a service request. Service requests have many applications.
Monitoring System Operation Monitoring System Operation Interrupt Process The interrupt process begins when the analyzer \requests" attention by setting the HP-IB service-request (SRQ) line true. The computer responds by branching to a special subroutine that examines the status of each instrument on HP-IB. Computer operation then branches to another subroutine that is determined by the status of the instrument that requested service (the analyzer in this case).
Monitoring System Operation Monitoring System Operation In this case, the bit or bits that satisfy the service-request condition remain in the true state until the status byte is interrogated by the system-level, serial-poll command SPOLL, or until the system-level CLEAR command is executed. These commands clear the status byte so that all the bits in the byte once again re ect the current state of the analyzer until another service request occurs. In this way, the process begins again.
Monitoring System Operation Monitoring System Operation Service-Request Examples The following program uses service requests to monitor measurement errors in the analyzer. If an error occurs, computer operation is interrupted and a description of the error is printed. Example Enable ERROR-PRESENT service request and return error description.
Monitoring System Operation Monitoring System Operation The next program uses service requests to allow the computer to process data or control other instruments while the analyzer is taking a long sweep. When the sweep is completed, the analyzer generates a service request which interrupts the computer, instructing it to accept the measurement data from the analyzer. Example Enable END-OF-SWEEP interrupt, then return trace data when the sweep has ended.
Monitoring System Operation Monitoring System Operation The following program handles two types of service requests. One of them requests service when the analyzer has completed a sweep. The other requests service when an error occurs in the analyzer. When either request is generated, the computer examines the status-byte register using the SPOLL command to determine what caused the service request (end of sweep). Example Enable multiple service requests.
Monitoring System Operation Monitoring System Operation 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 SUB Interrupt S=SPOLL (723) IF BIT(S,2)THEN CALL Trace_out IF BIT(S,5)THEN CALL Error SUBEND ! ! SUB Trace_out OPTION BASE 1 COM\INSTR\@Sa COM trace_a(800) OUTPUT @Sa;"TRA?;" ENTER @Sa;Trace_a(*) SUBEND ! SUB Error DIM Mod_num$[6],Err_text$[30] ASSIGN @Sa TO 723 OUTPUT @Sa;"XERR?;" ENTER @Sa USING "S(K)";Error_num,Mod_num$,Row_num,Col_num,Err_text$ 370 PRINT Error_num;Mo
Monitoring System Operation Monitoring System Operation Monitoring System Operation Without Using Service Requests The easiest method to synchronize the execution of commands with other events is with the DONE command. This has the disadvantage that the computer is not available for other processing while waiting for the analyzer to complete its commands. The STB command may be used to monitor the value of the status byte at any time.
Debugging Programs The OSA's debug feature help to locate faulty program code. When the mode is on, each command sent to the OSA is tested and then displayed on the OSA's data line (located below the graticule). When a faulty command is encountered, subsequent commands are not executed. The faulty command is the last command shown to the right end of the displayed data line. Use the DEBUG command to turn debugging on and o . The debug mode has fast and slow settings. Use fast debugging for trapping errors.
5 Creating Graphics
Creating Graphics This chapter explains how to draw objects and print text on the display. A display, such as the HP 70004A, HP 70205A, or HP 70206A, is required for graphics capability. Graphics allow you to customize the display for your applications.
Creating Graphics Contents Clearing the Display : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 5-4 To clear the display : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 5-4 Creating Graphics : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 5-5 To create a drawing : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :
Clearing the Display Use the following commands to clear the display for graphics: IP blanks the display line, trace B, and trace C by executing DL OFF, BLANK TRB, and BLANK TRC automatically. CLRDSP erases all user-created graphics from the display and memory, except the contents of the title line. If you have stored graphics you wish to recall for future display, use the DELETE command to erase items individually. ANNOT OFF blanks all annotation except the display status box and the data line.
Creating Graphics Creating graphics is just like using a pen and paper. Graphics are drawn on the display using an imaginary pen on an electronic tablet. The PD (pen down) command draws on the display as the pen is moved. The PU (pen up) command lifts the pen. Use PU to reposition the pen without drawing. When the pen is lifted, previously drawn graphics are not erased (just as with a pen and paper). Use the LINET command to select the type of line drawn.
Creating Graphics Creating Graphics Draw a Rectangle with PA or PD Carriage-return/line-feed PA and PR commands are followed by a series of X-Y coordinate pairs. If several program lines are used to specify coordinate pairs, carriage return and line feeds must be suppressed at the end of each program line. Including these characters between X-Y coordinate pairs terminates the PA or PR commands before the entire list of coordinate pairs is processed.
Creating Graphics Creating Graphics The next example shows one way to move the rectangle to di erent positions on the display. 100 110 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"PU;PA 0,0;PD;" 723;"PR 300,0,0,200,-300,0,0,-200;" 723;"PU;PA 300,300;PD;" 723;"PR 300,0,0,200,-300,0,0,-200;" 723;"PU;PA 600,600;PD;" 723;"PR 300,0,0,200,-300,0,0,-200;" Position pen. Draw rectangle. Position pen. Draw rectangle. Position pen. Draw rectangle.
Creating Graphics Creating Graphics 130 OUTPUT 723;"PA 0,400,400,400,400,0,0,0;" Draw to coordinates X1, Y1, X2, Y2, X3, Y3, X4, Y4. Draw Box Without O set 120 OUTPUT 723;"OR 500,500;" 130 OUTPUT 723;"PU;PA 0,0;PD;" 140 OUTPUT 723;"PA 0,400,400,400,400,0,0,0;" Draw Box With O set 5-8 O set origin. Draw box.
Creating Graphics Creating Graphics To create a drawing Use the PU and PD commands to turn on or o the pen. Use PA to position the pen. Use PA and PR to draw the object. Use LINET to select the type of line (solid, dotted, or dashed.
Drawing Grids The GRID command draws a grid anywhere on the display. GRID speci es the size and number of squares forming the grid. Use the PA command to position the lower-left corner of the grid. LINET and PEN may be used to modify the grid lines. The following example places a ve-division-by-four-division grid in the upper right quadrant of the display. (GRID does not work after DWINDOW ON is executed.
Drawing Graphics Items The item command, IT, activates the special graphics mode where groups of graphics commands are assigned to an item number. These items can then be redrawn or modi ed without reexecuting the individual graphics commands. This is useful when a graphics item needs to be blanked and redrawn, changed, recolored, or repositioned at a later time. Executing IT assigns a series of graphics commands to an item number ranging from 1 to 50. The following program lines create items 1 and 2.
Creating Graphics Drawing Graphics Items The item command, IT, can be used to display line drawings, text, grids, or markers. These tasks are shown in the following table. Item Tasks Task Command Draw lines PA, PR Display traces GRAPH Draw grids GRID Display text TEXT, DSPLY Display graphics marker MK A single item can be assigned to do only one task. For example, a single item cannot draw a box and display text. In this case, two items are required: one for the box, another for the text.
Creating Graphics Drawing Graphics Items An item can be redrawn or modi ed whenever it is active. Only one item can be active at a time. The active item is determined by the last executed IT command. The following table shows commands that modify items: Commands that Modify Items Description Command Blank item. VW OFF (view item o ) Redraw item. VW ON (view item on) O set item position. OR (origin) Change item shape. TP (tablet pointer) Stop display of item and delete from memory.
Creating Graphics Drawing Graphics Items The TP (tablet pointer) command modi es item shapes. The TP command may be thought of as a tablet pointer that selects one of the X-Y coordinates of a graphics item for modi cation. For example, consider item 2, the triangle, which is de ned by four coordinates, numbered 0 through 3: Point 0 Point 1 Point 2 Point 3 (600,0) (700,200) (800,0) (600,0) Executing TP 1 selects (700,200) for modi cation. (TP begins counting with zero.
Creating Graphics Drawing Graphics Items To use a graphics item 1. Create graphics items using the IT command, specifying item numbers from 1 to 50. 2. Activate selected items with the IT command. 3. Modify selected items with the VW, OR, TP, or DELETE commands. To delete a graphics item DELETE blanks an active item and clears it from memory. 160 OUTPUT 723;"IT 1;" 170 OUTPUT 723;"DELETE; Activate item. Delete item. CLRDSP blanks and deletes all items, regardless of their state.
Displaying Text Use TITLE and TEXT to Messages may be written with the TITLE and TEXT commands. The TITLE display messages. command is the easiest way to write text. TITLE automatically places the pen down and positions text in the title line, located at the top of the display. The following example writes a message. Delimiters ($) mark the beginning and end of the message and must be di erent from any characters in the message.
Creating Graphics Displaying Text a label is assigned a non-zero number with the IT command, the mode is on, and EC Y and EC Z have no e ect. The table also shows character sequences used to enhance text. The characters must be preceded by the ASCII code for escape (27) and \&". All characters and codes must be entered between the delimiters of the label function, which must be assigned a non-zero item number. (Refer to the IT programming command.
Creating Graphics Displaying Text label. Pen colors are not available on the HP 70205A or HP 70206A displays. Sending pen-color escape sequences to the HP 70205A or HP 70206A displays causes errors.
Creating Graphics Displaying Text To display text Use the TITLE command to write text in the title area. 20 OUTPUT 723;"TITLE $Your Message Here$;" Use the TEXT command to write text at any display location. 30 OUTPUT 723;"PU;PA 400,700;" 40 OUTPUT 723;"PD;" 50 OUTPUT 723;"TEXT$Your Message Here$;" Position pen. Place pen down. Display text. To erase text Execute CLRDSP to text written with the TEXT command. Execute TITLE$$ to blank text written with the TITLE command.
Displaying Variables Variables are displayed by using the display-variable command, DSPLY. DSPLY speci es the eld width (number of characters) and decimal places of the displayed variable. When specifying the eld width, be sure to account for the greatest number of characters that will be displayed, including the sign and decimal point. DSPLY places the variable at the current pen position. To display a variable Use DSPLY to display values of variables.
Changing the Scale Graphics are drawn in the OSA window on the display, usually 800 dots wide by 384 dots high. Most graphics are drawn between the lower-left position, P1 , and the upper right position, P2, when the OSA has been assigned the full screen as shown in the following gure. P1 is located at the left edge of the graticule, just above the data line. P2 is located at the right edge of the graticule at the top of the display.
Creating Graphics Changing the Scale Default Scale for P1 and P2 The scale for P1 and P2 may be changed from its preset value to any values between 032,768 and +32,767. Below, SCALE changes the X and Y coordinates to new terms in decibel and degree units to illustrate an antenna pattern adjustment. Set Scale in Terms of Degrees and Decibels The SCALE command de nes X-Y coordinates in integer values only. When rede ning the scale, use numbers large enough to give adequate resolution.
Creating Graphics Changing the Scale Commands A ected by the SCALE Command Command Description DSPLY Display variable GRAPH Graph trace GRID Display grid MK Display marker OR Set origin PA Plot absolute value PR Plot relative value TEXT Display text 5-23
Using Graphics Windows Two window commands are provided for drawing on a limited and controlled area of the display: IWINDOW and DWINDOW. Use IWINDOW (instrument window) to increases or decreases the area on the screen dedicated to displaying OSA measurement results. Use DWINDOW to create a graphics window for drawing. DWINDOW cannot be used when displaying variables, grids, or text with the DSPLY, GRID, or TEXT commands.
Creating Graphics Using Graphics Windows placed on a window created by the DWINDOW command. Since the sides of the box are still 1000 units long, it outlines the limits of the window. 20 30 40 50 60 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"PU;PA 0,0;PD;" 723;"PA 0,1000,1000,1000,1000,0,0,0;" 723;"DWINDOW 400,400,0,1000,0,1000;" 723;"PU;PA 0,0;PD;" 723;"PA 0,1000,1000,1000,1000,0,0,0;" Draw box. De ne window size and scale. Redraw box. Use OR to position the window anywhere on the display.
Creating Graphics Using Graphics Windows DWINDOW is especially useful for displaying traces. Trace A is reproduced below in a window. 140 150 160 170 180 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"DWINDOW 400,400,0,1000,0,1000;" 723;"PU;PA 0,0;PD;" 723;"PA 0,1000,1000,1000,1000,0,0,0;" 723; "DWINDOW 400,400,TRA;" 723; "GRAPH TRA;" Draw box to outline trace. De ne window size and contents. Display trace A.
Creating Graphics To reduce the display area Use the IWINDOW command. 100 OUTPUT 723;"IWINDOW 1000,800;" The example above de nes reduces the window's height from 1000 units to 800 units. The window's default height and width is 1000 units. To create a graphics window Use the DWINDOW command to de ne the size of the window and its scale. The following line de nes a window at the current pen location. The window is 400 units wide and 300 units high. Its scale is 1000 units per side.
Creating Graphics
6 Creating Downloadable Programs
Creating Downloadable Programs This chapter tells how to store a series of commands in internal memory to form new, custom-made commands or user-de ned functions called downloadable programs (DLPs). The looping and conditional constructs, REPEAT/UNTIL and IF/THEN/ELSE, and the interrupt functions, ABORT and RETURN, are also described. DLPs have many applications. They are ideal for repetitive measurements, and make it possible to conduct complicated measurements with the press of a single front-panel key.
Creating Downloadable Programs Contents Creating a Downloadable Program (DLP) : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 6-4 To store a function : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 6-7 To con rm a function is stored : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 6-7 Creating an Active User-De ned Function : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 6-8 Branching, Looping,
Creating a Downloadable Program The FUNCDEF (de ne function) command consolidates a series of OSA commands into one operation and gives it a name. Executing the function name is the same as executing the series of commands contained in the function. Reserved Words Do not use the reserved words (as listed in Chapter 8 of this manual) as DLP names. Using reserved words interrupts the de ning process and executes the invoked function.
Creating Downloadable Programs Creating a Downloadable Program Program Structure for Storing DLPs to Internal Memory In the model, the rst part tells what the program does and gives other appropriate information such as the author's name, the date, and a le name. The second part initializes the OSA in order to form a good starting point for measurements. CLEAR 723 and IP set the OSA to a known state. DISPOSE ALL clears internal memory to maximize storage space for functions, variables, and traces.
Creating Downloadable Programs Creating a Downloadable Program The following example illustrates this program structure. Note that the sub-function called VIEW SIGNAL is executed twice in the main function, SCAN. 10 !File Name: Peaks Date: 4/1/91 Author: Name 20 !View the largest signal in two ranges using narrow span. 30 !Store the amplitude of the largest signal in each range.
Creating Downloadable Programs Creating a Downloadable Program To store a function Write the FUNCDEFs using short program lines. Indent program lines to mark sub-functions and points of looping and branching. Use descriptive labels for variables, functions, and traces (memory space permitting). De ne all variables and traces at the beginning of the program, not within a FUNCDEF de nition. Use recommended syntax shown in the Language Reference chapter.
Creating an Active User-De ned Function The ACTDEF command creates a user-de ned function that operates like an active function. Active functions have the following characteristics: Their current value is displayed in the active-function readout. Their value can be changed with front-panel keys. Their value is expressed as a variable for operations with other OSA functions.
Branching, Looping, and Interrupting Use the IF/THEN/ELSE, REPEAT/UNTIL, ABORT, and RETURN commands to add decision-making, looping, or interrupt capability to user-de ned functions. The ABORT command stops the execution of all user-de ned functions and interrupts the operation of repeat loops. If ABORT is encountered in a function that has been executed by pressing a key, the function is interrupted and front-panel control is returned.
Creating Downloadable Programs Branching, Looping, and Interrupting 170 OUTPUT 723;"^PROGRAM_1;TEXT@INSIDE PROGRAM_2@;"; 180 185 190 200 210 220 OUTPUT ! OUTPUT OUTPUT OUTPUT OUTPUT 723;"^;"; 723;"FUNCDEF PROGRAM_3,"; 723;"^PROGRAM_2;TEXT@INSIDE PROGRAM_3@;"; 723;"^;"; 723;"PROGRAM_3;"; 225 ! 230 OUTPUT 723;"PU;PA 300,200;"; 240 OUTPUT 723;"TEXT@OUTSIDE USER-DEFINED FUNCTIONS@;" Execute PROGRAM 1 and write \INSIDE PROGRAM 2." De ne PROGRAM 3. Execute PROGRAM 3.
Creating Downloadable Programs Branching, Looping, and Interrupting To use a looping construct Use the REPEAT/UNTIL command In this example, repetition is controlled with a user-de ned variable, N, which incrementally increases each time the loop is repeated. The example stores the amplitudes of the three largest signals in the rst three elements of a trace array. In addition, N doubles as a pointer that speci es where data is stored in the trace array.
Executing User-De ned Functions After storing a user-de ned function in internal memory with the FUNCDEF or ACTDEF command, execute the function from a computer or with the front-panel controls. To recall a function from external memory to internal memory, use the LOAD or RCLD command. If you want your downloadable program to automatically appear in the 4USER5 menu, the name of the main FUNCDEF must end in a single underscore character. NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN Use execute DLP with caution.
Creating Downloadable Programs Executing User-De ned Functions To execute a function via computer Use an output statement to send the function name as you would any OSA command. Be sure to terminate the function name with a semicolon. For example, to execute a user-de ned function named HIGH PEAK: 10 OUTPUT 723;"HIGH_PEAK;" To execute a function via front-panel keys 1. Press 4MENU5 and then Misc . NNNNNNNNNNNNNN 2. Press MORE 1 of 3 . NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN 3. Press execute DLP .
Building USER Menus The KEYDEF and READMENU commands allow you to build complex interactive menus for your user-de ned functions. Keys that you create are displayed by pressing the 4USER5 key. Up to 14 keys can be displayed at one time in the 4USER5 menu. The keys are numbered 1 through 14, keys 1 and 8 occupying the upper right and left corners, respectively. The following example, the HIGH PEAK function is assigned to softkey 7 and labeled \FIND PEAK.
Creating Downloadable Programs Building USER Menus 10 CLEAR 723 20 OUTPUT 723;"IP;DISPOSE ALL;" 30 ! 40 OUTPUT 723;"FUNCDEF BANDA,@STARTWL 600NM;STOPWL 900NM;@;" 50 OUTPUT 723;"FUNCDEF BANDB,@STARTWL 900NM;STOPWL 1200NM;@;" 60 OUTPUT 723;"FUNCDEF BANDC,@STARTWL 1200NM;STOPWL 1700NM;@;" 70 ! 80 OUTPUT 723;"VARDEF KEY,0;" 90 OUTPUT 723;"VARDEF END_LOOP,0;" 100 ! 110 OUTPUT 723;"REPEAT;" 160 OUTPUT 723;"READMENU KEY,1,$BAND A$,2,$BANDB$,3,$BANDC$,14,$EXIT$;"; 180 190 200 210 OUTPUT OUTPUT OUTPUT OUTPUT 723
Creating Downloadable Programs Building USER Menus 10 CLEAR 723 20 OUTPUT 723;"IP;DISPOSE ALL;" 30 ! 40 OUTPUT 723;"FUNCDEF BANDA,@STARTWL 600NM;STOPWL 900NM;@;" 50 OUTPUT 723;"FUNCDEF BANDB,@STARTWL 900NM;STOPWL 1200NM;@;" 60 OUTPUT 723;"FUNCDEF BANDC,@STARTWL 1200NM;STOPWL 1700NM;@;" 70 ! 80 OUTPUT 723;"VARDEF KEY,0;" 90 OUTPUT 723;"VARDEF END_LOOP,0;" 100 ! 105 OUTPUT 723;"FUNCDEF SELECT_SPAN,@"; 110 OUTPUT 723;"REPEAT;"; 160 OUTPUT 723;"READMENU KEY,1,$BAND A$,2,$BAND B$,3,$BAND C$,14,$EXIT$;"; 170 !
Creating Downloadable Programs Building USER Menus To assign a function to the 4USER5 menu Use the KEYDEF command. To build interactive menus 1. Create a variable for recording the softkey pressed. 2. Use the READMENU command to load variable with number of softkey pressed. 3. Use IF/THEN/ELSE statements to make decisions based on variable value.
Avoiding Illegal Recursion Executing a user-de ned function within the FUNCDEF command statement that de nes it is an illegal recursion. 10 20 30 40 OUTPUT OUTPUT OUTPUT OUTPUT 723;"FUNCDEF SELECT_SPAN, @"; 723;"STARTWL 800NM;STOPWL 900WL;"; 723;"SELECT_SPAN;"; 723;"@;" On the other hand, recursion is advantageous when creating active user-de ned functions with the ACTDEF command.
Controlling Instruments Over HP-IB This section tells how to use the OSA as a controller on HP-IB. As a controller, the OSA transfers data to or accepts data from other HP-IB devices, thus expanding its measurement capability. For example, the OSA can control an HP-IB switch driver to select the correct optical input for measurement. Or, the OSA can control a power meter and signal source. Use the OUTPUT command to send data to an HP-IB device located at a particular HP-IB address.
Creating Downloadable Programs computer is not in control of the HP-IB. (Only one controller can control HP-IB at any time.) For this reason, ENTER and OUTPUT commands are incorporated into user-de ned functions that are executed by the OSA with user-de ned keys. This is accomplished by either physically disconnecting the computer from the bus, or by executing the HP-IB system-level commands that release the computer from HP-IB. The HP-BASIC command sequence that does this is shown below.
7 Language Reference
Language Reference This chapter is organized alphabetically and documents each of the remote programming commands for the optical spectrum analyzer. Documented with each command is a syntax diagram, a program example, and a complete description. Command syntax is represented pictorially as shown in the following gure. Characters enclosed by an oval are commands and their arguments and must be entered exactly as shown.
Language Reference Syntax Diagram Elements Syntax Component analyzer command character De nition/Range Any spectrum-analyzer command in this chapter, with required parameters and terminators. fjg SP * - < = > @ ^ ~! " # $% &' () +, . / 01 23 45 6 7 89 : ;ABCDEF GHIJKLMNOP QRSTUVWXYZ [ ]? ` a bc d e fg h i j kl m n o pq r s tu v w x yz n j compatible function data byte data byte & EOI delimiter Any spectrum-analyzer command in this chapter that operates on other functions.
Language Reference Syntax Diagram Elements (continued) Syntax Component De nition/Range prede ned function AMPU, WLUNITS, MEASU, MEM, MKBW, PEAKS, POSU, PWRBW, RMS, STB, STDEV, SUM, SUMSQR, VARIANCE. A prede ned function is an analyzer command that returns a number that can be operated on by other commands called compatible functions. Insert a prede ned function into a command statement where prede ned function appears in the command syntax chart. (See compatible function in this table.
Language Reference Syntax Diagram Elements (continued) Syntax Component De nition/Range user-de ned function A label 1 to 12 characters long that is de ned by the FUNCDEF or ACTDEF command. Choice of characters is A { Z, 0 { 9, and the underscore ( ). First character must be a letter. Numbers must be preceded by the underscore. user-de ned trace A label 1 to 12 characters long that is de ned by the TRDEF command. Choice of characters is A { Z, 0 { 9, and the underscore( ).
Language Reference Terminators, Separators, and Commonly Used Arguments Item Description , Comma. ASCII-decimal number 44. ; Semicolon. ASCII-decimal number 59. SP Space. ASCII-decimal number 32. CR Carriage return. ASCII-decimal number 13. LF Line feed. ASCII-decimal number 10. DN Down. Change function value by step increment. Simulates press of 495 key. UP Up. Change function value by step increment. Simulates press of 485 key. EP Enter parameter.
Language Reference ABORT ABORT Stop the execution of a user-de ned function. Example Use ABORT to interrupt operation of a repeat loop. Initialize analyzer.
Language Reference ABORT Description The ABORT command stops the execution of a user-de ned function. If ABORT is encountered in a function that has been executed by pressing a key, the function is interrupted and front-panel control is returned. If the function is activated by a computer program, ABORT resumes program operation at the rst analyzer command following the function.
Language Reference ABS ABS Store the absolute values of the source, point by point, in the destination.
Language Reference ABS Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example Description Source-Length Range 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference ACTDEF ACTDEF Activate a user-de ned active function.
Language Reference ACTDEF Item Example Description Function-Name Range 1 { 12 characters: A { Z, 0 { 9, and underscore ( ). First character must be a letter. Numbers must be preceded by underscore. Readout Range As allowed by selected units. Initial-Value Range As allowed by selected units. Create a user-de ned function whose value can be changed with front-panel controls or with math operations.
Language Reference ACTDEF For example, consider the active function for center wavelength. When the center-wavelength key is pressed, its value is displayed in the active-function readout. Turning the front-panel knob changes the active-function readout and the value of the prede ned variable for center wavelength, CENTERWL.
Language Reference ACTDEF A temporary variable called COUNT is created, and assigned the initial value. The variable is available for math operations. The current value of the function (and of the temporary variable) is displayed in the active function readout. Number 5 is displayed initially. The step keys, knob, and numeric keypad can change the function value. In the preceding example, the user-de ned function routine is a null function. (There are no commands between delimiters $$ in line 10.
Language Reference ACTDEF Behavior of Unit Arguments Argument Step-Increment Value Unit-Keys Math Operation Compatibility STEP 1 none INT (integer) 1 none H Resolution bandwidth during zero-span mode; otherwise, 10% of span. frequency yes ABSH (absolute hertz) 1, 3, 10 sequence yes M Resolution bandwidth during zero-span mode; otherwise, 10% of span.
Language Reference ACTDEF See Also DISPOSE, FORMAT, LOAD, PROTECT, RCLD, PURGE 7-16
Language Reference ACTPARM ACTPARM Turn the active parameter area on or o . Item Example Description Description Preset State OFF Number Range 0, 1, 2, 3, 4 (If the \number" is omitted, the command default is 0, the rst line.) 10 OUTPUT 723;"ACTPARM 1;" 20 OUTPUT 723;"ACTPARM?;" 30 OUTPUT 723;"ACTPARM 0?;" Turn on the active parameters. Query the top line value. Query the top line value. The ACTPARM command turns the display of the active parameter area on or o .
Language Reference ADAPBTL Performs trace math A * DL / (A + B) 7 A with each sweep. Item Preset State Example Description 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT Description ADAPBTL OFF 723;"SNGLS;" 723;"LN;" 723;"TS;VIEW TRA;" 723;"ADAPBTL ON;" Activate single-sweep mode. Select linear amplitude scale. Sweep trace A and store it. The ADAPBTL command requires a linear display mode. It multiplies trace A by the display line and then divides the result by the sum of traces A and B.
Language Reference ADAPBTL Query Response 7-19
Language Reference ADAPBPCTL Performs trace math A * DL / (A + B + C) 7 A with each sweep. Item Preset State Example Description 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT Description ADAPBPCTL OFF 723;"SNGLS;" 723;"LN;" 723;"TS;VIEW TRA;" 723;"ADAPBPCTL ON;" Activate single-sweep mode. Select linear amplitude scale. Sweep trace A and store it. The ADAPBPCTL command requires a linear display mode. It multiplies trace A by the display line and divides the result by the sum of traces A, B, and C.
Language Reference ADAPBPCTL Query Response See Also ADBTL 7-21
Language Reference ADBTL Performs trace math A * DL / B 7 A with each sweep. Item Preset State Example Description 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT Description ADBTL OFF 723;"SNGLS;" 723;"LN;" 723;"TS;VIEW TRA;" 723;"ADBTL ON;" Activate single-sweep mode. Select linear amplitude scale. Sweep trace A and store it. The ADBTL command requires a linear display mode. It multiplies trace A by the display line value then divides by trace B. The results are stored in trace A.
Language Reference ADBTL Query Response 7-23
Language Reference ADCTL Performs trace math A * DL / C 7 A with each sweep. Item Preset State Example Description 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT Description ADCTL OFF 723;"SNGLS;" 723;"LN;" 723;"TS;VIEW TRA;" 723;"ADCTL ON;" Activate single-sweep mode. Select linear amplitude scale. Sweep trace A and store it. The ADCTL command requires a linear display mode. It multiplies trace A by the display line value, then divides by trace C. The results are stored in trace A.
Language Reference ADCTL Query Response 7-25
Language Reference ADCTRG Selects the source of the ADC trigger. Item Preset State Example Description Description ADCTRG FREE OUTPUT 723;"ADCTRG POSEDGE;" The ADCTRG command selects the type of external triggering used by the optical spectrum analyzer's analog-to-digital converter. The TTL-compatible trigger signal from the light source is connected to the rear-panel EXT TRIG IN connector.
Language Reference ADCTRG For external ADC triggering, connect the signal to the rear-panel EXT TRIG IN connector. To delay external ADC triggering, refer to \ADCTRGDLY". External trigger When using external ADC triggering in non-zero spans, the frequency of the external trigger signal can a ect measurement accuracy. The trigger signal's frequency can a ect measurement accuracy frequency must be greater than 1:5 (trace length) : frequency > sweep time In some cases, a factor as high as 2.
Language Reference ADCTRG See Also ADCTRGDLY, ADCTRGSYN 7-28
Language Reference ADCTRGDLY ADCTRGDLY Delays ADC triggering. Item Preset State Example Description Description Zero seconds of delay. OUTPUT 723;"ADCTRGDLY;" The ADCTRGDLY command delays external triggering of the analog-to-digital converter after the selected edge of the trigger signal.
Language Reference ADCTRGDLY See Also ADCTRG 7-30
Language Reference ADCTRGSYN ADCTRGSYN Sets status of ADC SYNC OUT during active (non-free) ADC trigger modes. Item Preset State Example Description Description Auto. OUTPUT 723;"ADCTRGSYN ON;" When AUTO is speci ed, the rear-panel ADC SYNC OUT signal is driven high when ADC trigger occurs and is driven low when the ADC trigger delay has expired. When ON is speci ed, the rear-panel ADC SYNC OUT signal is driven to a constant high state.
Language Reference ADD Add sources 1 and 2, point by point, then send their sum to the destination.
Language Reference ADD Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example Destination-Length Range 1 { 2048 position units. Source-Length Range 1 { 2048 position units.
Language Reference ALIGN Example Description Adjusts the ber positioner's tracking table. 100 OUTPUT 723;"ALIGN WHITE;" The ALIGN command adjusts the ber positioner's tracking table at multiple wavelengths. (The ber positioner aligns the monochromator's output beam with an internal optical- ber cable.) The alignment uses either the Option 002 built-in white light source or a user-supplied source. The command replaces pre-existing tracking data with new data and zeroes the 4AUTO ALIGN5 data.
Language Reference ALIGN AUTOPT MANUAL 71451A's MONOCHROMATOR INPUT) before issuing the ALIGN command. Speci es that an external broad-band light source is used. You must set the stop and start wavelengths prior to the alignment. These wavelengths are included in the alignment. The alignment takes about 2 or 3 minutes to complete. To run this alignment, you must observe the following points: Connect your own broadband light source to the front-panel input connector.
Language Reference ALIGN In the rare case where the AUTO ALIGN yields zero X and Y tracking corrections, the command will fail, indicating that no AUTO ALIGN data exists. The following errors can be reported as a result of issuing the ALIGN command: 7055 Cal Failed (0B) Trajectory Table Over ow: This error indicates an attempt to add a point to an already-full trajectory tracking table. Neither the table or the current autoalign data are altered.
Language Reference ALIGNPRST ALIGNPRST Reset the output- ber alignment of the monochromator. Example Description See Also 10 OUTPUT 723;"ALIGNPRST;" The ALIGNPRST command resets the optical spectrum analyzer monochromator output- ber alignment. The monochromator's Trajectory tracking table is set to factory calibration values.
Language Reference Performs trace math A 0 B 7 A with each sweep. AMB Item Preset State Example Description 30 40 50 60 70 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT Description AMB OFF 723;"SNGLS;" 723;"LG 5DB;" 723;"TS;VIEW TRA;" 723;"CLRW TRB;TS;" 723;"AMB ON;" Activate single-sweep mode. Select logarithmic scale. Measure with trace A and store results. Measure with trace B. Subtract trace B from trace A.
Language Reference AMBMC AMBMC Performs trace math (A - B) - C 7 A with each sweep. Item Preset State Example Description 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT Description AMBMC OFF 723;"SNGLS;" 723;"LG 5DB;" 723;"TS;VIEW TRA;" 723;"AMBMC ON;" Activate single-sweep mode. Select logarithmic scale. Sweep trace A and store it. The AMBMC command subtracts both trace B and trace C from trace A. The results are stored in trace A.
Language Reference AMBMCPL Performs trace math (A - B) - C+DL 7 A with each sweep. Item Preset State Example Description 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT Description AMBMCPL OFF 723;"SNGLS;" 723;"LG 5DB;" 723;"TS;VIEW TRA;" 723;"AMBMCPL ON;" Activate single-sweep mode. Select logarithmic scale. Sweep trace A and store it. The AMBMCPL command subtracts both trace B and trace C from trace A, and then adds the display line. The results are stored in trace A.
Language Reference AMBPL AMBPL Performs trace math A 0 B + DL 7 A with each sweep. Item Preset State Example Description 40 50 60 70 80 90 100 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT Description AMBPL OFF 723;"SNGLS;" 723;"LG 5DB;" 723;"TS;VIEW TRA;" 723;"RL -10DBM;" 723;"CLRW TRB;TS;" 723;"DL -10DBM;" 723;"AMBPL ON;" Activate single-sweep mode. Select logarithmic scale. Measure with trace A and store results. Change reference level to 10 dBm. Measure with trace B.
Language Reference AMBPL Query Response See Also AMB, TS, TRPST, TRSTAT, VIEW, TM, VTL, VTH, CONTS, SNGLS, CLRW, STORREF 7-42
Language Reference AMC Performs trace math A 0 C 7 A with each sweep. AMC Item Preset State Example Description 30 40 50 60 70 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT Description AMC OFF 723;"SNGLS;" 723;"LG 5DB;" 723;"TS;VIEW TRA;" 723;"CLRW TRC;TS;" 723;"AMC ON;" Activate single-sweep mode. Select logarithmic scale. Measure with trace A and store results. Measure with trace C. Subtract trace C from trace A.
Language Reference AMCPL Performs trace math (A - C)+DL 7 A with each sweep. Item Preset State Example Description 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT Description AMCPL OFF 723;"SNGLS;" 723;"LG 5DB;" 723;"TS;VIEW TRA;" 723;"AMCPL ON;" Activate single-sweep mode. Select logarithmic scale. Sweep trace A and store it. The AMCPL command subtracts trace C from trace A, and then adds the display line. The results are stored in trace A.
Language Reference AMETER AMETER Enable readout of currently updated trace point. Item Preset State Example Description Description AMETER OFF 70 OUTPUT 723;"AMETER ON;" The AMETER command enables a readout of the amplitude of the blank-ahead marker in the display's message area. The blank-ahead marker is the point on the trace which is currently being updated by new measurement data.
Language Reference AMPCOR Apply amplitude corrections at speci ed wavelengths. Item Description Wavelength Range 600 { 1700 nm Amplitude Range full measurement range Number of wavelength/amplitude pairs Depends on available internal memory. Preset State Example AMPCOR OFF Compensate for wavelength-dependent amplitude inaccuracies at the input. 150 OUTPUT 723;"CENTERWL 950NM;SP 200NM;" Set center wavelength and span.
Language Reference AMPCOR 230 DISP "PRESS CONTINUE" 240 PAUSE 250 DISP "" 260 OUTPUT 723;"AMPCOR OFF;" 270 OUTPUT 723;"AMPCOR?;" 280 ENTER 723;A$[1] 290 PRINT A$[1] Description Query Response See Also Press CONTINUE on computer keyboard to continue program. Turn o AMPCOR function. Query correction values to computer. Values are zeros, because AMPCOR is turned o . Use AMPCOR to compensate for wavelength-dependent amplitude variations at the input port.
Language Reference AMPMKR Example Position the left and right power integration points to the value speci ed on either side of the peak. 110 OUTPUT 723;"AMPMKR 010,DB;" 120 OUTPUT 723;"AMPMKR .1,X;" Description See Also Set the left and right integration points down 10 dB from the peak. Set the left and right integration points down 10% (or 010 dB) from the peak. The AMPKMKR command positions the power integration points down from the peak according to the entered amplitude.
Language Reference AMPU AMPU Convert measurement-unit values to amplitude-unit values.
Language Reference AMPU Item Description Source Amplitude Range For trace element, 0 { 10,000 measurement units for linear trace data, and +32,767 measurement units for logarithmic trace data. 032,768 { 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Source-Length Range 1 { 2048 Reference-Trace Amplitude Range 0 { 10,000 measurement units for linear trace data. Reference-Trace Length Range 3 { 2048 position units.
Language Reference AMPU mark (?). When used as a query, AMPU sends the amplitude-unit value of the source on the bus to the computer. Use AMPU as a source by incorporating the AMPU statement into the source of any spectrum-analyzer command having prede ned function in its syntax diagram. When AMPU is used as a source, the amplitude-unit value of the source is used for operation by the command containing AMPU.
Language Reference AMPU Predened-Function Syntax Query Response See Also AUNITS, RL, MEASURE, ROFFSET, INZ, LN, LG 7-52
Language Reference ANNOFF ANNOFF Description See Also Turn o all display annotation. The ANNOFF command turns o all annotation on the display screen similar to the ANNOT OFF command. The di erence is that, in order to reenable the display annotation, either execute the IP command or press the INSTRUMENT PRESET key on the front panel.
Language Reference ANNOT Turn annotation on or o . Item Preset State Example Description ANNOT ON 110 OUTPUT 723;"ANNOT OFF;" Turn o the annotation. The ANNOT command turns o the annotation on the analyzer display. When the annotation is turned o , the time between sweeps decreases. The annotation command also blanks text displayed with the TITLE command.
Language Reference APB APB 30 40 50 60 70 Add trace B and trace A, then enter sum in trace A. (A + B 7 A) Example OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"SNGLS;" 723;"RL 10DBM;SP 200NM;CENTERWL 950NM;" 723;"TS;VIEW TRA;" 723;"CLRW TRB;TS;" 723;"AMB ON;" Description Activate single-sweep mode. Set measurement range. Sweep trace A and view results. Clear write trace B. Sweep trace B. Subtract trace B from trace A. The APB command adds traces A and B, point by point, then sends the result to trace A.
Language Reference APBDCTL Performs trace math DL * (A+B) / C 7 A with each sweep. Item Preset State Example Description 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT Description APBDCTL OFF 723;"SNGLS;" 723;"LN;" 723;"TS;VIEW TRA;" 723;"APBDCTL;" Activate single-sweep mode. Select linear amplitude scale. Sweep trace A and store it. The APBDCTL command requires a linear display mode. It multiplies the sum of traces A and B by the display line. Then, this result is divided by trace C.
Language Reference APBDCTL Query Response 7-57
Language Reference AUNITS Select amplitude units or annotation and query data. Item Preset State Example Description Description AUNITS DBM Change the units of the amplitude readouts. 160 OUTPUT 723;"AUNITS AUTO;" Indicate amplitude units in dBm. The AUNITS command changes the units of the amplitude readouts displayed on the analyzer display or queried to the computer. The AUNITS command also determines the amplitude units for analyzer commands where the default-units path is speci ed.
Language Reference AUNITS Query Response 7-59
Language Reference AUTOALIGN Automatically realign the monochromator output ber. Example Description See Also 10 OUTPUT 723;"AUTOALIGN;" The AUTOALIGN command realigns the optical spectrum analyzer monochromator output ber with the output beam. If there is a marker on screen, the alignment is done at the marker's wavelength. If there is no marker, the alignment is done at the wavelength of the largest signal detected in full span.
Language Reference AUTOMDB AUTOMDB Set vertical scale after the automatic measurement procedure. Item Vertical Scale Limits Example Description Description 0.01 dB to 20 dB 10 OUTPUT 723;"AUTOMDB 10DB;" The AUTOMDB command sets the vertical scale (decibels-per-division) after performing the auto-measurement procedure. If AUTO is speci ed, the measurement procedure uses the vertical scale prior to initiating the measurement procedure.
Language Reference AUTOMEAS Automatically zoom in on largest signal at input. Example Description See Also 10 OUTPUT 723;"AUTOMEAS;" The AUTOMEAS command causes the optical spectrum analyzer to automatically locate the largest input signal. When the command is executed, the optical spectrum analyzer resets to the full wavelength span. Then, the largest signal is located, and the span is reduced to observe this signal.
Language Reference AUTOMMKR AUTOMMKR Locate the closest signal to the current marker. Example Description 10 OUTPUT 723;"AUTOMMKR ON;" The AUTOMMKR command causes the automatic measurement routine to locate the signal that is closest to the current marker. This alters the routine's normal function of locating the largest input signal across the optical spectrum analyzer's full wavelength range. When AUTOMMKR in ON, the routine starts from the current wavelength span rather than the full span.
Language Reference AUTOMOPT Control sensitivity optimization during the automeasure routine. Item Preset State Example Description AUTOMOPT OFF 100 OUTPUT 723;"AUTOMOPT ON;" The AUTOMOPT command controls sensitivity optimization during the automatic measurement routine. When AUTOMOPT is on, the AUTOMEAS routine optimizes the sensitivity after locating the signal. This feature is useful for signals that have a large dynamic range such as DFB lasers.
Language Reference AUTOMSP AUTOMSP Example Description Determine the nal wavelength span set by the automatic measurement routine. 10 OUTPUT 723;"AUTOMSP 100NM;" The AUTOMSP command sets the wavelength span for viewing the signal located by the AUTOMEAS function.
Language Reference AUTORNG Example Description Determine whether automatic ranging is enabled or disabled. 10 OUTPUT 723;"AUTORNG ON;" Enable the automatic-ranging feature. When the signal is less powerful, select the most sensitive measuring range. When the signal is more powerful, select the less sensitive measuring range. The AUTORNG command is used to turn on or o the automatic ranging feature. When the incoming signal strength is su cient, a less sensitive measurement mode is needed.
Language Reference AVG AVG Average the source and the destination, then store the result in the destination.
Language Reference AVG Item Description Average-Ratio Range 032,768 { +32,767, except 0 Source or Destination Amplitude Range 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example Destination-Length Range 1 { 2048 position units.
Language Reference AXB AXB Exchange contents of trace A and trace B. Example Description See Also 120 130 140 150 160 170 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"SNGLS;" 723;"CENTERWL 950NM;SP 500NM;" 723;"TS;VIEW TRA;" 723;"FS;" 723;"CLRW TRB;TS;" 723;"AXB;" Activate single-sweep mode. Set measurement range. Sweep trace A and store it. Measure with full span. Clear-write trace B. Exchange traces A and B. The AXB command exchanges the contents of traces A and B.
Language Reference AXC Exchange contents of trace A and trace C. Example Description See Also 120 130 140 150 OUTPUT OUTPUT OUTPUT OUTPUT 723;"SNGLS;" 723;"CENTERWL 950NM;SP 500NM;" 723;"TS;VIEW TRA;" 723;"AXC;" Activate single-sweep mode. Set measurement range. Sweep trace A and store it. Exchange traces A and C. The AXC command exchanges the contents of traces A and C. If trace A and trace C are in clear-write mode, AXC puts them in view mode. If the traces are of di erent lengths, data is lost.
Language Reference BIT BIT Store the state of a speci ed bit in the destination.
Language Reference BIT Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example Destination-Length Range 1 { 2048 position units. Source-Length Range 1 { 2048 position units.
Language Reference BLANK BLANK Example Description See Also Blank and store display of trace. 110 OUTPUT 723;"BLANK TRA;" Blank trace A. The BLANK command stops sweeping (updating) the speci ed trace and deletes it from the display. Any data contained in the trace is stored in reserved memory.
Language Reference Subtract display line value from trace B. (B 0 DL 7 B) BML Example 110 120 130 140 OUTPUT OUTPUT OUTPUT OUTPUT 723;"BLANK TRA;" 723;"SNGLS;" 723;"CENTERWL 750NM;SP 100NM;" 723;"DL -10DBM;RL 0DBM;" 150 OUTPUT 723;"CLRW TRB;TS;" 160 PAUSE 170 OUTPUT 723;"BML;" Description See Also Blank trace A. Activate single-sweep mode. Set measurement range. Set display line and reference level. Sweep trace B. Press CONTINUE on computer keyboard. Subtract display line from trace B.
Language Reference BP BP Send the \beep" command to the display. Example Description 100 OUTPUT 723;"BP;" The BP command sends the BP; command to the display causing a single audible beep. The length and pitch of the tone can not be controlled. If there is no display link, neither a beep or error message occurs.
Language Reference BTC Store a copy of trace B in trace C, then store and display trace C contents. Example Description See Also 120 OUTPUT 723;"SNGLS;CLRW TRB;TS;" 130 OUTPUT 723;"BTC;" Sweep trace B. Transfer trace B to trace C. The BTC command transfers the contents of trace B to trace C, then stops updating trace C by placing it in the view mode. Be sure trace B contains a complete sweep of measurement information. To retain all data, the length of traces A and B must be equal.
Language Reference BXC BXC Exchange contents of trace B and trace C. Example Description See Also 190 OUTPUT 723;"BXC;" Exchange traces B and C. The BXC command exchanges the contents of traces B and C, then stops updating them by placing them in the view mode. Be sure each trace contains a complete sweep of measurement information before executing BXC. To retain all data, the size of the traces must be equal. Use TRDEF to change trace length if necessary.
Language Reference CAL Execute a calibration routine. Item Description CAL ALL Preset State Example Description 10 OUTPUT 723;"CAL WL;" The CAL command performs error-correction routines which calculate and apply correction factors for wavelength or power. An external calibration signal must be connected to the optical spectrum analyzer before executing CAL. If a signal is not connected, an error condition results. Use the CALCOR command to deactivate the correction factors.
Language Reference CAL CAL WLPIT See Also that the calibration signal is within 65 dB of the entered calibration power. Calibrates at the wavelength of the designated signal pit.
Language Reference CALCOR Individually remove applied calibration correction factors. Item Preset State Example Description Description CALCOR ALL,ON 170 OUTPUT 723;"CALCOR PWR,?;" 180 ENTER 723;A Query status of power correction factor. Assign response (1 or 0) to computer variable. The CALCOR command disables the correction factors computed by the CAL command. The factors can be disabled or re-enabled individually or all at once. During normal operation, all correction factors are on.
Language Reference CALCOR Query Response See Also CAL, CALWL, CALPWR 7-81
Language Reference CALDATA Example Description Return factory-supplied calibration data. 10 20 30 40 50 60 70 80 90 INTEGER NUM_PTS REAL CAL(1:300,1:2) MAT CAL=(02E9) OUTPUT 723;"CALDATA FIRST?;" ENTER 723 USING "%,K";CAL(*) NUM_PTS=1 WHILE CAL(NUM_PTS,1)>01E9 NUM_PTS=NUM_PTS+1 END_WHILE The CALDATA command queries the optical spectrum analyzer for factory supplied calibration data. The calibration data returned is determined by the INSTMODE setting.
Language Reference CALDATA Query Response See Also INSTMODE, GRATORDER 7-83
Language Reference CALPWR Specify power level of reference signal used by calibration routine. Item Example Minimum level is Step Increment 1 major vertical-scale division 140 OUTPUT 723;"CALPWR -15DBM;" 150 OUTPUT 723;"CALPWR?;" 160 ENTER 723;N 170 PRINT "Calibrate to ";N;"dBm" Description 0300 dBm. Power Range Description Specify 015 dBm as the power level of the calibrator reference. Query value to computer. Assign value to computer variable. Print value on computer display.
Language Reference CALPWR Query Response See Also CAL, CALCOR, CALWL 7-85
Language Reference CALWL Specify wavelength used by calibration routine. Item Example Description Description Wavelength Range 600nm { 1700nm Step Increment 10% of span Preset State 1300 nm 150 OUTPUT 723;"CALWL 600NM;" Calibrate to 600 nm. The CALWL command speci es the wavelength of the calibration reference used with the CAL command. (The CAL command performs a calibration at the wavelength speci ed by CALWL.) Use CALWL to specify a di erent calibration wavelength.
Language Reference CALWL Query Response See Also CAL, CALCOR, CALPWR 7-87
Language Reference CATALOG Example Description Query the catalog of internal memory in a condensed format. 150 OUTPUT 723;"CATALOG?;" The CATALOG command queries the catalog of internal memory in a condensed format as follows: 0917504,0914480 CONFIG,CONFIG,0005992 LARGEST,LARGEST,0911438 00011 FOO,FUNC 00008 FRED,VAR total mem, avail mem lename, letype, lesize Name and letype are restricted to a maximum number of 15 characters; otherwise, both elds are truncated.
Language Reference CATALOG Cataloging MSI To catalog the contents of the memory selected by the CAT? command. MSI command, refer to the DSPTEXT When system DEBUG ON is active, the format is modi ed to give more information on actual le status.
Language Reference CATALOG Note the following items when using the CATALOG command with DEBUG ON. The listing re ects the ordering and structure of what is physically in memory as opposed to what is indicated in the sorted table. Therefore, some understanding of how the memory manager manipulates, resizes, and moves around these memory blocks is sometimes needed to understand what is shown.
Language Reference CATALOG See Also DSPTEXT 7-91
Language Reference CENTERWL Set the center wavelength of measurement range. Item Example Description Wavelength Range Actual range is hardware dependent. Firmware range is 600 nm to 1700 nm. With wavelength limit OFF, the range is 350 nm to 2000 nm. Step Increment Determined by SS command.
Language Reference CENTERWL Description The CENTERWL command sets the center wavelength. The span remains constant. The center-wavelength and the start- and stop-wavelength settings are related as follows: stop wavelength + start wavelength center wavelength = 2 CENTERWL UP and CENTERWL DN increase or decrease the center wavelength by increments determined by the step function, SS.
Language Reference CHEIGHT Query the character height. Item Preset State Description full window, 4.34 The CHEIGHT? query computes the character height as a percentage of the window height. This command is necessary for programs that want to adjust their graphics and TEXT displays depending on the window size. The characters remain the same size regardless of what size the window is. The units of the number returned is percent.
Language Reference CHOP CHOP Turn on or o the input and light for chop mode. Item Preset State Example Description Description ON 150 OUTPUT 723;"CHOP ON;" The CHOP command turns the input and light for chop mode on or o . Provided the sweep times are long, the CHOP command increases dynamic range. CHOP mode subtracts the ambient light from the signal. With CHOP mode ON, the instrument automatically enables chop mode for sweep times 40s, or longer. CHOP mode is disabled when it is set to OFF.
Language Reference CLRDSP Example Description See Also Clear the display. Clear the analyzer of user-created graphics. 110 120 130 140 OUTPUT OUTPUT OUTPUT OUTPUT 723;"PU;PA 300,900;" 723;"TEXT$WARNING$;" 723;"WAIT 4S;" 723;"CLRDSP;" Place pen at (300,900). Write text. Wait four seconds. Clear graphics. The CLRDSP command removes all spectrum-analyzer graphics from the display and its memory. CLRDSP executes the following: Deletes all items from memory (IT).
Language Reference CLRW CLRW Continuously measure and store detected signals. Item Preset State Example Description See Also Description CLRW TRA 120 OUTPUT 723;"CLRW TRA;" Clear-write trace A. The CLRW command enables the clear-write mode, which continuously measures and stores any signals present at the spectrum-analyzer input port when the trigger conditions for the sweep are met.
Language Reference CLS Set all bits in the status-byte register to 0. Example Description See Also 10 OUTPUT 723;"CLS;" The CLS (clear status) command clears all the bits in the status register. Upon completion of this command, the Command Complete bit of the status register is set. Refer to Chapter 4, \Monitoring System Operation" for additional information about status byte use.
Language Reference COMPRESS COMPRESS Reduce trace length while retaining relative wavelength and amplitude characteristics of trace data. Item Description Source or Destination Length Range 3 { 2048 position units. Source or Destination Amplitude Range 0 { 10,000 measurement units for linear trace data. 32,768 { +32,767 measurement units for logarithmic trace data.
Language Reference COMPRESS Example 110 OUTPUT 723;"CENTERWL 1000NM;SP 300NM;" 120 OUTPUT 723;"TRDEF TRC,100;" 130 OUTPUT 723;"BLANK TRA;SNGLS;" 140 OUTPUT 723;"CLRW TRB;TS;" 150 OUTPUT 723;"COMPRESS TRC,TRB,POS;" 160 OUTPUT 723;"BLANK TRB;" 170 OUTPUT 723;"VIEW TRC;" Description Set measurement range. Change length of trace C to 100 elements. Blank trace A. Activate singlesweep mode. Measure with trace B. Sweep measurement range. Compress trace C to t trace B. Blank trace B. View trace C.
Language Reference CONCAT CONCAT Concatenate two traces to make one trace. Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 32,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 0 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Source-Length Range 1 { 2048 position units.
Language Reference CONCAT Example Description See Also 200 OUTPUT 723;"CONCAT TRC,TRA[1,400],TRB[401,800];" Concatenate last half of trace B to end of rst half of trace A. Store new array in trace C. The CONCAT command concatenates source 2 to the end of source 1, then stores the new array in the destination. The size of the destination and sources can vary from 3 to 2048 points. If necessary, reduce trace lengths with COMPRESS, TRA, TRB, TRC, or TRDEF.
Language Reference CONFIG CONFIG Query the instrument con guration for model numbers and MSIB addresses of all slaves. 100 OUTPUT 723;"CONFIG;" Description The CONFIG command queries a series of ASCII strings, separated by carriage returns, indicating the model number and MSIB address of this module and any slave instruments.
Language Reference CONTS Example Description See Also Sweep continuously each time trigger conditions are met. 170 OUTPUT 723;"CONTS;" The CONTS command activates the continuous-sweep mode where the analyzer sweeps continuously as long as the trigger and data-entry conditions are met. Executing CONTS aborts the current sweep to start a new one.
Language Reference CORSEL CORSEL Example Description Select the atness correction table. 10 OUTPUT 723;"CORSEL 0;" The CORSEL command selects which atness correction table will be applied to the measurement data. NORMAL : Applies both diode and grating atness correction tables. Returned as 0 by the query. DIODE : Applies only the diode atness correction table. Returned as 1 by the query. GRATING : Applies only the grating atness correction table. Returned as 2 by the query.
Language Reference CORTOLIM Example Description See Also Transfer AMPCOR data to a limit line. 10 OUTPUT 723;"CORTOLIM UPPER;" Transfer amplitude-correction data into the upper limit line. The CORTOLIM command transfers data to the speci ed limit line. This allows the AMPCOR data to be viewed or edited. Use LIMTOCOR to bring the edited data back to the amplitude-correction storage.
Language Reference CWIDTH CWIDTH Query the character width as a percentage of the window width. Item Preset State Description Description full window, 1.87 The CWIDTH query computes the character width as a percentage of the window width. This command is necessary for programs that want to adjust their graphics and TEXT displays depending on the window size. The characters remain the same size regardless of what size the window is. The units of the number returned is percent.
Language Reference DEBUG Start the program debugging mode. Item Preset State Example Description Description DEBUG OFF 210 OUTPUT 723;"DEBUG SLOW;" 220 OUTPUT 723;"DEBUG OFF;" Activate the slow debug mode. Turn o debug mode. The DEBUG command is a troubleshooting aid for locating faulty syntax in spectrum-analyzer programs. DEBUG ON, DEBUG SLOW, and DEBUG FAST activate the debug mode, where spectrum analyzer commands are displayed on the data line below the graticule as the commands are executed.
Language Reference DEBUG Query Response 7-109
Language Reference DELETE Delete graphics item from memory.
Language Reference DFB DFB Start the DFB laser characterization measurement DLP. Parameters require one underscore and one space. Item DFB ? Description Queries the DLP and returns: peak wavelength wavelength o set stop band center o set SMSR (side mode suppression ratio) peak amplitude bandwidth bandwidth amplitude DFB B Turns on or o the view of the stop-band peaks. DFB C Turn on or o the view of the SMSR peaks. DFB O Turn on or o the calculations. DFB Q Exit the measurement DLP.
Language Reference DFB Example Description 10 20 30 40 OUTPUT OUTPUT OUTPUT OUTPUT 723;"IP;"; 723;"DFB_;"; 723;"DFB_ C;"; 723;"DFB_ Q;"; Preset the instrument. Start the DFB characterization measurement. Turn on or o , the view of SMSR peaks. Exit the DFB characterization measurement DLP. The DFB command automatically measures the characteristics of a distributed-feedback laser source. Refer to the HP 71450B/1B/2B User's Guide for additional information.
Language Reference DISPOSE DISPOSE Erase all or part of internal memory. Example 120 130 140 150 CLEAR 723 OUTPUT 723;"IP;" OUTPUT 723;"VARDEF VA,0;" OUTPUT 723;"FUNCDEF NNN,@ @;" 160 170 180 190 200 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"KEYDEF,7,NNN,$C$;" 723;"PROTECT VA,OFF;PROTECT NNN,OFF;" 723;"DISPOSE 7;" 723;"DISPOSE VA;" 723;"DISPOSE NNN;" Description Initialize analyzer. De ne user-de ned variable, VA, equal to 0. De ne null, user-de ned function, called NNN.
Language Reference DISPOSE Internal Memory Contents Article Storing Command User-de ned functions ACTDEF, FUNCDEF, RCLD, LOAD User-de ned variables VARDEF, RCLD, LOAD On-end-of-sweep algorithm ONEOS, RCLD, LOAD User-de ned key KEYDEF User-de ned trace arrays TRDEF, RCLD, LOAD Amplitude correction factors AMPCOR Limit-line trace arrays 4USER5 keys les LIMILINE, FUNCDEF, RCLD, LOAD STOR, SAVEU Limit line les STOR, LIMISAV Trace les STOR, SAVET State register les STOR, SAVES Program Files
Language Reference DISPOSE Commands that Erase or Protect Internal Memory Memory Components Commands that Erase or Reset Memory Commands that Protect Memory PURGE/DISPOSE/PERASE/ERASE PROTECT PSTATE X X user-de ned trace X X user-de ned function X X active user-de ned function X X on-end-of-sweep-algorithm X X trace-amplitude correction factors X X limit-line trace arrays X X trace-amplitude correction factors X state register le (settings and title line,) X trace le X X X X
Language Reference DISPU Dispose of a user menu. Item Example Description See Also Description integer, 0 - 9999, depending on memory Range 10 OUTPUT 723;"DISPU 10;" Dispose the speci ed user menu. The DISPU command is used to dispose USER menus that have been saved with the SAVE USERKEY softkey or the equivalent SAVEU command. The current PREFX is used.
Language Reference DIV DIV Divide source 1 by source 2, then send the result to the destination: 7-117
Language Reference DIV Item Description Source or Destination Amplitude Range 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example Description Source-Length Range 3 { 2048. Default is 800 when using TRA, TRB, TRC.
Language Reference DL DL Position a line on the display. Item Example Description Step Increment 1 major vertical division Preset State DL OFF; DL 0DBM Place display line at highest amplitude value of trace A. 150 OUTPUT 723;"MKPK HI;" 160 OUTPUT 723;"DL ON;" 170 OUTPUT 723;"MOV DL,MKA;" Mark highest amplitude value. Turn on the display line. Move the marker value into DL (prede ned variable).
Language Reference DL Description The DL command positions a line on the display for visual and computational purposes. Query Response See Also TRPST and any amplitude-related commands, such as ROFFSET, MEASURE, RL, LN, LG, INZ and math commands.
Language Reference DONE DONE Return a \1" to the controller after the execution of all commands preceding the DONE command. Example Use DONE to delay the execution of additional program commands until the entire measurement range is swept. 160 OUTPUT 723;"TS;DONE?;" 170 ENTER 723;A Description Sweep the measurement range, then send a \1" when the sweep is completed. Assign \1" to computer variable.
Language Reference DSPLY Display a variable anywhere on the analyzer display. Item Example Description Field width Determines the number of characters displayed, including digits, sign, and decimal point. Field-Width Range 1 { 18 Decimal Places Determines the number of digits to the right of the decimal point. Decimal-Place Range For eld widths greater than 3, range is from 0 to eld width less three. For eld widths equal to or less than 3, range is 0 (zero).
Language Reference DSPLY Description See Also The DSPLY command displays the value of a variable at the current position of the pen, determined by the plot-absolute (PA) or plot-relative (PR) commands or determined by the OR command during the reference-graphics mode. If the value does not t in the speci ed parameters, the variable is displayed in exponential notation. DSPLY cannot be executed after DWINDOW ON.
Language Reference DSPMODE Display catalog of user memory contents; HP-MSIB addresses of modules; module-level parameters; or system-level parameters, serial numbers, and revision numbers. Item Preset State Example Description Description DSPMODE NORMAL 140 OUTPUT 723;"DSPMODE CAT;" Display contents of currently selected user memory.
Language Reference DSPMODE DSPMODE PAGE displays the next \page" of information, if any. Execute it when previous executions of DSPMODE provide more than one page of information. DSPMODE STATE lists the current state of the system-level parameters under operator control, such as wavelength ranges and bandwidth settings. It also lists the identi cation and serial numbers, and rmware revision of the spectrum analyzer.
Language Reference DSPTEXT Example Description Query catalog of user memory contents; HP-MSIB addresses of modules; module-level parameters; or system-level parameters, serial numbers, or revision numbers. 10 OUTPUT 723;"DSPTEXT CAT?;" Query listing of contents of currently selected user memory. The DSPTEXT command sends system-level or module-level information to the computer.
Language Reference DSPTEXT Query Response See Also MSI, CATALOG, DSPMODE 7-127
Language Reference DWINDOW De ne alternate scale for graphics. Item X-Length Range Y-Length Range X-Minimum Range X-Maximum Range Y-Minimum Range Y-Maximum Range Preset State 7-128 Description 032,768 { 32,767, in units set by SCALE command. 032,768 { 32,767, in units set by SCALE command.
Language Reference DWINDOW Example Draw Y = X2 on the analyzer display. 180 190 200 210 220 CLEAR 723 OUTPUT 723;"IP;" OUTPUT 723;"CLRDSP;" OUTPUT 723;"TRDSP TRA,OFF;" OUTPUT 723;"OR 600,550;" Initialize analyzer. Clear graphics from memory. Turn o trace A. Set origin to (600,550) in current scale units. (CLRDSP sets units of X and Y axis from 0 to 1000.
Language Reference DWINDOW The position of the window on the analyzer display is speci ed with the OR command. Use DWINDOW to display custom graphics created with the plotting commands (PA, PR, PD, PU, MK) or to display trace information with the GRAPH command. If custom graphics are displayed, X Minimum, X Maximum, Y Minimum, and Y Maximum scale the coordinate system of the window in increments. DWINDOW cannot be used when displaying variables, grids, or text with the DSPLY, GRID, or TEXT commands.
Language Reference ENTER ENTER Receive data over HP-IB as a controller. Item Example Description HP-IB Address Field speci es the HP-IB address of the device. HP-IB Address Range 0 { 30 Format eld Formats the queried data. K Expects real, free- eld numbers (ASCII decimal). B (byte) Expects a single 8-bit byte. W (word) Expects two 8-bit bytes. Use the analyzer to control an HP 3478 multimeter via HP-IB.
Language Reference ENTER 190 OUTPUT 723;"FUNCDEF VDM,^"; 200 OUTPUT 723;"OUTPUT 25,K,$H5$;"; 210 OUTPUT 723;"ENTER 25,K,NN;"; 220 230 240 250 260 270 280 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"CLRDSP;"; 723;"PA 400,500;"; 723;"MPY NN,NN,1000;"; 723;"DSPLY NN,7,4;"; 723;"RELHPIB;"; 723;"^;" 723;"KEYDEF 7,VDM,$VDM$;" 290 LOCAL 723 Begin de nition of user-de ned function, called VDM. Send message, \H5" to multimeter. Receive value in amperes from multimeter. Store value in NN.
Language Reference ERASE ERASE Example Description Erase all memory, including internal memory and reserved memory, serial numbers, correction factors, and all analyzer settings. 10 OUTPUT 723;"ERASE;" Erase all memory, except factory calibration data stored in ROM. The ERASE command erases all memory, except factory calibration data stored in ROM. ERASE destroys any stored conditions that may explain faulty operation and aid in troubleshooting.
Language Reference ERR Send numeric codes that describe the nature of errors. Example 20 CLEAR 723 30 OUTPUT 723;"IP;"; 40 ALLOCATE Error_numbers$[50] 50 OUTPUT 723;"SAVES 1;VIEW;" 60 OUTPUT 723;"ERR?;" 70 ENTER 723;Error_numbers$ Description Create 50-element array in computer for the storage of any queried analyzer errors. Send two faulty commands to analyzer. Execute SAVES using out-of-limit parameter. Use the VIEW command with incorrect syntax. Send analyzer codes to the computer.
Language Reference EXP EXP Divide by N, retain quotient, then store 10quotient .
Language Reference EXP Item Source or Destination Amplitude Range Description 0 to 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 to +32,767 measurement units for logarithmic trace data in 308 TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10 when using number, prede ned variable, or user-de ned variable. Example Description Source-Length Range 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference FETCH FETCH Example Description Query trace data before end-of-sweep. 20 OUTPUT 723;"FETCH?;" The FETCH command initiates a sweep and sends the contents of trace data in binary format, as it sweeps, to the computer. The TRA, TRB, and TRC commands di er because they usually follow the TS command. As a result, the trace data is returned to the computer at the completion of a sweep.
Language Reference FFT Execute fast Fourier transform. Item Example Description Window-Length Range Equals source length. Source-Length Range 1 { 2048. Default for TRA, TRB, TRC is 800. Destination-Length Range Equals source length. Connect a 750 nm signal to analyzer input.
Language Reference FFT 210 OUTPUT 723;"FFT TRA,TRB,TRC;" 220 230 240 250 Description OUTPUT OUTPUT OUTPUT OUTPUT 723;"BLANK TRB;" 723;"VIEW TRA;" 723;"MKN;" 723;"HD;" Weight trace B with trace C data, then perform Fourier transform. Store results in trace A. Blank trace B. Store and view trace A. Place a marker at the center of trace A. Blank active function readout.
Language Reference FFT Trace Windows The FFT algorithm assumes the source trace array is one period of an in nitely long string of concatenated, duplicate arrays. Thus, the beginning and end elements of the source trace array must gradually diminish to zero amplitude. If the end points of the original trace array are of di erent magnitude, the resulting array series could contain discontinuities that introduce high wavelength components into the Fourier transform.
Language Reference FFT wavelength resolution, but also produces the highest side lobes for periodic signals. The FLATTOP window has the greatest wavelength uncertainty of the windows, but it has outstanding side lobe suppression and amplitude atness. Use FLATTOP to transform periodic signals. The HANNING window is a traditional passband window found in most real-time analyzers. The HANNING window o ers a compromise between the FLATTOP and UNIFORM windows. The HANNING window amplitude uncertainty is 01.
Language Reference FFT Fourier Transforms of Hanning, Flat Top, and Uniform Trace Windows 7-142
Language Reference FFTKNL FFTKNL Example Description Perform a 16-bit discrete Fourier transform. 20 OUTPUT 723;"FFTKNL TRA,TRB;" The FFTKNL performs a discrete Fourier transform on the speci ed traces, overlaying them with the results. Both traces must be the same length and the length must be a power of two. The two traces represent the real and imaginary components of one complex-value trace. FFTKNL does no other normalizing, scaling, clipping, or magnitude determination.
Language Reference FORMAT Example Description See Also Erase and format the currently selected memory device. 20 OUTPUT 723;"FORMAT;" The FORMAT command formats and erases the currently selected memory device. Internal memory is selected automatically when power is applied to the spectrum analyzer. To select another memory device, execute MSI. When internal memory is selected, FORMAT erases all unprotected les from internal memory. (Refer to the PROTECT and PSTATE commands for additional information.
Language Reference FP FP Start the FP laser characterization measurement DLP.
Language Reference FP Q G Example Description Exit the measurement DLP Select envelope distribution 10 20 30 40 50 723;"IP;"; 723;"FP_;"; 723;"FP_ C;"; 723;"FP_ K;"; 723;"FP_ Q;"; Preset the instrument. Start the FP characterization measurement. Turn on, the view of the distribution trace. Display the results in the Gausian distribution. Exit the FP characterization measurement DLP. The FP command automatically measures the characteristics of a Fabry-Perot laser source.
Language Reference FP MKBW FP MKBW Set FP laser envelope bandwidth amplitude. Item Preset State Example Description 10 20 30 40 50 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 03.0 dB from peak 723;"IP;"; 723;"FP_;"; 723;"FP_ C;"; 723;"FP_ G;"; 723;"FP_MKBW 06 DB;"; Description Preset the instrument. Start the FP measurement. Display the distribution. Select envelope distribution. Set bandwidth amplitude to 06 dB.
Language Reference FP TH Set or query the Fabry-Perot laser threshold amplitude. Item FP TH? Preset State Example 020 DB;"; Preset the instrument. Start the FP measurement DLP. Query the instrument for the current threshold amplitude setting of the Fabry-Perot laser. Set the threshold amplitude for measured peaks to 020 dB. The FP TH command allows measurements using only the peaks above the threshold. (All signals above the threshold are used in the calculations.
Language Reference FS FS Activate full measurement range (wavelength). Example Description See Also 10 OUTPUT 723;"FS;" The FS command activates the widest measurement range allowed by the optical spectrum analyzer, setting the start and stop wavelengths to their minimum and maximum values.
Language Reference FUNCDEF De ne a list of analyzer commands that are executed as a user-de ned function. Item Function-Name Range Example Description 1 { 12 characters: A { Z, 0 { 9, and underscore ( ). First character must be a letter. Numbers must be preceded by underscore. Create a user-de ned function, then assign it to a user-de ned key.
Language Reference FUNCDEF 70 OUTPUT 723;"DSPMODE CAT;" Display catalog of currently selected user memory. Notice the listing includes the S HIFT function and SHIFT_UP key. FFFFFFFFFFFFFFFFFFFFF 80 OUTPUT 723;"CENTERWL 1300NM;SP 10NM;" 90 LOCAL 723 100 OUTPUT 723;"S_HIFT;" Description FFFFFFFFFFFFFFFFFFFFF Press 4USER5 to access SHIFT_UP key. Execute function from the computer.
Language Reference FUNCDEF Syntax to Execute a User-De ned Function Query Syntax Query Response See Also Requests the de nition of the function. Returns the de nition of the function.
Language Reference GATESWP GATESWP Enable time-gated measurements. Item Preset State Example Description Description OFF 10 OUTPUT 723;"GATESWP ON;" The GATESWP command enables measurements to be gated by a signal that is input to the module's rear-panel EXT TRIG IN connector. When the external trigger input is at a high logic level (TTL), measurement data is used for the display.
Language Reference GATESWP See Also MXMH 7-154
Language Reference GRAPH GRAPH Draw trace information inside a window created with the DWINDOW command. Item Description Trace-length Range 3 {2048 position units. Default for TRA, TRB, TRC is 800 position units. Trace-Amplitude Range For linear trace data, 0 { 10,000 measurement units. For logarithmic data, { 32,768 { +32,767 measurement units.
Language Reference GRAPH Description See Also The GRAPH command draws previously stored measurement results, sized according to the current scale units determined by the SCALE command, or the DWINDOW command if GRAPH is used with DWINDOW. If no units are speci ed, the default scale units are 0 to 1000 for both X and Y (set by CLRDSP). Use PD to place pen down, except during reference-graphics mode.
Language Reference GRAT GRAT Turn on and o the display of the graticule. Item Preset State Example Description GRAT ON 10 OUTPUT 723;"GRAT OFF;" Turn o the graticule.
Language Reference GRATORDER Select re ection order of analyzer's internal di raction grating. Item Example Description Description Preset State AUTO Wavelength Crossover 900 nm 10 OUTPUT 723;"GRATORDER MAN;" Select only the rst order. Use the GRATORDER command to manually select the rst or second re ection order of the optical spectrum analyzer's di raction grating. The di raction grating is located in the optical spectrum analyzer's internal monochromator.
Language Reference GRATORDER Whether 1st or 2nd order di raction-grating mode is selected depends on the following instrument conditions: Full span : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 1st order Stop > 900 nm (RES BW 6= 10 nm) : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 1st Stop < 900 nm (RES BW = 10 nm) : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 1st order Stop < 900 nm (RES BW 6= 10
Language Reference GRATSCRL Controls the positioning of the displayed horizontal graticule lines. Item Preset State Example Description Description GRATSCRL OFF 100 OUTPUT 723;"GRATSCRL ON;" When a log scale is displayed, the GRATSCRL command positions the horizontal graticule lines on multiples of the current dB-per-div scale. When GRATSCRL is set to o , the horizontal graticule lines are evenly spaced between the bottom and top screen values.
Language Reference GRID GRID Draw a grid on the analyzer display. Item Description X-Dimension Range A ected by SCALE command. Default range is 0 { 1000. Y-Dimension Range A ected by SCALE command. Default range is 0 { 1000. Number-of-X-Boxes-Range Depends on scale resolution. Number-of-Y-Boxes-Range Depends on scale resolution.
Language Reference GRID Example Description 40 50 60 70 80 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"GRAT OFF;" 723;"SCALE 112,911,17,338;" 723;"OR 112,48;" 723;"LINET 7;" 723;"PD;GRID 160,64,5,4;" The GRID command draws a grid on the analyzer display where the X and Y dimensions specify the horizontal and vertical length of a single box in the grid. Number of X boxes and Number of Y boxes specify the number of boxes on the X and Y axis of the grid.
Language Reference HD HD Blank the active function readout and disable front-panel numeric data entry. Example 120 CLEAR 723 130 OUTPUT 723;"IP;" 140 OUTPUT 723;"CENTERWL 850NM;" 150 OUTPUT 723;"WAIT 4S;" 160 OUTPUT 723;"HD;" Description Initialize analyzer Set center wavelength. Notice that the active function area (left side of graticule) displays the center wavelength value. Wait 4 seconds Blank the active function readout.
Language Reference ID Query the model number (identi cation) of the system-controlling module. Example 130 OUTPUT 723;"ID?;" 140 ENTER 723;N$ Query Response 7-164 Query value Assign value to computer string variable.
Language Reference IF/THEN IF/THEN Execute a list of commands if conditions of your choosing are met.
Language Reference IF/THEN Example 20 30 40 50 60 70 80 90 100 Print a message depending on the level of a measured signal. CLEAR 723 OUTPUT 723;"IP;" OUTPUT 723;"SNGLS;" OUTPUT 723;"PA 250,500;" OUTPUT 723;"SP 50NM;CENTERWL 750NM;" OUTPUT 723;"TS;MKPK HI;" OUTPUT 723;"IF MKA,LT, 010.5DBM;THEN;TEXT @FAIL@ OUTPUT 723;"ELSIF MKA,GT,09.5DBM;THEN;TEXT @FAIL@;" OUTPUT 723;"ELSE TEXT @LEVEL OK.@;ENDIF;" Description Initialize analyzer. Activate single-sweep mode. Set pen position Set measurement range.
Language Reference IGEN IGEN Turn on the current source. NOTE This command is valid only if Option 001, current source, is installed. Item Description Range 6200 mA (but limited by IGENLIMIT) Preset State OFF Duty Cycle 0.
Language Reference IGEN Example Description 10 OUTPUT 723;"IGEN 0.100;" 20 OUTPUT 723;"IGEN ON;" The IGEN command turns on the optical spectrum analyzer's current source. The output of the source is available at the rear-panel CURRENT SOURCE connector. When using IGEN to set the current level of the source, enter current values in amperes. The current level applies for both steady state and pulsed operation. (Use IGENDTYCY or IGENPW to enter pulsed mode.
Language Reference IGENDTYCY IGENDTYCY Set the duty cycle of the current generator pulse mode. NOTE This command is valid only if Option 001, current source, is installed. Item Example Description Description Range 0|100% (but limited by IGENLIMIT) Preset State 100% 10 OUTPUT 723;"IGENDTYCY 50;" Set the duty cycle to 50%. The IGENDTYCY command selects the duty cycle of the optical spectrum analyzer's current source. The maximum current available at the output connector is limited by IGENLIMIT.
Language Reference IGENDTYCY Query Response See Also IGEN, IGENLIMIT, IGENPW 7-170
Language Reference IGENLIMIT IGENLIMIT Set safety limit on current source's output. NOTE This command is valid only if Option 001, current source, is installed. Item Range Preset State Example Description 6200 mA 650 mA 10 OUTPUT 723;"IGENLIMIT 0.10;" Description Set the limit to 6100 mA. The IGENLIMIT command sets an absolute limit for the current source. This limit protects a test device from damage if the current setting is too high.
Language Reference IGENLIMIT Query Response See Also IGEN, IGENDTYCY, IGENPW 7-172
Language Reference IGENPW IGENPW Set the pulse width of the current generator's pulse mode. NOTE This command is valid only if Option 001, current source, is installed. Item Example Description Range 1.0 Preset State 20 s s to 6.5 ms 10 OUTPUT 723;"IGENPW 1.
Language Reference IGENPW Description The IGENPW command selects the pulse width of the optical spectrum analyzer's current source. Use IGEN to turn on the current generator. Normally, the current source is set for a steady dc state. You can set the pulse width from 1.0 s to 6.5 ms. Use IGENDTYCY to set the pulse's duty cycle.
Language Reference INSTMODE INSTMODE Select optical spectrum analyzer measurement mode. Item Example Description Description Requirement HP 70951A module Preset State OSA 10 OUTPUT 723;"INSTMODE PRESEL;" The INSTMODE command selects the instrument's operating mode. For HP 71451B instruments all six of the following selections are available. On HP 71450B/2B instruments, only the OSA, SR, and PULSE selections are available: OSA (Optical Spectrum Analyzer).
Language Reference INSTMODE limited in order to select wide bandwidth and fast settling characteristics. One example of using this mode is measuring the signal-to-noise ratio (SNR) of EDFA systems by measuring the ampli ed spontaneous emission (ASE) level immediately (10 s) after the modulation is turned o . WARNING In PRESEL, SR, and PD modes, the input signal passes through the monochromator and is emitted from the front-panel's MONOCHROMATOR OUTPUT connector.
Language Reference INSTMODE NOTE In both SR and PD mode, the use of a broadband spontaneous emissions source is required. Examples of broadband sources include an LED or white-light source.
Language Reference INT Compute integer value(s) in source.
Language Reference INT Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example Source-Length Range 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference IP Perform an instrument preset which sets all functions to their preset state. Example Description 10 OUTPUT 723;"IP;" The IP command presets the analyzer settings placing the spectrum analyzer in a known state.
Language Reference IP Programming Commands A ected by Instrument Preset Command Preset State/Response Command Preset State/Response ACTPARM OFF GATESWP OFF ADCTRG OFF GRAPH Blank graphics trace. 2 s GRAT GRAT ON GRATEDSW FALSE GRATORDER AUTO GRID Blank grid. HD HD AMPCOR AUTO AMB OFF AMBPL OFF AMC OFF AMPCOR OFF IGEN OFF ANNOFF Annotation is reenabled after IP.
Language Reference IP Programming Commands A ected by Instrument Preset (continued) Command Preset State/Response Command Preset State/Response MKAR 0 MKBW OFF 03 dB ROFFSET SENS ROFFSET 0 SCALE 0,1000,0,1000 AUTO Change value. SNGLS OFF MKNOISE MKNOISE OFF SP Set to maximum measurement range. MKOFF Blank markers. SS Set to SPAN/10 MKAR MKBW MKBWA MKN SCALE MKREAD MKP 401, or center MKPAUSE 0 MXPX 3DB MKREAD AUTO MKT Change value.
Language Reference IT IT Assign a number to a series of graphics commands for future recall or modi cation. Item Example Description Item-Number Range 0 { 50, depending on model of display. Preset State IT 0 150 160 170 180 190 CLEAR 723 OUTPUT 723;"IP;" OUTPUT 723;"CLRDSP;" OUTPUT 723;"TRDSP TRA,OFF;" OUTPUT 723;"IT 1;VW OFF;" 200 210 220 230 240 250 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"TEXT$This is "; 723;"the contents of "; 723;"item 1.
Language Reference IT Description The IT command activates the reference-graphics mode by assigning a nonzero number to a series of graphics commands that form a shape. These shapes are called items. Use IT to blank, redraw, reshape, or reposition items. Graphics drawn when the reference-graphics mode is o cannot be modi ed at a later time. Execute IT 0 to turn the mode o . Manipulate an item by rst activating it with IT, then modify it with the commands listed in the following table.
Language Reference IT Query Response See Also CLRDSP, OR, SCALE, VW, TP, DELETE, PA, PR, PD, PU, GRAPH, GRID, TEXT, DSPLY, MK 7-185
Language Reference IWINDOW Change size (but not scale) of displayed measurement results. Item X-Length Range Y-Length Range Preset State Example Description See Also Description 032,768 { 32,767, in units set by SCALE command. 032,768 { 32,767, in units set by SCALE command. IWINDOW 1000,1000 120 OUTPUT 723;"IWINDOW 700,800;" De ne instrument window to be a 700 X 800 dimension in current scale units. Notice annotation disappears when there is not enough room to display it.
Language Reference KEYCLR KEYCLR Example Description See Also Clear keys currently accessed with 4USER5 key. 10 OUTPUT 723;"KEYCLR;" The KEYCLR command blanks the 4USER5 menu.
Language Reference KEYDEF Assign a label and user-de ned function to a 4USER5 key. Item Example Description Key-Number Range (softkeys) 1 { 14 Key-Number Range (keypad) 15 { 29 Key-Label Range 2 lines of up to 7 characters each. 10 20 30 40 7-188 OUTPUT OUTPUT OUTPUT OUTPUT 723;"FUNCDEF T_10,^"; 723;"CENTERWL 1300NM;"; 723;"SP 10NM^;" 723;"KEYDEF 7,T_10,%TEST%;" Create user-de ned function called T 10 FFFFFFFFFFFF De ne key, labeled TEST .
Language Reference KEYDEF Description The KEYDEF command creates a key that executes a user-de ned function. The key can be a softkey that is located in the 4USER5 menu, or it can be a key that is located on an unde ned custom keypad. The keys on the normal recognized keypad cannot be rede ned. Once a key is de ned, the user-de ned function is executed whenever the key is pressed. Error 2013 Error 2013 is displayed if a user-de ned function is called in a KEYDEF before the function is de ned and stored.
Language Reference KEYDEF Key Numbers for Softkeys A key on the custom keypad can only be assigned to a user-de ned function if the keypad is unrecognized by the display. If you attempt to rede ne the keys of a recognized keypanel, the built-in de nitions for the keypanel will still be used. There are 15 possible keypad keys labeled 15.through 29. The following gure shows the numbering of the keypad keys. There is no label annotation for USER keys 15 through 29.
Language Reference KEYDEF De ne all valid key presses If you're building key de nitions for a custom keypad, be sure to de ne all of the keypad positions which could be pressed by a key. For example, if a single key will be over both positions 15 and 18, both of these keypad positions should be de ned to be the same function. Query Response See Also Sends the name of the user-de ned function assigned to the key to the computer.
Language Reference KEYPST Preset 4USER5 keys to a default state. Example Description 10 OUTPUT 723;"KEYPST;"; Reset user-de ned keys to their preset values. Push 4LOCAL5 to view the 4USER5 keys. The KEYPST command resets the menu of keys that is accessed with the 4USER5 key to contain these three keys only: DEFINE USR KEY - De ne user-de ned key. NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN SAVE USER - Save menu of 4USER5 keys.
Language Reference LED LED Start the LED (light-emitting diode) laser characterization measurement DLP. Argument B C K L Q O ? De nition Turns on or o the view of the integration window trace. Turn on or o the view of the distribution trace. Select Gausian distribution. Select Lorenzian distribution. Exit the measurement DLP. Turn on or o calculations.
Language Reference LED Example Description 10 20 30 40 OUTPUT OUTPUT OUTPUT OUTPUT 723;"IP;"; 723;"LED_;"; 723;"LED_ K;"; 723;"LED_ Q;"; The LED command automatically measures characteristics of a light-emitting diode laser source. Refer to \Measuring Signals," in the Optical Spectrum Analyzer User's Guide for additional information. Query Response See Also Preset the instrument. Start the LED characterization measurement. Select Gausian distribution for the measurement results.
Language Reference LG LG Set the vertical logarithmic amplitude scale. Item 0.01 dB { 20 dB Step Increment 1,2,5,10 sequence Preset State LG 10DB Example Description Description Scale Range 40 OUTPUT 723;"LG 20DB;" 50 OUTPUT 723;"LG EP;" Set the log scale to 20 dB/division. Change the log scale with the front-panel keys.
Language Reference LIGHT Turn internal white light source on or o . NOTE This command is valid only if Option 002, white light source, is installed. Example Description 10 OUTPUT 723;"LIGHT WHITE ON;" Turns on white light source. The LIGHT command turns on or o the internal white light source. The output is available on the front panel. The query returns the current state, on or o .
Language Reference LIMIAMP LIMIAMP Example Description See Also Set the limit-line segment amplitude. 10 OUTPUT 723;"LIMIAMP -10DBM;" The LIMIAMP command sets the amplitude of the currently active limit-line segment. The query sends the amplitude value of the current segment.
Language Reference LIMIBEEP Sound a beep each time the currently measured trace data exceeds test limits. Item Preset State Description Description LIMIBEEP OFF The LIMIBEEP command sounds a beep when trace data exceeds limit line parameters during limit-line testing. See LIMILINE and LIMITEST for a description of limit lines and limit-line testing, and see LIMIFAIL for an alternative failure indicator. LIMIBEEP ON sounds a beep when a signal response fails the test limit as the sweep progresses.
Language Reference LIMIBOT LIMIBOT Example Description Activate the last segment of the limit-line table. 10 OUTPUT 723;"LIMIBOT;" The LIMIBOT command speci es that the last segment of the limit line become the active segment. The query sends the number of the last segment. If there are 12 segments, the number returned is 12.
Language Reference LIMIDEL Description See Also Erase the contents of the limit-line table. When testing with limit-line parameters that reside in traces, execution of LIMIDEL is required before storing these limit-line parameters in the LIMIT LO and LIMIT HI trace arrays.
Language Reference LIMIDONE LIMIDONE Example Description Turn o the limit-line editor. 10 OUTPUT 723;"LIMIDONE;" The LIMIDONE command turns o the limit-line editor which removes the limit-line table and editing softkeys from the display.
Language Reference LIMIEDIT Example Description Turn on the limit-line editor. 10 OUTPUT 723;"LIMIEDIT;" The LIMIEDIT command activates the limit-line editor.
Language Reference LIMIFAIL LIMIFAIL Example Description Query limit-line test results. 10 OUTPUT 723;"LIMIFAIL?;" Execute LIMITEST ON before executing LIMIFAIL. The LIMIFAIL command returns a number based on the condition of the sweep at the moment your query is sent. You may send the query at anytime during the sweep, there is no need to wait for the trace to complete.
Language Reference LIMIFAIL Query Response See Also LIMIAMP, LIMIBEEP, LIMIDEL, LIMIFREQ, LIMILINE, LIMIRCL, LIMIREL, LIMISDEL, LIMISEG, LIMITEST, LIMITYPE, and any commands a ecting trace data.
Language Reference LIMIHALF LIMIHALF Select upper or lower limit line for modi cation or creation. Item Preset State Example Description Description LIMIHALF UPPER 10 OUTPUT 723;"LIMIHALF ;" The LIMIHALF command selects for modi cation either the upper or lower limit line in the limit-line table. The LIMIHALF command works in conjunction with the following commands to de ne a limit line stored in the limit-line table: 1.
Language Reference LIMILINE Query the current limit-line parameters for future recall or build a new limit line. Item Range Description 1 to 400 segments, depending on available memory. If only 1 segment is entered, the segment type \POINT" is used. Example Description 10 OUTPUT 723;"LIMILINE 20;" The LIMILINE command initiates the process that loads new limit lines into the limit-line table.
Language Reference LIMILINE 1. LIMILINE clears the limit-line table, prepares it for data entry, and speci es the number of segments in a limit line. 2. LIMIHALF speci es whether the limit line is an upper or lower limit-line. 3. LIMISEG de nes the amplitude and wavelength characteristics of each of the limit-line segments. 4. LIMIREL determines whether the values of the limit line are absolute values or positioned relative to the reference-level and center-wavelength settings.
Language Reference LIMINEXT Example Description See Also Activate the next limit-line segment. 10 OUTPUT 723;"LIMINEXT;" The LIMINEXT command moves the active position from the current limit line segment to the next limit line segment. If the segment prior to executing this command was the last segment, the rst segment will become active.
Language Reference LIMIRCL LIMIRCL Recall stored limit line into limit-line table. Item Example Description Description Range 0 { 9999 Requirements To select storage location (HP-IB device, HP-MSIB device, or internal memory), execute MSI before executing LIMIRCL. Internal memory is the storage device when power is applied to the spectrum analyzer.) 10 OUTPUT 723;"LIMIRCL 2;" The LIMIRCL command recalls limit lines that have been stored previously by the LIMISAV command.
Language Reference LIMIREL Determine whether limit line values are absolute or relative. Item Preset State Example Description LIMIREL OFF 10 OUTPUT 723;"LIMIREL;" The LIMIREL command determines whether the wavelength and amplitude parameters in the limit-line table represent absolute values or relative values referenced to the reference-level and center wavelength settings. Executing LIMIREL OFF speci es limit-line table parameters as absolute values, and positions the limit line accordingly.
Language Reference LIMISAV LIMISAV Save contents of limit-line table in limit-line le for future recall. Item Range Example Description Description 0 { 9999 10 OUTPUT 723;"LIMISAV 2;" The LIMISAV command saves in user memory the contents of the limit-line table only. LIMISAV does not save limit lines that are present in the LIMIT HI or LIMIT LO trace array. (LIMIT HI and LIMIT LO are described under the LIMITEST command.) LIMISAV speci es a register number.
Language Reference LIMISCRL Example Description Query Response See Also Scroll the active limit-line segment from the current active segment. 10 OUTPUT 723;"LIMISCRL 19;" The LIMISCRL command scrolls the active limit-line segment from the current active segment. If there are a total of 15 segments and you enter the number 9 for segments to scroll, only 9 are scrolled.
Language Reference LIMISDEL LIMISDEL Example Description See Also Delete the currently active limit-line segment. 10 OUTPUT 723;"LIMISDEL;" The LIMISDEL command deletes the currently active limit-line segment.
Language Reference LIMISEG De ne slope and o set of limit-line segments. Item Range Description 1 to 400 segments, depending on available memory. If only 1 segment is entered, the segment type \POINT" is used. Example Description 10 OUTPUT 723;"LIMISEG;" The LIMISEG command speci es the characteristics of a limit line that is stored in the limit-line table. When creating new limit lines, execute LIMILINE, and LIMIHALF if necessary, before executing LIMISEG. A limit line is divided into segments.
Language Reference LIMISEG The segment type of the last segment of a limit line is not returned since the type parameter de nes how the segments are drawn (connected) to the next segment. The last segment does not have a \next" segment. If there are 10 segments, the segment type for the rst 9 is returned. The three segment types are: FLAT draws a zero-slope line between the beginning points of two segments, producing limit-line values equal in amplitude for all wavelengths between the two points.
Language Reference LIMITEST Compare active trace data to limit-line parameters. Item Preset State Example Description Description LIMITEST OFF 10 OUTPUT 723;"LIMITEST ON;" The LIMITEST command compares data in the currently sweeping trace to a limit line. A limit line must be stored in a table or trace before testing begins. (For a description of limit lines, refer to the LIMILINE command.) When in table form, the wavelength-amplitude characteristics reside in the limit-line table.
Language Reference LIMITEST 3. LIMISEG de nes the amplitude and wavelength characteristics of each of the limit-line segments. 4. LIMIREL determines whether the values of the limit line are absolute or are positioned relative to the reference-level and center wavelength settings. Next, execute LIMITEST ON and sweep the measurement range.
Language Reference LIMITEST Executing LIMITEST ON compares trace data to the line parameters stored in the LIMIT HI and LIMIT LO arrays. As before, during single-sweep mode, LIMITEST ON compares the limit line to trace A data only. Executing LIMITEST OFF erases the LIMIT HI and LIMIT LO trace arrays. Use the STOR command to save trace array contents in a le. Below, the LIMIT HI trace array is stored as a trace le called \LIMIT.
Language Reference LIMITYPE LIMITYPE Specify the type of limit-line segment. Item Preset State Example Description Description SLOPE 10 OUTPUT 723;"LIMITYPE SLOPE;" The LIMITYPE command speci es the type of the current limit-line segment to be either POINT, SLOPE, or FLAT. The query returns the current type or \NA" if not available. FLAT draws a zero-slope line between the beginning points of two segments, producing limit-line values equal in amplitude for all wavelengths between the two points.
Language Reference LIMITYPE Query Response See Also LIMIBOT, LIMIDEL, LIMIDONE, LIMIEDIT, LIMIHALF, LIMILINE, LIMINEXT, LIMIRCL, LIMISCRL, LIMISDEL, LIMISEG, LIMISEL 7-220
Language Reference LIMIWL LIMIWL Set the wavelength of the currently active limit-line segment. Item Range Example Description Description dependent on hardware 10 OUTPUT 723;"LIMIWL 600NM;" The LIMIWL command sets the wavelength of the currently active limit-line segment. The query sends the wavelength of the current segment.
Language Reference LIMIWL Query Response See Also LIMIBOT, LIMIDEL, LIMIDONE, LIMIEDIT, LIMIHALF, LIMILINE, LIMINEXT, LIMIRCL, LIMISCRL, LIMISDEL, LIMISEG, LIMISEL 7-222
Language Reference LIMTOCOR LIMTOCOR Transfer limit-line data to amplitude-correction data. Item Preset State Example Description See Also Description UPPER 10 OUTPUT 723;"LIMTOCOR UPPER;" The LIMTOCOR command transfers limit-line data to amplitude-correction data. Points stored as limit-line segments, which can also be edited via the front panel, are converted to amplitude-correction points and used as if entered with the AMPCOR command.
Language Reference LINES Connect lines between displayed trace points. Item Preset State Example Description Description ON 10 OUTPUT 723;"LINES OFF;" The LINES command connects or disconnects lines between the displayed trace points. When OFF is speci ed, displayed traces are shown as unconnected dots. The query sends the current state.
Language Reference LINET LINET Draw dots or dashed lines. Item Line-Type Range Example Description 10 20 30 40 OUTPUT OUTPUT OUTPUT OUTPUT Description null, 0 { 8 723;"CLRDSP;BLANK TRA;" 723;"PA 0,600;" 723;"LINET 6;" 723;"PD;PA 500,600;" Clear graphics from memory. Place graphics pen at (0,600). Activate dotted-line drawing. Place pen down and draw line to (500,600).
Language Reference LN Set vertical linear amplitude scale. Example Description See Also 10 OUTPUT 723;"LN;" The LN command activates the linear display mode. It scales the vertical divisions of the graticule proportional to the input power. The bottom graticule line represents a signal level of 0 watts and the top is determined by the reference level. MEASURE SR makes LN inactive.
Language Reference LOAD LOAD Load article or le into internal memory. Item Example Description Description Range 1 { 10 characters Delimiters Required before and after le name when it contains a number or lower-case letters. When le name is upper-case alpha characters only, delimiters are optional. 110 OUTPUT 723;"CLRW TRB;TS; 120 OUTPUT 723;"STOR T,$ALPHA$,TRB;" 130 OUTPUT 723;"LOAD $ALPHA$,TRC;" Sweep trace B. Store trace B in trace le called ALPHA. Load trace into trace C.
Language Reference LOAD Files containing trace data are loaded into the speci ed trace, or trace A if the destination is not speci ed. All instrument settings are changed to reproduce the state the spectrum analyzer was in when the trace was stored. In addition, the trace is placed in view mode. Files containing user-de ned variables, functions, traces, or keys are loaded into user memory. Any duplicate user-de ned articles over-write the existing versions.
Language Reference LOAD The PREFX command changes the le pre x for all les stored with SAVED, SAVES, SAVET, LIMISAV, and SAVEU. Thus, executing PREFX $MARCH$;SAVEU 10 stores a le called \uMARCH 10". Notice that the PREFX command inserts letters between the \u" and \ ". To verify le names, press State , recall , catalog & MSI to view the catalog of user memory, which is the currently selected storage device.
Language Reference LOG Take the logarithm, then multiply it by N. Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in 308 TRA, TRB, TRC, or user-de ned trace. 6 1.8 2 10 when using number, prede ned variable, or user-de ned variable. Source-Length Range 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference LOG Example Calculate the decibel value of a power ratio using the LOG command. 20 CLEAR 723 30 OUTPUT 723;"IP;" 40 OUTPUT 723;"VARDEF POWER,0;" 50 60 70 80 Description OUTPUT 723;"LOG POWER,5,10;" OUTPUT 723;"POWER?;" ENTER 723;N DISP USING "D.DD,K";N;"dB" Initialize analyzer. De ne user-de ned variable, called POWER, equal to 0 POWER = 10 2 LOG 5 Query value of power to computer. Assign value to computer variable. Display value on computer.
Language Reference MDS Specify binary data as one byte (B) or two bytes (W). Also specify number of signi cant gures. Item Example Description Scaling-Factor Range 0 { 16 Preset State MDS W Send trace data to computer as binary words (two 8-bit bytes).
Language Reference MDS Description The MDS command determines if binary data is transmitted as one byte or one word (two 8-bit bytes). In addition, MDS speci es the number of signi cant digits contained in the binary data. Use MDS to improve speed and economize on storage space in memory. Better throughput (speed) is achieved with MDS B, at the sacri ce of resolution and thus accuracy. During normal operation, trace data is provided in decimal form.
Language Reference MDS Query Response See Also TDF, FETCH 7-234
Language Reference MEAN MEAN Calculate the mean value of the amplitudes in the source. Item Source-Length Range Description 3 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC. Source-Amplitude Range 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, or user-de ned trace.
Language Reference MEAN Description The MEAN command calculates the mean value of the source. If a trace is used as the source, be sure it contains a complete sweep of measurement information. MEAN must be used as either a query or as a source in another analyzer-command function. Form a query by ending the MEAN statement with a question mark (?). When used as a query, MEAN sends the mean value of the source.
Language Reference MEASU MEASU Convert parameter units of amplitude to measurement units. Item Source-Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, or user-de ned trace. Reference-Trace Length Range 3 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference MEASU Example 10 20 30 40 50 60 Use the MEASU and POSU commands to position graphics on the analyzer display in measurement units and in position units. Initialize analyzer.
Language Reference MEASU Use the MEASU command to preserve decimal values. All trace amplitude information is stored internally and manipulated in measurement units. This means a 010 dBm reference-level value is converted to 01000 measurement units before it is transferred to a trace element. (Recall that a measurement unit is one hundredth of a decibel.
Language Reference MEASU Commands that May Require Conversion using MEASU Command 7-240 De nition ABS Compute absolute value. ADD Add sources, point by point. AVG Average source with destination, point by point. BIT Store value of bit. CONCAT Concatenate trace. DIV Divide sources, point by point, discard remainder. EXP Divide source by scaling factor and raise to power of 10. INT Compute integer value. LOG Compute logarithm. MEAN Compute mean value of data points.
Language Reference MEASU Prede nedFunction Syntax 7-241
Language Reference MEASU Query Syntax Query Response See Also ROFFSET, MEASURE, INZ, LN, LG, RL, AUNITS 7-242
Language Reference MEASURE MEASURE Select spectrum-analysis or stimulus-response mode. Item MEASURE SA Preset State Example Description Description 120 OUTPUT 723;"MEASURE SA;" The MEASURE command determines what kind of measurements the modular measurement system makes.
Language Reference MEASURE SRMILCPL Display line (DL) Threshold (TH) Marker amplitude (MKA) Reference level This argument is identical to the SR argument except that system gains are allowed to change. For example, gain can change due to changes in the reference level. Query Response When the INSTMODE command is set to PD or SR, MEASURE SR is automatically activated.
Language Reference MEM MEM Return amount of available internal memory. Example Determine how many trace arrays can t into available internal memory. 20 30 40 50 CLEAR 723 OUTPUT 723;"IP;" OUTPUT 723;"VARDEF TEMP,0;" OUTPUT 723;"DIV TEMP,MEM,846;" 60 OUTPUT 723;"INT TEMP,TEMP;" 70 OUTPUT 723;"MEM?;" 80 ENTER 723;N 90 OUTPUT 723;"TEMP?;" 100 ENTER 723;M Description Initialize analyzer. De ne user-de ned variable equal to 0.
Language Reference MEM Prede nedFunction Syntax Query Syntax Query Response See Also ACTDEF, AMPCOR, FUNCDEF, LIMILINE, LIMISAV, LOAD, NSTATE, ONEOS, PDA, PDF, RCLD, READMENU, REPEAT/UNTIL, SAVES, SAVET, SAVEU, STOR, TRDEF, USERERR, USERKEY, USERMSG, USTATE, VARDEF 7-246
Language Reference MIN MIN Compare two values or traces, then store lesser value or trace.
Language Reference MIN Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example Source-Length Range 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference MINH MINH Compare amplitude of current trace data to previous sweep, then retain lesser values. Example Description See Also 30 OUTPUT 723;"MINH TRA;" The MINH command (like the minimum hold function) and compares the current amplitude value of each point on a trace as it sweeps to each point value detected during the previous sweep, then retains the minimum values. The trace is continuously swept, updated, and displayed.
Language Reference MK Position a marker anywhere on the display. Item Example Description X-Coordinate Range Depends on SCALE or DWINDOW command. Y-Coordinate Range Depends on SCALE or DWINDOW command. 30 OUTPUT 723;"PD;MK 600,800;PU;" 40 OUTPUT 723;"IT 1;MK 700,700;" 7-250 Place pen down. Position marker at (600,800). Lift pen. Activate reference-graphics mode and assign MK to item 1. Position marker at (700,700).
Language Reference MK Description See Also The MK command positions a marker anywhere on the analyzer display. Use the PD command to rst place the pen down (except during reference-graphics mode.) Coordinates are speci ed in the current scale units, which are 0 to 1000 for the X and Y coordinates unless speci ed di erently with the SCALE command or with the DWINDOW command if a window is active. Use the MK command in conjunction with the PU and PD commands when the reference-graphics mode is o .
Language Reference MKA Query the amplitude of the current marker. Item Amplitude Range Example Description 6 300 dB Description Query amplitude of signal at marker. 40 50 60 70 OUTPUT OUTPUT OUTPUT OUTPUT 723;"SNGLS;" 723;"TS;" 723;"MKN;" 723;"MKA?;" Activate single-sweep mode. Sweep trace A. Display a marker at the center of the trace. Send marker amplitude to computer. In marker normal mode, the MKA? query places the marker at the center wavelength (CENTERWL) speci ed.
Language Reference MKA When relative-marker mode is activated with the MKAL or MKAR command, the MKA command speci es the amplitude di erence from the reference marker. When the vertical scale is in logarithmic mode, the amplitude units are in dBm; in linear mode, the amplitude units are in ratio, as indicated with the X in the syntax diagram. Query Response The MKA query gives the amplitude of the active marker.
Language Reference MKACT Select active marker. Item Example Description Description Marker-Number Range Integers, 1 { 5 Step Increment 1 Preset State MKACT 0 10 OUTPUT 723;"MKACT 5;" De ne marker #5 as the active marker. The MKACT command selects one of ve markers as the active marker. All ve markers can be displayed simultaneously, but only one can be active at a time. The active marker is highlighted and its number and position are notated at the upper right corner of the graticule.
Language Reference MKACT Query Response See Also If markers are o , MKACT sends a 0 to the computer.
Language Reference MKAL MKAL activates marker #2 and positions it on a trace relative to the amplitude of marker #1. Item Marker-Amplitude Range 6 300 dBm Step Increment 1 major scale division Preset State MKAL 0 Example 40 OUTPUT 723;"CENTERWL 1000NM;SP 500NM;TS;" 50 OUTPUT 723;"MKPK HI;" 60 OUTPUT 723;"MKAL -60DB;" Description Description Set measurement range. Sweep the analyzer. Set marker at highest signal peak. Set amplitude-left marker 60 dB below reference marker.
Language Reference MKAL Use MKAR with the MKAL and MKBW or MKBWA commands to simplify bandwidth measurements. If marker #1 is not displayed, MKAR positions it at the center of the trace. If more than one trace is displayed, MKAR positions marker #1 on the active trace or on trace A, B, or C, in that order; or marks the trace speci ed by MKTRACE. Update trace data after executing MKAR.
Language Reference MKAR MKAR activates marker #3 and positions it on a trace relative to the amplitude of marker #1. Item Marker-Amplitude Range 6 300 dBm Step Increment 1 major scale division Preset State MKAR 0 Example 40 OUTPUT 723;"CENTERWL 1000NM;SP 500NM;TS;" 50 OUTPUT 723;"MKPK HI;" 60 OUTPUT 723;"MKAR -3DB;" Description Description Set measurement range. Sweep the analyzer. Set marker at highest signal peak. Set amplitude-right marker 3 dB below reference marker.
Language Reference MKAR Use MKAR with the MKAL and MKBW or MKBWA commands to simplify bandwidth measurements. If marker #1 is not displayed, MKAR positions it at the center of the trace. If more than one trace is displayed, MKAR positions marker #1 on the active trace or on trace A, B, or C, in that order; or marks the trace speci ed by MKTRACE. Update trace data after executing MKAR.
Language Reference MKBW Display wavelength di erence between #2 and #3 markers. Item Description MKBW OFF Preset State Example 50 OUTPUT 723;"MKPK HI;" 60 OUTPUT 723;"MKAL 060DB;" 70 OUTPUT 723;"MKAR 060DB;" 80 OUTPUT 723;"MKBW ON;" 90 OUTPUT 723;"MKBW?;" Description Set marker at highest signal peak. Set amplitude-left marker 60 dB below reference marker. Set amplitude-right marker 60 dB below reference marker. Display wavelength di erence between amplitudeleft and amplitude-right markers.
Language Reference MKBW Display Bandwidth, On/O Syntax Prede nedFunction Syntax Query Syntax Query Response See Also A zero is returned after MKBW OFF is executed.
Language Reference MKBWA Display wavelength di erence X dB below marker peak. Item Example Description Description Preset State MKBWA 3DB Linear Mode Use bypass path; do not send number as dB units LOG Mode Use dB path; include dB with the number. 10 OUTPUT 723;"MKBWA 06DB;" 20 OUTPUT 723;"MKBWA ON;" 30 OUTPUT 723;"MKBW?;" Set amplitude markers 6 dB below marker peak. Display wavelength di erence between markers. Query wavelength di erence.
Language Reference MKBWA Query Response See Also MKBW 7-263
Language Reference MKCONT Example Description See Also Enable the sweep to continue past the marker. 10 OUTPUT 723;"MKCONT;" The MKCONT command enables the sweep to continue past the marker by turning o the MKSTOP command. Use the MKCONT command to reestablish normal sweeps after the MKSTOP command is used. MKSTOP stops the sweep from continuing past any displayed marker.
Language Reference MKCWL MKCWL Example Set center wavelength equal to wavelength at marker. 40 OUTPUT 723;"TS;" 50 OUTPUT 723;"MKN EP;" 60 OUTPUT 723;"MKCWL;" 70 OUTPUT 723;"TS;" Description See Also Sweep measurement range. Move the marker using the keypad, step keys, or knob. Press ACCEPT VALUE . Move marker to center wavelength. Sweep.
Language Reference MKD Position marker relative to reference marker, according to wavelength.
Language Reference MKD Example Use markers to nd the two highest signal levels displayed. 40 50 60 70 OUTPUT OUTPUT OUTPUT OUTPUT 723;"SNGLS;" 723;"STARTWL 600NM;STOPWL 850NM;" 723;"TS;" 723;"MKPK HI;" 80 OUTPUT 723;"MKD;" 90 OUTPUT 723;"MKPK NH;" Description See Also Activate single-sweep mode. Set measurement range. Sweep trace A. Place marker on highest signal peak. Activate the delta marker mode.
Language Reference MKDACT? Example Description Report which marker is the currently active delta marker. 100 OUTPUT 723;"MKDACT?;" The MKDACT? command reports the marker number of the currently active delta marker. The marker numbering is the same as for MKACT. If no delta marker is currently active, a value of 0 is returned.
Language Reference MKDREFA MKDREFA Sets a reference marker for a delta marker at a speci c amplitude. Marker position is not restricted to a trace point. Item Range Example Description 6300 dB 100 OUTPUT 723;"MKDREFA -23.5DB;" 110 OUTPUT 723;"MKDREFF 1300NM;" Description Set the marker's vertical position. Set the marker's horizontal position. The MKDREFA command, in conjuction with the MKDREFF command, positions the general reference marker anywhere on the display.
Language Reference MKDREFA Query Response See Also MKDREFF, MKA, MKWL 7-270
Language Reference MKDREFF MKDREFF Set the reference marker for a delta marker to a speci c wavelength (or time in zero span). Marker position is not restricted to a trace point.
Language Reference MKDREFF Example Description 100 OUTPUT 723;"MKDREFA -23.5DB;" 110 OUTPUT 723;"MKDREFF 1300NM;" The MKDREFF command, in conjuction with the MKDREFA command, positions the general reference marker anywhere on the display. This is in contrast to normal active markers which must reside upon a trace point. The MKDREFA command must be issued before the MKDREFF command. If the active marker is not displayed, MKDREFF places it at the speci ed wavelength.
Language Reference MKMIN MKMIN Example Description See Also Move displayed marker to lowest signal level in trace. 60 OUTPUT 723;"MKMIN;" Find lowest signal level. The MKMIN command moves the active marker to the minimum value detected. MKMIN operates on the displayed, active trace, or if more than one is displayed, it operates on trace A, B, or C, in that order; or on the trace speci ed by MKTRACE.
Language Reference MKN Position active marker on trace according to wavelength. Item Wavelength Range Example Description Description 600 nm|1700 nm 50 OUTPUT 723;"MKN 800NM;" Set marker at 800 nanometers. The MKN command places the active marker on a trace at the speci ed wavelength or, during zero span mode, at the speci ed time. If the position of the marker is not speci ed, MKN places it at the center of the trace.
Language Reference MKN If more than one trace is displayed, MKN marks the active trace, or marks trace A, B, or C, in that order; or marks the trace speci ed by MKTRACE. When MKN is turned OFF, the marker is turned o .
Language Reference MKNOISE Display or query noise bandwidth at marker. Item Preset State Example Description MKNOISE OFF Calculate the spontaneous emission power spectral density at the marker position. 10 CLEAR 723 20 OUTPUT 723;"IP;" 30 OUTPUT 723;"MKN EP;" Initialize analyzer. Display the active marker and position it in the noise using the front-panel controls. Press ACCEPT VALUE . Display the rms noise level at the marker. Query the noise level to the computer.
Language Reference MKNOISE Query Response See Also RB, VB, SMOOTH, VAVG, MKTRACE and commands that a ect amplitude, such as AMPCOR, RL, MEASURE 7-277
Language Reference MKOFF Example Description Turn o markers. 50 OUTPUT 723;"MKOFF;" Turn o all markers. Use the MKOFF command to turn o the active marker, or all markers. MKOFF erases the active marker. MKOFF ALL erases all markers.
Language Reference MKP MKP Position the active marker on a horizontal trace in position units. Item Range Example Description Query Response Description 1 { 2048 Query the position of a marker in position units. 20 OUTPUT 723;"MKP 1;" Position marker at rst trace point. The MKP command positions the active marker on a trace horizontally in position units. Position units describe the position of a point along the horizontal axis of a trace.
Language Reference MKP See Also MKTRACE 7-280
Language Reference MKPABS MKPABS Sets the current active marker to the bucket requested even in delta marker mode. Item Range Example Description Description 0 to 2047 100 OUTPUT 723;"MKPABS 431;" The MKPABS command sets a marker to an absolute bucket. If the value is larger than the current trace length, the marker will be placed on the last trace point.
Language Reference MKPABS Query Response See Also MKFABS 7-282
Language Reference MKPAUSE MKPAUSE Pause the sweep at the displayed active marker for the speci ed length of time. Item Example Description Description Time Range 0 { 1000 seconds Step Increment 1, 3, 10 sequence Preset State MKPAUSE 0 30 OUTPUT 723;"TS;" 40 OUTPUT 723;"MKN;" 50 OUTPUT 723;"MKPAUSE 1.3S;" (o ) Sweep trace A. Display active marker. Pause sweep for 1.3 seconds at marker. The MKPAUSE command pauses the sweep at the displayed active marker for the speci ed length of time.
Language Reference MKPAUSE Query Response See Also MKOFF 7-284
Language Reference MKPITX MKPITX Control the excursion value for marker pit operations. Item Example Description Description Pit-Excursion Range 0.01 { 300 dB Step Increment 1 scale division during log mode. 1 scale division at top graticule line (.915 dB) during linear mode. Preset State MKPITX 3DB 100 OUTPUT 726;"MKPITX 6DB;" Set the pit excursion value to 6dB.
Language Reference MKPITX Note that if the pit excursion is too small, noise pits are identi ed as pits. Use VAVG or SMOOTH to minimize noise pits so that signal peaks can be distinguished from noise pits.
Language Reference MKPK MKPK Example Position active marker at a peak (or pit) on the trace. 30 40 50 60 OUTPUT OUTPUT OUTPUT OUTPUT 723;"SNGLS;" 723;"STARTWL 600NM;STOPWL 1700NM;" 723;"TS;" 723;"MKPK HI;" 70 OUTPUT 723;"MKD;MKPK NH;" 80 OUTPUT 723;"MKPK NR;" Activate single-sweep mode. Set measurement range. Sweep the measurement range. Move the active marker to the highest signal level (amplitude) on the trace. Move the delta marker to the next highest signal level on the trace.
Language Reference MKPK Description The MKPK command parameters reposition the active marker on the trace as follows: Argument CP CPIT HI HIP De nition Moves the displayed, active marker to the closest peak. Select the closest pit. Moves the active marker to the highest point on the trace. Move the displayed, active marker to the highest peak (as opposed to the highest point). Select the minimum peak (this is NOT the same as the minimum MI point, which is selected by MKMIN).
Language Reference MKPX MKPX Select minimum signal excursion for peak signal identi cation. Item Example Description Peak-Excursion Range 0.01 { 300 dB Step Increment 1 scale division during log mode. 1 scale division at top graticule line (.915 dB) during linear mode. Preset State MKPX 3DB Set the marker-peak excursion to 20 dB, so that only very large signal excursions are recognized by the marker-peak and signal-identi cation functions.
Language Reference MKPX The default peak-excursion value is 3 dB for signals displayed on a logarithmic scale. This means that any signal with an excursion of less than 3 dB on either side of its bandwidth shape is not identi ed as a signal. If the marker-peak command, MKPK HI, is executed on such a signal, the analyzer does not place a marker at the signal peak.
Language Reference MKREAD MKREAD Select the active trace information type displayed by the marker readout. Item Preset State Example Description Description MKREAD AUTO 10 OUTPUT 723;"TS;MKN;" 20 OUTPUT 723;"MKREAD WLN;" Sweep. Activate marker. Display wavelength at marker position. The MKREAD command selects the type of active trace information displayed by the marker readout and queried with the MKWL?, MKT?, and MKA? commands.
Language Reference MKREAD Marker Readout Information Command Argument Contents of Marker Readout Wavelength Query (MKWL?) Time Query (MKT?) Amplitude Query (MKA?) WLN Wavelength at marker position Gives wavelength at marker position Gives marker position in units of sweep time (marker sweep time) Gives marker amplitude FRQ Frequency at marker position Gives frequency marker position Gives marker position in units of sweep time (marker sweep time) Gives marker amplitude PER Marker period (e
Language Reference MKRL MKRL Move the active marker to the reference level. Example Description 50 60 70 80 OUTPUT OUTPUT OUTPUT OUTPUT 723;"SNGLS;TS;" 723;"MKPK HI;" 723;"MKRL;" 723;"TS;" Sweep trace A. Place marker at highest signal. Set reference level equal to marker amplitude. Sweep new measurement range. The MKRL command sets the reference level equal to the amplitude of the displayed active marker. Update trace data after executing MKRL.
Language Reference MKSP Set span equal to wavelength di erence of markers. Example 60 70 80 90 OUTPUT OUTPUT OUTPUT OUTPUT 723;"SNGLS;TS;" 723;"MKN;MKPK HI;" 723;"MKD;" 723;"MKPK NH;" 100 OUTPUT 723;"MKSP;TS;" Description See Also Activate single-sweep mode. Mark the highest point on the trace. Activate the delta marker. Move the delta marker to the second highest peak. Set the span equal to the wavelength di erence between the markers.
Language Reference MKSS MKSS Set center-wavelength step size equal to the wavelength di erence between delta markers. Example 30 OUTPUT 723;"STARTWL 600NM;STOPWL 800NM;" 40 OUTPUT 723;"MKN EP;" Set measurement range. Move marker to fundamental, using front-panel knob, then press ACCEPT VALUE key. Move the marked signal to the center of the display. Turn on delta marker. Move the marker to the next highest peak. Set the center-wavelength step size equal to the delta marker wavelength separation.
Language Reference MKSTOP Example Description See Also End the sweep at the current active marker. 10 OUTPUT 723;"MKSTOP;" The MKSTOP command ends the sweep at the current active marker instead of at the end of the trace when in continuous sweep mode. Sweep time can be reduced by not sweeping past the marker. The next sweep starts the trace over.
Language Reference MKT MKT Position marker in units of time. Item Example Description Description Marker-Time Range 6 1000 seconds Step Increment 1 major horizontal scale division. 30 OUTPUT 723;"SP 0;SNGLS;TS;" 40 OUTPUT 723;"MKN;" 50 OUTPUT 723;"MKT?;" Set measurement range to zero span. Display active marker. Query value of the marker position, in units of time. Use the MKT command during zero span mode.
Language Reference MKT Query Response See Also MKREAD, SP 7-298
Language Reference MKTRACE MKTRACE Position the active marker on the speci ed trace. Item Preset State Example Description Description MKTRACE TRA 10 OUTPUT 723;"MKTRACE TRB;" Move the marker to trace B. The MKTRACE command moves the displayed, active marker to the speci ed trace.
Language Reference MKTRACK Maintain the marked signal at center frequency. Item Preset State Example Description 50 OUTPUT 723;"MKPK HI;MKTRACK ON;" 60 OUTPUT 723;"SP 100NM;" 70 OUTPUT 723;"MKTRACK OFF;" Turn on marker tracking. Reduce the span. Turn o marker tracking. The MKTRACK command keeps the active marker and the point it marks at the center of the display during changes in wavelength span.
Language Reference MKTUNE MKTUNE Example Description Fix tune the optical spectrum analyzer to a speci ed wavelength. 10 OUTPUT 723;"MKTUNE 850NM;" The MKTUNE command places the optical spectrum analyzer in single sweep and tunes to the speci ed wavelength. A marker is also activated at the wavelength. NOTE If INSTMODE is not set to PRESEL, MKTUNE generates an error message.
Language Reference MKTUNE Query Response See Also INSTMODE 7-302
Language Reference MKTV MKTV Specify amplitude variance monitored by the marker-tracking function. Item Example Description Tracking-Variance Range 0 { 300 dB Step Increment 1 major vertical scale division during log mode. 1 major vertical scale division at top graticule line (.915 dBm) during linear mode.
Language Reference MKTV Query Response See Also MKTRACK 7-304
Language Reference MKTYPE MKTYPE Example Description Return the type of active marker. 30 OUTPUT 723;"MKN;" 40 OUTPUT 723;"MKTYPE?;" 50 ENTER 723;A$ Activate normal marker. Send marker type to computer. Assign response to computer variable.
Language Reference MKTYPE Query Response 7-306
Language Reference MKWL MKWL Position active marker according to wavelength, or return the marker wavelength. Item Range Example Description Description 600 nm to 1700 nm 10 OUTPUT 723;"MKWL 750NM;" For wavelength spans greater than zero, the MKWL command returns the wavelength of the active marker. MKWL can also return the wavelength di erence between the reference and delta marker when the relative-marker mode has been activated by the MKD command.
Language Reference MKWL displayed, MKWL marks the active trace, or marks trace A, B, or C, in that order; or marks the trace speci ed by MKTRACE.
Language Reference MOD MOD Retain remainder after division.
Language Reference MOD Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 61.8 2 10308 when using number, prede ned variable or user-de ned variable. Zero not allowed for source 2. Example Source-Length Range 1 { 2048 position units.
Language Reference MODADD MODADD Return the HP-MSIB address of the speci ed slave module. Item Reference-Number Range Example Description Description 1 to hardware limit 30 OUTPUT 723;"MODADD?;" 40 ENTER 723;N,M,O,P,Q,R,S,T Query HP-MSIB address of all modules. Assign row and column addresses to computer variables. The MODADD command returns the HP-MSIB address of the speci ed slave module. The HP-MSIB address corresponds to a module position in the address map.
Language Reference MODADD Query Syntax Query Response Row or Column is Returned Complete HP-MSIB Addresses are Returned 7-312
Language Reference MODID MODID Identify module or instrument at HP-MSIB address. Item Example Description Row Range Integers, 0 { 7 Column Range Integers, 0 { 31 Restrictions MODID 0,31 50 OUTPUT 723;"MODID M_OD,23?;" 60 ENTER 723;N 70 OUTPUT 723;"M_OD?;" 80 ENTER 723;M is illegal Query model number of module at HP-MSIB address M OD,23 (row=M OD, column=23). Assign model number to N. Query value of M OD, which is the row number. Assign row number to computer variable.
Language Reference MODID Description The MODID command identi es the modular spectrum analyzer module or instrument located at the speci ed HP-MSIB address. MODID must be used as either a query or as a source in another analyzer-command function. Form a query by ending the MODID statement with a question mark (?). When used as a query, MODID sends the model number of the module at the speci ed HP-MSIB address to the computer.
Language Reference MODID Query Response The model number less any alpha-character pre x or su x is sent. If no module is present or the address is not within the optical spectrum analyzer's control area (slave area), a 0 is given. Alpha characters are converted as follows: A B C D E becomes becomes becomes becomes becomes .0 .1 .2 .3 .4 F becomes .5 T becomes .6 H becomes .7 I becomes .8 J becomes .
Language Reference MOV Transfer value of trace, variable, or number to a trace or variable. Item Description Source-Length Range 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC. Truncated if longer than destination length. If shorter than destination length, last element is extended for operation. Destination-Length Range 1 { 2048 position units.
Language Reference MOV Example Position a signal peak at the display line. 20 OUTPUT 723;"SNGLS;" 30 OUTPUT 723;"STARTWL 600NM;STOPWL 1700NM;" 40 OUTPUT 723;"TS;MKPK HI;" 50 OUTPUT 723;"DL ON;" 60 OUTPUT 723;"MOV DL,MKA;" Destination Activate single-sweep mode. Set measurement range. Sweep trace A. Place a marker at the highest signal level detected. Turn on the display line.
Language Reference MPY Multiply sources and store in the destination.
Language Reference MPY Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example Description Source-Length Range 3 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference MSG Return the characters displayed in the message area. Example 40 OUTPUT 723;"MSG?;" 50 ALLOCATE Message$[40] 60 ENTER 723 USING "-K";Cal,Cor,Msg$ 70 80 90 100 Description PRINT IF Cal THEN PRINT "uncalibrated" IF Cor THEN PRINT "uncorrected" PRINT Msg$[3] Query the message to the computer. Create computer array (string) for storage of character message. Assign the messages to two Boolean variables and one string.
Language Reference MSG Query Response See Also USERMSG 7-321
Language Reference MSI Select location for storing les: HP-IB device, HP-MSIB device, or internal memory. Item Description Description HP-IB Address Range 0 { 7 Drive-Unit Range 0 { 9 Volume Range 0 { 9 HP-MSIB Address Range 0 { 255 When power is applied to the spectrum analyzer, internal memory is selected. The IP command does not change the MSI selection. INT selects internal memory. HPIB selects external memory that is located on HP-IB, such as a disk drive.
Language Reference MSI MSIB selects external memory that is located on the HP-MSIB, such as a memory card. The MSI command indicates the HP-MSIB address of the device. The default address is the HP-MSIB address of the display (for example, the HP 70004) connected to the spectrum analyzer. New addresses must be speci ed as a single number. Since most storing devices are at row-address 0, the number that MSI speci es is the column address.
Language Reference MXM Compare traces and variables, then store greater values.
Language Reference MXM Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 32,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 0 61.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example 40 50 60 70 80 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT Source-Length Range 1 { 2048 position units.
Language Reference MXMH Activate maximum hold. Item Preset State Example Description See Also Description Inactive 40 OUTPUT 723;"MXMH TRA;" Write data into trace A. The value of the incoming data is compared with the current data, then the maximum of the two is placed in trace A. The MXMH command compares the current amplitude value of each point on a trace to each corresponding value detected during the previous sweep, then retains the maximum values.
Language Reference NORM NORM Example Description Query Response Controls trace normalization for stimulus-response measurements. 100 OUTPUT 723;"NORM ON;" The NORM command turns on trace normalization. When trace normalization is turned on, its operation depends on whether a logarithmic or linear display is selected. With logarithmic displays, AMB ON is executed, and the reference level is set to 0 dB.
Language Reference NORM See Also MEASURE, SRINPUT 7-328
Language Reference NSTATE NSTATE Set number of state registers. Item Number Range Example Description Description 0 to value limited by available memory, or maximum of 20. 10 OUTPUT 723;"PSTATE OFF;" 20 OUTPUT 723;"NSTATE 0;" Deactivate state-register protection. Specify 0 registers, erasing contents of all registers. The NSTATE command allocates user memory for the storage of state-register les.
Language Reference NSTATE To select storage location (HP-IB device, HP-MSIB device, or internal memory), execute MSI before executing NSTATE. Internal memory is the storage device when power is applied to the spectrum analyzer.
Language Reference ONEOS ONEOS De ne list of functions executed at the end of the sweep. Item Example Description Delimiters Mark the beginning and end of the algorithm. Preset State ONEOS OFF Automatically measure a new wavelength range with each sweep.
Language Reference ONEOS Description The ONEOS command executes the algorithm in the data eld when the sweep, trace processing, and other internal end-of-sweep functions are completed. The ONEOS algorithm is user-de ned and consists of other analyzer commands, much like the user-de ned functions created with the FUNCDEF command. The algorithm is stored in internal memory. Each time the sweep is completed, the algorithm is executed.
Language Reference ONMENU ONMENU De ne list of functions executed when 4MENU5 is pressed. Item 10 20 30 Example Description Delimiters Mark the beginning and end of the algorithm. Preset State OFF OUTPUT 723;"ONMENU |;" OUTPUT 723;"TITLE &MENU key pressed.&;" OUTPUT 723;"|;" Begin de nition of on-menu-keypress algorithm. Set title. End on-menu-keypress algorithm.
Language Reference ONMENU Description The ONMENU command executes the algorithm in the data eld when internal 4MENU5 key functions are completed. The ONMENU algorithm is user-de ned and consists of other analyzer commands, much like the user-de ned functions created with the FUNCDEF command. The algorithm is stored in internal memory. DISPOSE ONMENU and FORMAT delete the on-menu-keypress algorithm from internal memory. Command parameters are as follows: ONMENU ON or ONMENU 1 activates the algorithm.
Language Reference ONMKR ONMKR De ne list of functions executed when sweep reaches pause marker. Item Example Description Delimiters Mark the beginning and end of the algorithm. Preset State OFF 10 OUTPUT 723;"ONMKR |;" 20 OUTPUT 723;"TITLE &Reached marker.&;" 30 OUTPUT 723;"|;" Begin de nition of on-marker-pause algorithm. Set title. End on-marker-pause algorithm.
Language Reference ONMKR Description The ONMKR command executes the algorithm in the data eld when internal marker functions are completed. MKPAUSE must be set to a non-zero time. The ONMKR algorithm is user-de ned and consists of other analyzer commands, much like the user-de ned functions created with the FUNCDEF command. The algorithm is stored in internal memory. Each time the sweep reaches the marker, the algorithm is executed.
Language Reference ONUSER ONUSER De ne list of functions executed when 4USER5 is pressed. Item 10 20 30 Example Description Delimiters Mark the beginning and end of the algorithm. Preset State OFF OUTPUT 723;"ONUSER |;" OUTPUT 723;"TITLE &USER key pressed.&;" OUTPUT 723;"|;" Begin de nition of on-user-keypress algorithm. Set title. End on-user-keypress algorithm.
Language Reference ONUSER Description The ONUSER command executes the algorithm in the data eld when internal 4USER5 key functions are completed. The ONUSER algorithm is user-de ned and consists of other analyzer commands, much like the user-de ned functions created with the FUNCDEF command. The algorithm is stored in internal memory. Each time the 4USER5 key is pressed, the algorithm is executed. DISPOSE ONUSER and FORMAT delete the on-user-keypress algorithm from internal memory.
Language Reference ONWINDOW ONWINDOW De ne list of functions executed when display window is recreated. Item 10 20 30 Example Description Delimiters Mark the beginning and end of the algorithm. Preset State OFF OUTPUT 723;"ONWINDOW |;" OUTPUT 723;"TITLE &Redrawing window.&;" OUTPUT 723;"|;" Begin de nition of on-window-recreation algorithm. Set title. End on-window-recreation algorithm.
Language Reference ONWINDOW Description The ONWINDOW command executes the algorithm in the data eld when the analyzer display needs to be redrawn. The ONWINDOW algorithm is user-de ned and consists of other analyzer commands, much like the user-de ned functions created with the FUNCDEF command. The algorithm is stored in internal memory. Each time the display is redrawn, the algorithm is executed. DISPOSE ONWINDOW and FORMAT delete the on-window-recreation algorithm from internal memory.
Language Reference OP OP Return coordinates of instrument window. Example Description 110 OUTPUT 723;"OP?;" 120 ENTER 723;P1x,P1y,P2x,P2y Query coordinates of P1 and P2. Assign values to computer variables. The OP command queries the values of P1 and P2 for the current instrument window scale. For the default instrument window, the X and Y coordinates for P1 and P2 are (112,16) and (911,383). P1 corresponds to the lower-left vertex. P2 corresponds to the upper-right vertex.
Language Reference OPTSW Example Description Activate the front-panel MONOCHROMATOR OUTPUT and PHOTODETECTOR INPUT ports. 10 OUTPUT 723;"OPTSW INT;" The OPTSW command selects the signal path on HP 71451B instruments (HP 70951B modules). The INT argument selects the normal signal path through the optical spectrum analyzer's monochromator to the photo diode for detection. The EXT argument makes the monochromator's output available at the front panel's MONOCHROMATOR OUTPUT connector.
Language Reference OR OR Set position of origin. Item Example Description X-O set Range Determined by Y-O set Range Determined by Preset State OR 0,0 SCALE SCALE or or DWINDOW. DWINDOW. Position a grid. 10 OUTPUT 723;"TRDSP TRA,OFF;" 20 OUTPUT 723;"CLRDSP;" 30 OUTPUT 723;"OR 100,200;" 40 OUTPUT 723;"PD;GRID 20,40,5,10;" Turn o trace A. Clear graphics from memory. Locate origin at 0,0 (lower-left corner). Set the units for the X and Y scale to their preset values, 0 to 1000.
Language Reference OR 10 OUTPUT 723;"CLRDSP;" 20 OUTPUT 723;"OR 100,500;" 30 OUTPUT 723;"DWINDOW 100,500,TRA;" 40 OUTPUT 723;"PD;GRAPH TRA;" 50 PAUSE 60 OUTPUT 723;"DWINDOW OFF;" Clear graphics from memory. O set the origin 100 units horizontally and 500 units vertically. De ne a graphics window, scaled to traceA parameters. Draw trace A inside the window. Observe display, then press CONTINUE on computer keyboard. Turn o the window. Position a graphics item.
Language Reference OUTPUT OUTPUT Control HP-IB with the analyzer as the controller. Item Address Range Example Description Integers, 0 { 30 Use the analyzer as a controller on HP-IB. In the example, the controlled HP-IB device is an HP 3478 multimeter at address 25. Press the user-de ned key, VDM , to communicate with the multimeter. NNNNNNNNNNN 150 160 170 180 REMOTE 7 CLEAR 723 OUTPUT 723;"IP;" OUTPUT 723;"VARDEF NN,0;" Place all devices in remote status.
Language Reference OUTPUT 190 OUTPUT 723;"FUNCDEF VDM,^"; 200 OUTPUT 723;"OUTPUT 25,K,$H5$;"; 210 OUTPUT 723;"ENTER 25,K,NN;"; 220 230 240 250 260 270 280 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"CLRDSP;"; 723;"PA 400,500;"; 723;"MPY NN,NN,1000;"; 723;"DSPLY NN,7,4;"; 723;"RELHPIB;"; 723;"^;" 723;"KEYDEF 7,VDM,$VDM$;" 290 SEND 7;UNL UNT DATA 300 LOCAL 723 Begin de nition of user-de ned function, called VDM. Send message, \H5" to multimeter. Receive value in amperes from multimeter.
Language Reference OUTPUT Execute RELHPIB to discontinue analyzer control of HP-IB. HP-IB Address speci es the address of the device. Format formats the data as follows: K sends characters (ASCII) with no terminator. KC sends characters (ASCII), followed by carriage-return/line-feed (ASCII codes 13 and 10). KL sends characters (ASCII), followed by line-feed (ASCII code 10) and END (end-or-identify). F sends data as ASCII-decimal numbers.
Language Reference OVRW Example Description Enable clear-write mode, but skip the initial clear. 100 OUTPUT 723;"OVRW TRA;" Set this mode for trace B. The action of OVRW is identical to CLRW except that OVRW does not initially clear the internal representation of the trace (the display is still cleared).
Language Reference PA PA Move pen to absolute coordinate. Item Example Description X-Coordinate Range Determined by Y-Coordinate Range Determined by SCALE SCALE 140 OUTPUT 723;"PA PU 0,0;" 150 OUTPUT 723;"PA PD 1000,1000;" 160 OUTPUT 723;"PU;PA 0,1000;" 170 OUTPUT 723;"PD;PA 1000,0;" or or DWINDOW DWINDOW Move the pen in the up position to (0,0). Move the pen in the down position to (1000,1000), drawing a diagonal line. Place pen up and move it to (0,1000).
Language Reference PA Description See Also The PA command moves the graphics pen from its current position to the position speci ed. A line is drawn on the analyzer display if the pen is down. Use the LINET command to vary the type of line drawn. Positions are speci ed as coordinates in the current units, which are set by the SCALE command, or by the DWINDOW command when a graphics window is on.
Language Reference PAUSE PAUSE Example Stop program operation and activate debug mode. 150 OUTPUT 723;"CENTERWL 750NM;" 160 OUTPUT 723;"PAUSE;" 170 OUTPUT 723;"SP 100NM;" Description Set center wavelength. Press CONT key on spectrum analyzer to resume program operation. Set span. FFFFFFFFFFFF The PAUSE command stops program operation until one of the following occurs: The CONT softkey is pressed. NNNNNNNNNNNNNN The 4 5 or 4 5 key is pressed. DEBUG OFF is executed.
Language Reference PD Place the graphics pen down. Item Preset State Example Description See Also 160 170 180 190 200 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT Description Deactivated, pen up 723;"CLRDSP;" 723;"BLANK TRA;" 723;"ANNOT OFF;" 723;"PU;PA 400,400;" 723;"PD;PA 1000,0;" Clear graphics from memory. Blank trace A. Blank annotation. Pen up. Move pen to (400,400). Place pen down. Draw line to (1000,0).
Language Reference PDA PDA Analyze distribution of detected signals according to amplitude. Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, or user-de ned trace. Resolution Range Limited by source amplitude. Source-Length Range 3 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference PDA Example Description Perform amplitude distribution function on trace A. 90 OUTPUT 723;"SNGLS;TS;" 100 110 120 130 OPTION OUTPUT OUTPUT OUTPUT 140 150 160 170 180 190 DIM A(20) OUTPUT 723;"NN?;" ENTER 723;A(*) FOR I=1 TO 20 PRINT A(I) NEXT I BASE 1 723;"TRDEF NN,20;" 723;"MOV NN,0;" 723;"PDA NN,TRA,5;" Activate single-sweep mode. Clear-write trace A. Specify lower boundary of arrays to be 1. De ne user-de ned trace of 20 elements, NN. Store 0 in all elements of trace array.
Language Reference PDA If the source trace is displayed on a linear scale, a resolution parameter of 5 divides the amplitude range into 20 increments of 500 measurement units each (5% of 10,000 is 500). The PDA function assumes the amplitude range of the source trace represents displayed trace data. If the source trace is displayed on a logarithmic scale, the amplitude range is 100 dB. If the source trace is displayed on a linear scale, the amplitude range is 10,000 measurement units.
Language Reference PDL Start the PDL downloadable program and loads the related commands. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit.
Language Reference PDL Description See Also The PDL command runs the swept Polarization Dependent Loss measurement procedure which requires the following steps: 1. Set the start and stop wavelengths. 2. Set the resolution bandwidth (RB) and perform an auto-scale, as needed. 3. Set the video bandwidth (VB) as needed.
Language Reference PDLCALC Perform calculation and display polarization dependent loss. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. Example Description See Also 220 OUTPUT 723;"PDLCALC;" Perform PDL calculation and display results. The PDLCALC command calculates the peak-to-peak polarization dependent loss and displays the result. After the calculation is performed, the measurement is stopped and the result is displayed as trace A.
Language Reference PDLDEV PDLDEV Toggle between the internal or external detector. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. Item Preset State Example Description See Also Description external 10 OUTPUT 723;"PDLDEV;" Toggles the receive device. The PDLDEV command toggles the receive device between either the internal or an external detector thus selecting either optical-to-optical testing or optical-to-electrical testing.
Language Reference PDL DEV? Query the selected detector. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. Example Description 10 OUTPUT 723;"PDL_DEV?;" Query the receive device. The PDL DEV? query returns the current status value of the receive device to be either internal (0) or external detector (1).
Language Reference PDLEXIT PDLEXIT Terminate PDL measurement procedure. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. Example Description See Also 280 OUTPUT 723;"PDLEXIT;" Terminate PDL program. The PDLEXIT command terminates the polarization dependent loss (PDL) measurement program.
Language Reference PDLINIT Initialize PDL measurement. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. Example Description See Also 180 OUTPUT 723;"PDLINIT;" 190 PRINT "Press RETURN to Continue"; 200 PAUSE; Initialize PDL measurement. The PDLINIT command initializes the polarization dependent loss (PDL) measurement procedure.
Language Reference PDLREV PDLREV Display PDL revision number. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. Example 10 OUTPUT 723;"PDLREV;" Display the PDL revision number. Description The PDLREV command displays the polarization dependent loss (PDL) measurement program revision number.
Language Reference PDL REV? Return PDL revision number. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. Example Description 10 OUTPUT 723;"PDL_REV?;" Return the PDL revision number. The PDL REV? query returns the polarization dependent loss (PDL) measurement program revision number.
Language Reference PDLSCALE PDLSCALE Auto-scale displayed signal during PDL measurement. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. Example Description 240 OUTPUT 723;"PDLSCALE;" Perform auto-scale. The PDLSCALE command automatically scales the displayed signal during a polarization dependent loss (PDL) measurement.
Language Reference PDLSCALE See Also PDL , PDLINIT, PDLCALC, PDLDEV, PDL DEV?, PDLEXIT, PDLREV, PDL REV?, PDLSRC, PDL SRC? 7-366
Language Reference PDLSRC PDLSRC Toggle the light source on and o . NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. This also requires Option 002 built-in white light source. Item Preset State Example Description 120 130 140 150 160 Description on OUTPUT 723;"PDL_SRC?;" ENTER N; IF N=0 THEN OUTPUT 723;"PDLSRC;" END IF Return light source status. Turn light source on, if light source is o .
Language Reference PDLSRC Query Response See Also PDL , PDLINIT, PDLCALC, PDLDEV, PDL DEV?, PDLEXIT, PDLREV, PDL REV?, PDLSCALE, PDL SRC? 7-368
Language Reference PDL SRC? PDL SRC? Return light source status. NOTE Only for use with HP 71451B Option 003, Swept Polarization Dependent Loss (PDL) Kit. Example Description 120 130 140 150 160 OUTPUT 723;"PDL_SRC?;" ENTER N; IF N=0 THEN OUTPUT 723;"PDLSRC;" END IF Return light source status. Turn light source on, if light source is o . The PDL SRC? query returns the light source status, where 0 indicates o and 1 indicates on.
Language Reference PDMEAS Measure the atness of a photodiode under test. NOTE This command is only available for systems using the HP 70951A module. Before the command is executed, perform the following steps: 1. Connect the front-panel MONOCHROMATOR OUTPUT to the PHOTODETECTOR INPUT with a ber-optic cable. 2. Press STORE THRU -> B . NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN 3. Connect the ber-optic cable to the photodiode under test which is connected to TRANS0Z IN on the rear panel.
Language Reference PDMEAS Example Description See Also 100 110 120 130 140 150 160 CLEAR 723 OUTPUT 723;"IP;" PRINT "STORE REFERENCE TRACE" OUTPUT 723;"STORREF THRU;" PRINT "HIT RETURN TO CONTINUE" PAUSE OUTPUT 723;"PDMEAS ON;" Initialize analyzer. Initiate photodiode atness measurement. The PDMEAS command is used to measure the atness of an external photodiode. The diode- atness correction factors are not included in the atness correction.
Language Reference PDWL Analyze distribution of detected signals according to wavelength. Item Description Source or Destination Amplitude Range 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, 32,768 { +32,767 measurement trace range, or user-de ned trace. units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. Source-Wavelength Range Hardware dependent Source-Length Range 3 { 2048 position units.
Language Reference PDWL Example 100 CLEAR 723 110 OUTPUT 723;"IP;" 120 OPTION BASE 1 130 DIM A(20) 140 ASSIGN @Sa TO 723 150 OUTPUT @Sa;"TRDEF B_IN,20;MOV B_IN,0;" 160 OUTPUT @Sa;"TRDEF P_WL,20;MOV P_WL,0;" 170 OUTPUT @Sa;"CENTERWL 750NM;SP 100NM;" 180 OUTPUT @Sa;"SNGLS;TH -60DBM;TS;" 190 OUTPUT @Sa;"COMPRESS B_IN,TRA,POS;" 200 OUTPUT @Sa;"PDWL,P_WL,B_IN;" 210 OUTPUT @Sa;"TDF M;" 220 OUTPUT @Sa;"P_WL?;" 230 240 250 260 Description See Also ENTER @Sa;A(*) FOR I=1 TO 20 PRINT A(I) NEXT I Initialize an
Language Reference PEAKS Sort detected signals from lowest wavelength to highest wavelength, or from lowest amplitude to highest amplitude. Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. Source-Length Range 3 { 2048 position units.
Language Reference PEAKS Example 60 OUTPUT 723;"VARDEF WL1,0;" 70 OUTPUT 723;"CENTERWL 1000NM;SP 300NM;TS;" 80 OUTPUT 723;"TH -65DBM;MKPX 10DB;TS;" 90 OUTPUT 723;"PEAKS TRB,TRA,WLN?;" 100 ENTER 723;A 110 PRINT "SIGNALS ABOVE -65 DBM:";A 120 OUTPUT 723;"MOV WL1,WLUNITS TRB[2],TRA;" 130 OUTPUT 723;"WL1?;" 140 ENTER 723;W 150 PRINT "THE WAVELENGTH OF POINT 2 IS ";W Description De ne user-de ned variable, WL1, equal to 0. Set the measurement range. Sweep trace A. Set the threshold to 065 dBm.
Language Reference PEAKS PEAKS must be used as either a query or as a source in another analyzer-command function. Form a query by ending the PEAKS statement with a question mark (?). When used as a query, PEAKS queries the number of peaks found. Use PEAKS as a source by incorporating the PEAKS statement into any spectrum-analyzer command having prede ned function in its syntax diagram. When PEAKS is used as a source, the number of peaks found is used for operation by the command that contains PEAKS.
Language Reference PEAKS Query Syntax Query Response See Also MKPX 7-377
Language Reference PEN Choose pen for plotting on plotter. Item Example Description Description Pen-Number Range 0 { 255, depending on display model Preset State PEN 0 150 160 170 180 190 200 210 220 230 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"CLRDSP;" 723;"TRDSP TRA,OFF;" 723;"GRAT OFF;" 723;"ANNOT OFF;" 723;"IT 1;VW OFF;" 723;"TEXT$Item 1$;" 723;"IT 1;OR 300,700;" 723;"PEN 1;" 723;"VW ON;" Clear user graphics. Remove trace A from display. Turn o graticule.
Language Reference PEN Default Color Assignments for HP 70004A Display Pen Number 1 See Also Default Color1 Display Assignment 1 gray GRATICULE 2 yellow TRACE A 3 light blue TRACE B 4 light red TRACE C 5 green LINES 6 bright white TITLES 7 gray ANNOTATION 8 orange ADVISE text 9 red ERRORS 10 bright white MARKERS 11 white 12 white 13 red 14 green 15 blue 16 black softKEY LABELS BACKGROUND Color can be adjusted using 4DISPLAY5 menus.
Language Reference PERASE Description Partially erase internal memory and analyzer settings. The PERASE command erases all unprotected memory that resides in the spectrum analyzer. PERASE erases internal memory, which contains user-de ned variables, traces, functions, on-end-of-sweep algorithms, amplitude-correction factors (AMPCOR), and les. (Refer to the following tables for a complete listing.
Language Reference PERASE Commands that Erase or Protect User Memory Memory Components Commands that Erase or Reset Memory PURGE DISPOSE* FORMAT PERASE* Commands that Protect Memory NSTATE PROTECT y PSTATE ERASE* user-de ned variable user-de ned trace user-de ned function active user-de ned function on-end-of-sweep-algorithm trace-amplitude correction factors state register le (instrument settings and title line) program le trace le 4USER5 keys le X X X X X X X X X X X X X X X X
Language Reference PERSIST Set the number of previous traces to be simultaneously displayed onscreen. Item Description Description Preset State OFF, 16 traces Range 1 { 50 The PERSIST command sets the number of previous traces to be simultaneously displayed onscreen. Range may be limited by available display memory. To increase the number of traces that can be displayed, reduce the number of trace points in each trace. Overlapping points are brightened.
Language Reference PLOT PLOT Plot the display screen. Item P1 X, P1 Y, P2 X, and P2 Y Range Example of plotting DLP contents. Example 10 20 30 40 50 60 70 80 90 100 110 Description Depends on plotting device. plot 0,0,700,500; wait 180s; The rst line of the above example initiates a printer-generated copy of the screen currently displayed. The second line places a 3-minute wait on the DLP while the plot completes.
Language Reference PLOT 120 ON INTR Hpib GOTO Done 130 ENABLE INTR Hpib;2 140 ! 150 OUTPUT Dsp;"CY 1;"; 160 ! 170 SEND Hpib;UNL LISTEN Plt TALK Dsplay DATA 180 ! 190 Loop:GOTO Loop 200 ! 210 Done: ! 220 OFF INTR 230 Status_byte=SPOLL(Dsp) 240 IF BIT(Status_byte,4) THEN DISP "DONE!" 250 ELSE 260 DISP "UNEXPECTED INTERRUPT" 270 END IF 280 ! 290 END 300 Description When nished, GO TO . . . Interrupt when nished. Dump plot. No CR/LF. Get controller o HP-IB. Do not use \LOCAL 7". Wait for completion.
Language Reference POSU POSU Convert wavelength or time units to position units.
Language Reference POSU Item Source Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Source Length Range 3 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference POSU prede ned function in its syntax diagram. When POSU is used as a source, the position-unit value of the source is used for operation by the command that contains POSU. POSU converts the wavelength of the reference-trace element to position units when the trace is displayed in wavelength spans greater than zero. For spans equal to zero, POSU converts the sweep-time position of the trace element to position units.
Language Reference POSU Query Syntax Query Response 7-388
Language Reference POWERON POWERON Example Description Specify the analyzer's state at power-up. 120 OUTPUT 723;"POWERON LAST;" Recall at power-up the state the analyzer was in when power was removed. The POWERON command speci es the state the analyzer will be in when power is applied. Argument De nition IP LAST Places the analyzer in its preset state when power is applied.
Language Reference PR Move pen relative to current position. Item Example Description SCALE by SCALE X-Coordinate Range Determined by or Y-Coordinate Range Determined or DWINDOW DWINDOW Draw a line on the analyzer display. 110 OUTPUT 723;"CLRDSP;" 120 OUTPUT 723;"PD;PR 800,600,-500,100;" 7-390 Clear graphics from memory. Place pen down. Move pen 800 units to the right and 600 units up from its current position, then move pen 500 units to the left, and 100 units up.
Language Reference PR Description See Also The PR command moves the graphics pen relative to its current position. A line is drawn on the analyzer display if the pen is down. Positions are speci ed as coordinates in scale units, which are set by the SCALE command or by the DWINDOW command if a graphics window is on.
Language Reference PREFX Change the le pre x that identi es user-memory entries. Item Description Pre x Range 0 { 8 characters Requirements If executed, it must precede store and save commands, such as: LIMISAVE, SAVED, SAVES, SAVET, SAVEU, STOR Example Description 110 OUTPUT 723;"PREFX;" The PREFX command changes the pre x letter appended to le numbers when the SAVED, SAVES, SAVET, and SAVEU commands (or corresponding keys) are used to store data in user memory.
Language Reference PREFX User Memory Contents Article Stored Storing Command File Pre x for Entry in User-Memory Catalog le containing user-key menu SAVEU le containing trace SAVET u t le containing user-de ned variable* SAVED d le containing user-de ned function* SAVED d le containing on-end-of-sweep algorithm* SAVED d le containing limit line LIMISAV l le containing state register (instrument settings and title-line) SAVES s * Cannot be stored in internal memory.
Language Reference PROTECT Prevent disposal or rede nition of internal memory. Item Description For user-de ned trace, user-de ned function, or user-de ned variable, range is 1 { 12 characters: A { Z, 0 { 9, and underscore ( ). First character must be a letter. Numbers must be preceded by underscore. Range For number, range is integers, 1 { 14. Required before and after le name when it contains a number or lower-case letters. When le name is upper-case alpha characters only, delimiters are optional.
Language Reference PROTECT DISPOSE (Erases articles in this list.) FORMAT FUNCDEF (user-de ned functions) KEYDEF (user-de ned key) LIMILINE (user-de ned traces, LIMIT HI and LIMIT LO) LIMISAV (limit-line les) LOAD (Load les and articles into internal memory.) ONEOS (on-end-of-sweep algorithm) PERASE (partial erase) SAVES (state-register le) SAVEU (4USER5 keys le) SAVET (trace le) STOR (Store any le.
Language Reference PROTECT Commands that Erase or Protect User Memory Memory Components Commands that Erase or Reset Memory PURGE Commands that Protect Memory DISPOSE* NSTATE PROTECT y PSTATE FORMAT PERASE* ERASE* user-de ned variable X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X (VARDEF, LOAD) user-de ned trace (TRDEF, LIMILINE) user-de ned function (FUNCDEF, LOAD) active user-de ned function (ACTDEF, LOAD) on-end-of-sweep-algorithm (ONEOS, LO
Language Reference PROTECT Query Response See Also PROTECT ALL? gives a 1 if any part of internal memory is protected. If all of internal memory is unprotected, PROTECT ALL? gives a 0.
Language Reference PSTATE Example Protect state-register les stored in user memory. 20 OUTPUT 723;"MSI MSIB;" 30 OUTPUT 723;"PSTATE OFF;" 40 OUTPUT 723;"NSTATE 3;" 50 OUTPUT 723;"PSTATE ON;" Description Select memory card on HP 70004A Display. Turn of state-register protection. Make 3 state registers available for storing instrument states. Turn on state-register protection.
Language Reference PU PU Lift pen up. Item Preset State Example Description Active. Pen is up. 130 OUTPUT 723;"CLRDSP;" 140 OUTPUT 723;"PU;PA 500,500;" 150 OUTPUT 723;"PD;PA 1000,1000;" 160 OUTPUT 723;"PA PU 0,1000;" 170 OUTPUT 723;"PD;PA 1000,0;" Description See Also Clear graphics from memory. Lift pen. Move pen to (500,500). Place pen down. Draw line to upper-right corner. Move pen to upper-left corner with pen in the up position. (See syntax diagram for PA.
Language Reference PURGE Erase le from internal or external memory. Item Number of characters Example Description 0 { 36 10 OUTPUT 723;"MSI MSIB;" 20 OUTPUT 723;"PURGE $s_2$;" Description Select memory card located at default HP-MSIB device. Erase state-register le. Delimiters required when le name contains a number. The PURGE command erases les from internal or external memory, regardless of protection asserted by the PSTATE or PROTECT command.
Language Reference PWRBW PWRBW Compute the bandwidth that contains a percentage of the total measured power. Item Source-Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 61.8 2 10308 when using prede ned variable or user-de ned variable.
Language Reference PWRBW Example 130 140 150 160 OUTPUT OUTPUT OUTPUT OUTPUT 723;"SNGLS;" 723;"CENTERWL 750NM;SP 100NM; 723;"MXMH TRA;TS;TS;TS;TS;" 723;"PWRBW TRA,99.0?;" 170 ENTER 723;P Description Activate single-sweep mode. Activate maximum-hold mode. Sweep trace A four times. Query bandwidth containing 99% of the power contained in full span. Assign value to computer variable.
Language Reference PWRBW Prede nedFunction Syntax Query Syntax 7-403
Language Reference PWRBW Query Response 7-404
Language Reference RB RB Set the resolution bandwidth. Item Description Resolution-Bandwidth Range 0.08 nm to 10 nm Step Increment 0.08 and 1, 2, 5 sequence Coupling Refer to the optical spectrum analyzer users' guide. Preset State RB AUTO Example 30 OUTPUT 723;"RB 100NM;" Set resolution bandwidth lter to 100 nm.
Language Reference RB Description The RB command sets the resolution bandwidth. During normal operation, the resolution bandwidth, sweep time, and span settings are coupled to yield speci ed amplitude and wavelength accuracy with maximum measurement speed. Whenever any of these settings are changed, this optimum coupling is overridden, but the optical spectrum analyzer continues to maintain speci ed accuracy whenever possible.
Language Reference RBR RBR Set ratio of resolution bandwidth to span. Item Example Description Description Ratio Range Actual range is hardware dependent. Firmware range is 10-100 { 10100 Step Increment 1, 3, 10 sequence Preset State RBR .01 160 OUTPUT 723;"RBR 0.03;" Set resolution-bandwidth/span ratio to 0.03. The RBR command determines the ratio between the resolution bandwidth and span settings when they are set to automatic.
Language Reference RCLD Recall stored limit lines and user-de ned functions, variables, keys, and traces. Item Range Example Description Description 0 { 9999, depending on memory 160 OUTPUT 723;"RCLD 2;" The RCLD command recalls the contents of a program le from the currently selected mass storage device. Unless speci ed otherwise by the MSI command, internal memory is the storage device. Since program les cannot reside in internal memory, use MSI to select external memory.
Language Reference RCLD Files containing an on-end-of-sweep algorithm are loaded into internal memory. The existing on-end-of-sweep algorithm, if present, is erased and replaced with the loaded algorithm. Files containing a limit line are loaded into the limit-line table. Loading state-register les reactivates the stored instrument state. Loading user-key les reactivates the stored 4USER5-key menu.
Language Reference RCLS Recall instrument settings and title line from a state-register le. Item Range Example Description See Also Description 0 { 9999, depending on memory 160 OUTPUT 723;"RCLS 2;" The RCLS command recalls the contents of a state-register le from the currently selected mass storage device. Unless speci ed otherwise by the MSI command, internal memory is the storage device. RCLS speci es the number of the le for recall.
Language Reference RCLT RCLT Recall contents of a trace le. Item Range Example Description See Also Description 0 { 9999, depending on memory 160 OUTPUT 723;"RCLT 2;" The RCLT command replaces trace A with the contents of a trace le from the currently selected mass storage device. Unless speci ed otherwise by the MSI command, internal memory is the storage device. All instrument settings are changed to reproduce the state the spectrum analyzer was in when the trace was stored.
Language Reference RCLU Recall stored menu of 4USER5 keys. Item Range Example Description See Also Description 0 { 9999, depending on memory 160 OUTPUT 723;"RCLU 2;" The RCLU command recalls the contents of a 4USER5 key le from the currently selected mass storage device. Unless speci ed otherwise by the MSI command, internal memory is the storage device. RCLU speci es the number of the le for recall. In the catalog of user memory, the number is shown after the underscore.
Language Reference READMENU READMENU Build an interactive set of key functions. Item Key-Number Range Description Integers, 1 { 14 Example Initialize analyzer. 120 CLEAR 723 130 OUTPUT 723;"IP;" 140 OUTPUT 723;"VARDEF KEY,0;" 150 155 156 160 OUTPUT OUTPUT OUTPUT OUTPUT 723;"REPEAT;"; 723;"PA 400,700;"; 723;"TEXT @EXIT KEY ENDS REPEAT LOOP.@;"; 723;"READMENU KEY,"; Select a user-de ned variable, KEY, where the number of the key can be stored when it is pressed.
Language Reference READMENU 220 OUTPUT 723;"ELSIF KEY,EQ,2;"; 230 OUTPUT 723;"THEN;CENTERWL 1000NM;SP 100NM;"; 240 OUTPUT 723;"ELSIF KEY,EQ,14;"; 250 OUTPUT 723;"THEN;ABORT;"; 260 OUTPUT 723;"ENDIF;"; 270 OUTPUT 723;"UNTIL KEY,EQ,14;" Description If KEY equals 2, increase the measurement range. If KEY equals 14, then stop repeating lines 150 0 270. End repeat-loop de nition. The READMENU command assigns a series of key labels to form a menu of keys that can be accessed with the 4USER5 key.
Language Reference RELHPIB RELHPIB Example Discontinue control of HP-IB. 140 OUTPUT 723;"OUTPUT 19,K,'STARTWL';OUTPUT 19,K,'F_A';OUTPUT 19,K,'HZ';" The analyzer controls a device on HP-IB. The analyzer sends data via HP-IB. 150 OUTPUT 723;"RELHPIB;" The analyzer releases control of HP-IB so that another device can control the bus. Description See Also The RELHPIB command releases analyzer control of HP-IB.
Language Reference REPEAT/ UNTIL Example Repeat a list of analyzer commands until a condition is met. 250 OUTPUT 723;"STARTWL 600NM;SP 100NM" 270 OUTPUT 723;"REPEAT;"; 280 OUTPUT 723;"MOV STARTWL,STOPWL;TS;"; 290 OUTPUT 723;"UNTIL STARTWL,EQ,1000NM;" Description Set measurement range. Begin repeat loop. Set the start wavelength equal to the stop wavelength and take a sweep. End loop when the start wavelength equals 1000 nm. The REPEAT and UNTIL commands work together to form a looping construct.
Language Reference REPEAT/ UNTIL The conditions are Less than (LT). Greater than (GT) Less than or equal to (LE). Greater than or equal to (GE). Equal to (EQ). Not equal to (NE). If the condition is already satis ed at the time REPEAT/UNTIL is executed the rst time, the commands following REPEAT are executed once.The function of REPEAT/UNTIL is limited to the amount of internal memory available at the time they are executed. An error results if there is not enough memory.
Language Reference RETURN Example Interrupt operation of current user-de ned function, then return to the point where the function was originally encountered. The following example contains a user-de ned function, called PROGRAM 1, nested inside another function, called PROGRAM 2, which itself is nested inside another function called PROGRAM 3. Thus, PROGRAM 3 executes PROGRAM 2, and PROGRAM 2 executes PROGRAM 1. PROGRAM 1 displays numbers (100, 200, 300, and 400), and also contains the RETURN command.
Language Reference RETURN 170 OUTPUT 723;"^PROGRAM_1; TEXT@INSIDE PROGRAM_2..@;^ ;"; 180 ! 190 OUTPUT 723;"FUNCDEF PROGRAM_3,"; 200 OUTPUT 723;"^PROGRAM_2;TEXT@INSIDE PROGRAM_3@;^;"; 210 220 230 240 ! OUTPUT 723;"PROGRAM_3;"; OUTPUT 723;"PU;PA 300,200;" OUTPUT 723;"TEXT@OUTSIDE USER-DEFINED FUNCTIONS@;" Description See Also Execute PROGRAM 1 and write \INSIDE PROGRAM 2.." De ne third user-de ned function, PROGRAM 3. Execute PROGRAM 2 and write \inside PROGRAM 3." Execute PROGRAM 3. Position pen.
Language Reference REV Return rmware date code. Example Description 10 OUTPUT 723;"REV?;" Query rmware version to computer. The REV query returns the revision number of the rmware (ROM).
Language Reference RL RL Set the reference level. Item Example Description Description Reference-Level Range Actual range is hardware dependent. Firmware range is Step Increment One vertical scale division. Requirements Update trace data after executing RL. Preset State RL 0DBM 6300 dBm. 10 OUTPUT 723;"RL UP;" The RL command sets the absolute amplitude value of the reference level. The default units for the reference level are watts for linear mode and dBm for log mode.
Language Reference RL CAUTION The reference level can be set to signal levels that damage the optical spectrum analyzer. Be sure to observe the maximum input power limits.
Language Reference RLPOS RLPOS Select position of reference level. Item 0 { 10 Step Increment 1 Preset State RLPOS 9 Example Description Description Range 10 OUTPUT 723;"RLPOS 7;" Position the reference level at the seventh major graticule division. The RLPOS command changes the position of the reference level during log display mode. The top and bottom graticule lines correspond to 10 and 0, respectively. Arrows indicate the reference level line when it is not at the top graticule line.
Language Reference RMS Compute the root mean square of the speci ed trace. Item Source-Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. Source-Length Range Example Description 3 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference RMS Prede nedFunction Syntax Query Syntax Query Response 7-425
Language Reference ROFFSET O set absolute value of amplitude measurements. Item Step Increment 1 major vertical scale division for log mode. 1 major vertical scale division at top of graticule (.915 dB) for linear mode. Preset State ROFFSET 0DB 140 OUTPUT 723;"ROFFSET 60DB;" The ROFFSET command o sets all amplitude readouts on the display without a ecting the trace data. \ROFFSET" appears on the display when the o set is on. Values queried to the computer on HP-IB are also o set.
Language Reference RQS RQS De ne conditions that interrupt computer operation. Item Range Example 100 110 120 130 140 150 160 170 180 Description Integers from 0 { 255 Set the service-request mask so that service is requested when the sweep is completed.
Language Reference RQS Description The RQS command enables the service-request mode. RQS de nes the service-request mask that selects which bits of the status-byte register can generate a service request. Once RQS is executed, computer service is requested whenever any of the selected service conditions occur. For example, executing RQS 2 means that service is requested whenever a message is present in the message area. The analyzer requests service by setting bit 2 in the status-byte register true.
Language Reference SAVED SAVED Store limit lines and user-de ned functions, variables, keys, and traces in a le. Item Range Description Description 0 { 9999, depending on memory The SAVED command stores all of the following articles in a le if the articles are present in memory. The le type or identi er, as shown in the catalog of internal memory, is shown in parentheses.
Language Reference SAVED Use SAVED to transfer user-de ned articles to memory outside of the optical spectrum analyzer. Once transferred to an external device, erase the entries from internal memory with the DISPOSE, PURGE, or PERASE command if additional internal-memory space is desired. Recall stored les with the RCLD or LOAD command.
Language Reference SAVES SAVES Save instrument settings and title line in a state-register le for future recall. Item 1 { 9999 Range Example Description Description 30 OUTPUT 723;"PSTATE OFF;" 40 OUTPUT 723;"SAVES 3;" Turn o state-register le protection. Save instrument in le number 3. The SAVES command saves the current spectrum-analyzer state in a state-register le, speci ed by a number. Information saved includes all front-panel settings and any text in the title line.
Language Reference SAVES NOTE The PSTATE and PROTECT commands do not protect state-register les against erasure or overwriting with the PURGE, ERASE, or LOAD command.
Language Reference SAVET SAVET Store trace A in a le. Item Description 0 { 9999, depending on memory Range Example Description 30 OUTPUT 723;"SAVET;" SAVET stores the contents of trace A in a le in user memory, which is the currently selected mass storage device. Unless speci ed otherwise by the MSI command, internal memory is the storage device. Files are listed in the catalog by default as \t N", where N is the number of the le, and \t " indicates the le contains a trace array.
Language Reference SAVEU Save 4USER5 keys in a le for future recall. Item Range Example Description Description Integer, 0 { 9999, depending on memory. 30 OUTPUT 723;"SAVEU;" The SAVEU command stores the user-de ned keys that are currently accessed with the 4USER5 key. It also saves any user-de ned custom keypad keys. Refer to the KEYDEF command for information on de ning custom keypad keys. SAVEU stores les in user memory, which is the currently selected mass storage device.
Language Reference SCALE SCALE Select X and Y scale for graphics. Item 61.
Language Reference SCALE Example Use the SCALE command to draw Y=X2 on the spectrum-analyzer display.
Language Reference SCALE Description See Also The SCALE command scales the spectrum-analyzer display for drawing graphics. The default scale is 0 to 1000 for both the X and Y axis, which extend across the width and height of the spectrum-analyzer display. The following commands draw on the spectrum-analyzer display according to the units set by SCALE.
Language Reference SENS Selects the input sensitivity level. Item Example Description Description Range Actual range is hardware dependent. Firmware range is Step Increment One vertical scale division. Preset State SENS AUTO 6 300 dBm. 10 OUTPUT 723;"SENS DN;" The SENS command sets the instrument's sensitivity. When the AUTO argument is used, the optical spectrum analyzer automatically selects the sensitivity based on the current reference level.
Language Reference SENS Notice that video bandwidth and internal gains are set as needed to achieve the requested sensitivity based on nominal values. Actual sensitivity realized may not equal the setting chosen. Query Response See Also Results are always returned in dBm regardless of the value set by AUNITS.
Language Reference SER Enter user serial number of instrument. Item Range Example 150 OUTPUT 723;"SER?;" Query Response 7-440 Description Maximum of 21 characters Query optical spectrum-analyzer serial number to computer.
Language Reference SMOOTH SMOOTH Reduce amplitude variations on a trace. Item Description Number-of-Points Range 3 to length of source Source-Amplitude Range 0 { 10,000 measurement units for linear trace data. 032,768 { +32,767 measurement units for logarithmic trace data.
Language Reference SMOOTH 70 OUTPUT 723;"SMOOTH TRA,NN;"; 80 OUTPUT 723;"CLRDSP;"; 90 OUTPUT 723;"PA 100,700;TEXT$Smoothing over $;"; 100 OUTPUT 723;"DSPLY NN,4,1;"; 110 OUTPUT 723;"PA 740,700;TEXT$points$;"; 120 OUTPUT 723;"WAIT 2S;"; 130 OUTPUT 723;"UNTIL NN,EQ,100;"; 140 OUTPUT 723;"WAIT 1S;" 150 OUTPUT 723;"IP;" Description See Also Average each point of trace A with points NN/2 either side of it. Clear graphics from memory. Write text. Write the value of NN on the spectrum-analyzer display.
Language Reference SNGLS SNGLS Example Description See Also Sweep on demand only. 10 OUTPUT 723;"SNGLS;" 20 OUTPUT 723;"TS;" Turn on single-sweep mode and sweep once. Sweep once. The SNGLS command activates the single-sweep mode. During this mode, the spectrum analyzer sweeps once from the start to the stop wavelength whenever the TS or SNGLS command is executed and the trigger conditions are met. The SNGLS command cannot be substituted for the TS command.
Language Reference SP Set wavelength span of measurement. Item Example Description Description Range Actual range is hardware dependent. Step Increment 1,2,5,10 sequence Coupling WLspan = WLstop Preset State nm 0 WLstart 10 OUTPUT 723;"SP 500NM;" The SP command sets the wavelength range symmetrically around the center wavelength. The zero-span mode is activated whenever the span is 0 Hz.
Language Reference SP Query Response See Also RB, ST 7-445
Language Reference SQR Compute square root of source, point-by-point, and store results in the destination.
Language Reference SQR Item Source-Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Source-Length Range 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC. Truncated if longer than destination length.
Language Reference SRINPUT Example Description Select optical input for stimulus-response measurements. 100 OUTPUT 723;"SRINPUT NORMAL;" On HP 70951B optical spectrum analyzer modules, the SRINPUT command selects the input connector for stimulus-response measurements. Choices are the MONOCHROMATOR INPUT (SRINPUT NORMAL) or the PHOTODETECTOR INPUT (SRINPUT DIODE) connectors.
Language Reference SRQ SRQ Set bit(s) in status-byte register to simulate service request. Item Range Example Description Description 0 { 255 30 OUTPUT 723;"SRQ 4;" The SRQ command simulates service requests by setting bits in the status-byte register. Use the SRQ command to test the operation of programs containing service requests. For example, suppose your program branched to a subroutine whenever a spectrum-analyzer error was detected.
Language Reference SRQ Spectrum-Analyzer Status-Byte Register Bit Number Decimal Spectrum-Analyzer Equivalent State Description 7 128 6 64 RQS Set when status-byte register bit and corresponding bit in service-request mask are true. Indicates service-request has occurred. 5 32 ERROR PRESENT Set when error register contains an error. 4 16 COMMAND COMPLETE Set at completion of command execution. 3 8 2 4 END OF SWEEP Set at completion of sweep.
Language Reference SS SS Set the step increment of CENTERWL. Item Example Description Step-Size Range Actual range is hardware dependent. Firmware range is Step Increment 1, 2, 5, 10 sequence Preset State SS AUTO 10 OUTPUT 723;"CENTERWL 750NM;SP 200NM;" 20 OUTPUT 723;"SS 25NM;" 30 OUTPUT 723;"CENTERWL UP;" 6 500 nm. Set measurement range. Set step size to 25 nm. Increase center wavelength by one step size (25 nm).
Language Reference SS Description The SS command sets the step increment of the center wavelength changes whenever CENTERWL UP or CENTERWL DN is executed. SS AUTO activates the default step size. For spans greater than zero, the step size equals one graticule ( span ). For spans equal to zero, the step size 10 equals the resolution bandwidth. SS MAN indicates that the system uses a value entered an a previous, unknown occasion.
Language Reference ST ST Set the time it takes to sweep from the start wavelength to the stop wavelength. Item Example Description Description Sweep-Time Range 0 { 1000 seconds, or hardware limit. Step Increment 1, 2, 5, 10 sequence Coupling Coupled to sensitivity (SENS), video-bandwidth (VB), and span (SP). Preset State ST AUTO 120 OUTPUT 723;"ST 1S;" Set sweep time to 1 second. Sweep time, sensitivity, and video bandwidth are coupled to yield the maximum, signal-amplitude accuracy.
Language Reference ST Reduce the measurement range (SP). The time between each sweep (retrace time) is reduced when the active trace and annotation are not displayed (ANNOT OFF; TRDSP OFF).
Language Reference STARTUP STARTUP Controls the start up con guration operation of the optical spectrum analyzer. Item Default (no argument) CAUTION Example Description Description ONCE The STARTUP MAN and STARTUP ONCE commands both result in the loss of any internal user calibration data when the system restarts. This is because the data is part of the con guration. In addition, STARTUP MAN and STARTUP ONCE both force the POWERON command into IP if it was in LAST.
Language Reference STARTUP instrument break its links (if any) to a display. After the link manipulations and communications are complete, the optical spectrum analyzer performs a warm start recon guration with a power-up IP. After the recon guration the value of STARTUP reverts to AUTO.
Language Reference STARTWL STARTWL Set start wavelength of measurement range. Item Example Description Description Wavelength Range Actual range is hardware dependent. Firmware range is 600 nm to 1700 nm. With wavelength limit OFF, the range is 350 nm to 2000 nm. Step Increment Span/10 Preset State Minimum value allowed by system con guration. 110 OUTPUT 723;"STARTWL 750NM;" 120 OUTPUT 723;"STARTWL UP;" Set start wavelength to 750 nm. Increase start wavelength by 10% of the span.
Language Reference STARTWL Query Response See Also Commands that a ect wavelength, such as CENTERWL, STOPWL, FS, SP, WLOFFSET, 7-458
Language Reference STATE STATE Example Return or receive instrument state information. 140 ALLOCATE State$[1000] 160 OUTPUT 723;"STATE?;" 170 ENTER 723 USING "-K";State$ 190 OUTPUT 723;"IP;" 210 OUTPUT 723;State$[5]; Description Query Response Allocate a string variable array, State, for storing the spectrum-analyzer state in the computer. Query spectrum-analyzer state to computer. Save response in State in the form of ASCII tokens, requiring a special image (\0K") to receive the data.
Language Reference STB Return value of status-byte register. Example Monitor spectrum-analyzer operation without using service-request methods. 10 20 30 40 50 60 CLEAR 723 OUTPUT 723;"IP;CLRDSP;" OUTPUT 723;"SNGLS;" OUTPUT 723;"CLS;" OUTPUT 723;"TS;" OUTPUT 723;"STB?;" 70 ENTER 723;N 80 OUTPUT 723;"STB?;" 90 ENTER 723;M 100 DISP N,M Description Preset spectrum analyzer. Activate single-sweep mode. Clear status-byte register. Sweep spectrum analyzer. Query status of status byte, then clear it.
Language Reference STB Executing STB? always sets the command-complete bit. For this reason, STB cannot be used to monitor the completion of commands. Refer to the DONE command. STB must be used as either a query or as a source in another analyzercommand function. Form a query by ending the STB statement with ?. When used as a query, STB gives the decimal equivalent of the status-byte register to the computer.
Language Reference STDEV Compute standard deviation of trace amplitude. Item Source-Amplitude Range Description 0 { 10,000 measurement units for linear trace data. 032,768 { +32,767 measurement units for logarithmic trace data. Source-Length Range Example 3 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference STDEV Description The STDEV command calculates the standard deviation of the trace amplitude, in measurement units. STDEV must be used as either a query or as a source in another analyzer-command function. Form a query by ending the STDEV statement with a question mark (?). When used as a query, STDEV queries the standard deviation to the computer.
Language Reference STOPWL Set stop wavelength of measurement range. Item Example Description Description Wavelength Range Actual range is hardware dependent. Firmware range is 600 nm to 1700 nm. With wavelength limit OFF, the range is 350 nm to 2000 nm. Step Increment Span/10 Preset State Maximum value allowed by system con guration. 10 OUTPUT 723;"STOPWL 1200NM;" The STOPWL command speci es the stop wavelength of the measurement range.
Language Reference STOPWL Query Response See Also Commands a ecting wavelength, such as CENTERWL, STARTWL, FS, SPAN, WLOFFSET 7-465
Language Reference STOR Store user-de ned articles. Item Example Description File-Name Range 0 { 10 characters Delimiters Required before and after le name when it contains a number or lower-case letters. When le name is upper-case alpha characters only, delimiters are optional. 10 OUTPUT 723;"STOR S,$file_1$;" 7-466 Store the le \FILE 1" of instrument settings in internal memory.
Language Reference STOR Description STOR stores les in the currently selected user memory. Unless speci ed otherwise by the MSI command, internal memory is the storage device. The information stored depends on the argument selected. S stores the current instrument settings and the contents of the title line. D stores all of the following user-de ned articles in external memory only.
Language Reference STOR Description of User-Memory Catalog Article Stored user-de ned function y active user-de ned function user-de ned variable user-de ned trace y y y Storing Command File Type Standard File Pre x FUNCDEF, RCLD, LOAD FUNC none ACTDEF, RCLD, LOAD AFUNC none VARDEF, RCLD, LOAD VAR none TRDEF, LIMILINE, RCLD, LOAD TRACE none ONEOS, RCLD, LOAD ONEOS none le containing user-key menu SAVEU, STOR ASCII u le containing trace SAVET, STOR ASCII t le containing user-d
Language Reference STORREF STORREF Example Description See Also Store through references for stimulus-response measurements. 10 OUTPUT 723;"STORREF THRU;" STORREF THRU discontinues measurements with trace B, then transfers through-reference amplitude information measured with trace A to trace B.
Language Reference SUB Subtract.
Language Reference SUB Item Source-Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Example Description Source-Length Range 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference SUM Compute the sum of amplitude levels detected in each point of a trace. Item Source-Amplitude Range Description 0 { 10,000 measurement units for linear trace data. 032,768 { +32,767 measurement units for logarithmic trace data. Source-Length Range Example 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC. Add the amplitudes of all points in trace A.
Language Reference SUM Description The SUM command gives the sum of the trace amplitudes in measurement units. SUM must be used as either a query or as a source in another analyzer-command function. Form a query by ending the SUM statement with a question mark (?). When used as a query, SUM queries the sum of the trace amplitudes to the computer. Use SUM as a source by incorporating the SUM statement into the source of any spectrum-analyzer command having prede ned function in its syntax diagram.
Language Reference SUMSQR Compute the sum of the square of the amplitude levels detected in each point of a trace. Item Source-Amplitude Range Description 0 { 10,000 measurement units for linear trace data. 032,768 { +32,767 measurement units for logarithmic trace data. Source-Length Range Example 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference SUMSQR Description The SUMSQR command gives the sum of the square of the trace-point amplitudes in measurement units. SUMSQR must be used as either a query or as a source in another analyzer-command function. Form a query by ending the SUMSQR statement with a question mark (?). When used as a query, SUMSQR queries the sum of the square of the trace amplitudes to the computer.
Language Reference SWEEP Example Description Start or stop analyzer sweep. 30 OUTPUT 723;"SWEEP OFF;" The SWEEP command is used to stop the optical spectrum analyzer from sweeping, immediately. Sending SWEEP ON, IP, TS, CONTS, or SNGLS starts the sweep.
Language Reference SWPMODE? SWPMODE? Example Description Return the current sweep mode. 100 OUTPUT 723;"SWPMODE?;" The SWPMODE command returns the current sweep mode of the instrument. The returned string will be either SNGLS or CONTS, depending upon whether the instrument is in single sweep or continuous sweep respectively.
Language Reference TDF Format trace data: binary, block, ASCII-decimal, measurement units, or parameter units.
Language Reference TDF Query trace data as decimal values in absolute units (dBm). Query only the 50th element. Assign data to variable. Print value. 230 OUTPUT 723;"TDF P;TRA[50]?;" 240 ENTER 723;N 250 DISP N Description The TDF command formats trace information for return to the controller. TDF P (parameter) gives data as ASCII-decimal values in absolute units (dBm). Trace data values are separated by a \," character. TDF M (measurement) gives data as ASCII-decimal values in measurement units.
Language Reference TDF Trace Data Output Formats for Amplitude Information Format Command Spectrum Analyzer Output TDF P Gives ASCII decimal value. Values are in parameter units. +10.00 Data output is followed by line feed (ASCII code 10) and end-or-identify (EOI). Trace points are separated by a comma character. TDF M Gives ASCII integer value. Values are in measurement units. Line feed ( ASCII code 10) and EOI follow data output.
Language Reference TEST TEST Perform analyzer self-test. Example Description 10 OUTPUT 723;"TEST;" Conduct the self test. The TEST command tests spectrum-analyzer operation, then reports errors to the error register. The optical spectrum analyzer returns to its previous state when the test is complete. Execute ERR? to query error codes to the controller. (IP and ERR? clear the error register where errors are recorded.) The system-level command, device-clear, stops the test.
Language Reference TEXT 130 140 150 160 170 Write message anywhere on spectrum-analyzer display. Example CLEAR 723 OUTPUT 723;"IP;" OUTPUT 723;"CLRDSP;" OUTPUT 723;"PU;PA 200,800;" OUTPUT 723;"TEXT$"; 180 OUTPUT 723;"Text can be "; 190 OUTPUT 723;"positioned on the "; 200 OUTPUT 723;CHR$(10);CHR$(13); 210 220 230 240 250 260 270 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"display with the "; 723;"PA and PR "; 723;CHR$(10);CHR$(13); 723;"commands.
Language Reference TEXT Second, text can be positioned with the OR command during the reference-graphics mode. During this mode, text is assigned a nonzero item number with the IT command. Each item can contain up to 35 characters and up to 50 item numbers are available. Once assigned an item number, text can be modi ed at a later time or enhanced (blinking, inverse video, etc.). TEXT does not function when a graphics window is on (DWINDOW ON).
Language Reference TH Blank display of trace data below an amplitude level.
Language Reference TH Description The TH command blanks signal responses below the speci ed threshold level (similar to \base-line clipper" operation). The responses below the threshold value are blanked when a value is entered with TH, or when TH ON, TH UP, or TH DN is executed. The TH command does not a ect the amplitude information contained in the trace array.
Language Reference THREED Turn on or o the three-dimensional trace display capability. Item Example Preset State OFF ON Default is 16 Traces Range 1 to 50 traces 10 OUTPUT 723;"THREED ON;" 20 OUTPUT 723;"THREED UP;" 30 OUTPUT 723;"THREED?;" 40 ENTER 723;N Description Description Turn on three-dimensional capability. Increase traces displayed by one increment. How many traces are creating the three-dimensional display.
Language Reference THREED Query Response See Also THREEDV, THREEDH 7-487
Language Reference THREEDH Select the horizontal o set of the three-dimensional trace display. Item Example Description Preset State 4 positions, moving toward the right-hand side of the display Range 0 to Step Increment 1 position 10 OUTPUT 723;"THREED ON;" 20 OUTPUT 723;"THREEDH 010;" 30 OUTPUT 723;"THREEDH?;" 40 ENTER 723;N Description 6200 positions Turn on three-dimensional capability. Rotate the three-dimensional display 10 positions left, from its current position.
Language Reference THREEDH Query Response See Also THREED, THREEDV 7-489
Language Reference THREEDV Select the number of traces to create the three-dimensional trace display. Item Example Description Preset State 10 positions moving toward the top of the display Range 0 to Step Increment 1 position 10 OUTPUT 723;"THREED ON;" 20 OUTPUT 723;"THREEDV 20;" 30 OUTPUT 723;"THREEDV?;" 40 ENTER 723;N Description 6200 positions Turn on three-dimensional capability. Rotate the three-dimensional display 20 positions up from its current position.
Language Reference THREEDV Query Response See Also THREED, THREEDH 7-491
Language Reference TIME Monitor time. Item Example Description Time Range 610 Clock Accuracy 1 10 20 30 40 Description 12 s OUTPUT 723;"TIME 0S;" OUTPUT 723;"WAIT 3;" OUTPUT 723;"TIME?;" ENTER 723;N Set clock to zero. Wait three seconds. Query elapsed time to controller. Assign value to controller variable. The TIME command sets the clock that measures operating time. Clock precision is 1 s. Execute TIME? to query the time lapsed since the clock was last set.
Language Reference TITLE TITLE Write a title in the title line. Item Example Description Number of characters 0 { 36 Preset State Blank title 130 OUTPUT 723;"CLRDSP;" 140 OUTPUT 723;"TITLE$Title your data$;" 150 OUTPUT 723;"WAIT 2S;" 160 OUTPUT 723;"TITLE$"; 170 OUTPUT 723;CHR$(27);"&dB"; 180 OUTPUT 723;"^Your title^"; 190 OUTPUT 723;CHR$(27);"&d@"; 200 OUTPUT 723;"$;" Clear graphics from memory. Write text in the title line. The \$" delimits text. Wait 2 seconds. Write text.
Language Reference TITLE Description See Also The TITLE command displays text in the title line located in the upper portion of the graticule. The TITLE command automatically places the pen down before text is written and raises it after text is written. Place identical delimiters at the beginning and end of the text you wish to display. The maximum number of text characters allowed is 36. Standard escape sequences may be used to produce enhancements such as blinking, inverse video, and underlining.
Language Reference TM TM Determine what triggers the sweep (the sweep-trigger mode). Item Preset State Example Description Description TM FREE 10 OUTPUT 723;"TM EXT;" The TM command selects the trigger mode that determines how the sweep is triggered. TM FREE (free run) uses the internal circuitry of the spectrum analyzer so that the trigger conditions are satis ed. TM VID (video) triggers the sweep with the amplitude level of the detected, video signal.
Language Reference TM Query Response See Also VTH, VTL, DONE, CONTS, SNGLS, VAVG 7-496
Language Reference TP TP Modify shape of stored, graphics item.
Language Reference TP Description The TP command works in conjunction with the item and plot commands, IT and PA, to modify the shape of referenced graphics called items. The TP command acts as a pointer that selects a point on an item for modi cation. For example, the triangle below is a graphics item de ned by points, numbered 0 through 3. #0 #1 #2 #3 (600,0) (700,200) (800,0) (600,0) Executing TP 1 selects point (700,200) for modi cation.
Language Reference TRA/TRB/TRC TRA/TRB/TRC Return or store trace data.
Language Reference TRA/TRB/TRC Item Amplitude Range Description 0 { 10,000 measurement units for linear trace data. 032,768 { +32,767 measurement units for logarithmic trace data. Length Range Example 3 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC. Use TRC to store data in a trace. 10 OUTPUT 723;"BLANK TRA;" 20 OUTPUT 723;"TRDEF TRC,3;" 30 OUTPUT 723;"TRC -10DBM,-20DBM,-15DBM;" 40 OUTPUT 723;"VIEW TRC;" Blank trace A. De ne trace C as a three-element trace.
Language Reference TRA/TRB/TRC Description The TRA, TRB, and TRC commands send or receive trace-amplitude information for trace A, B, or C. Trace A is described below. Traces B and C operate the same way. To store an amplitude value in one or more points of a trace, follow TRA by amplitude values for each point. Values are stored starting with the rst point.
Language Reference TRA/TRB/TRC Query Response Data in ASCII Format (TDF P or TDF M) Data in Absolute, Block-Data Format (TDF A) Data in Inde nite, Block-Data Format (TDF I) Data in Binary Format (TDF B) See Also MDS, TDF, and commands that a ect wavelength or amplitude range.
Language Reference TRCOND TRCOND Scale trace data displayed in a graphics window. Item Description Stop-Wavelength Range 6 1000 m or hardware limit. 6 1000 m or hardware limit. Sweep-Time Range 0 { 1000 seconds or hardware limit. Start-Wavelength Range Bottom-of-Screen Range 032,768 { +32,767 032,768 { +32,767 Trace-Length Range 3 { 2048 Top-of-Screen Range Reference-Level Range Reference-Trace-Length Range 6 300 dBm or hardware limit. 3 { 2048 position units.
Language Reference TRCOND Example 140 ALLOCATE Disp_mode$[3] Allocate string variable in computer for storing conditions. 150 OUTPUT 723;"TRCOND TRA?;" Query trace conditions to computer. 160 ENTER 723 USING "#,K";Start,Stop,Sweep Return data. 170 ENTER 723 USING "#,K";Top,Bottom,Data 180 ENTER 723 USING "#,K";Reference,Disp_mode$ 190 DISP Bottom;"MEASUREMENT UNITS" Display minimum trace value.
Language Reference TRCOND Query Response See Also DWINDOW, GRAPH 7-505
Language Reference TRDEF Change trace length or create user-de ned traces. Item Example Description Trace-Name Range 1 { 12 characters: A { Z, 0 { 9, and underscore ( ). First character must be a letter. Numbers must be preceded by underscore.
Language Reference TRDEF Description The TRDEF command changes the length of traces A, B, or C, or creates new trace arrays, called user-de ned traces, for data storage or manipulation. After a user-de ned trace is created, it can be used wherever user-de ned trace appears in the syntax diagrams. Memory is reserved to contain up to 2048 elements of trace information (from 1 to 2048) for each of the prede ned traces A, B, and C.
Language Reference TRDSP Blank display of active trace(s) while measuring. Item Example Description 30 40 50 60 70 OUTPUT OUTPUT OUTPUT OUTPUT OUTPUT 723;"CENTERWL 750NM;SP 100NM;" 723;"TS;" 723;"TRDSP TRA,0;" 723;"TRDSP TRA,ON;" 723;"TRDSP TRA,?;" Set measurement range. Sweep trace A. Turn o display of trace A. Display trace A. Query display-status of trace A. The TRDSP command turns o trace A, B, or C without clearing the trace data or interrupting measurements.
Language Reference TRNSZLOCK TRNSZLOCK Locks transimpedance ampli er for fast pulse measurements. Item Preset State Example Description Description o OUTPUT 723;"TRNSZLOCK;" The TRNSZLOCK command locks the optical spectrum analyzer's internal transimpedance ampli er. Locking the transimpedance ampli er limits its range to ensure wide bandwidth and fast settling characteristics. This allows the optical spectrum analyzer to make accurate fast pulse measurements.
Language Reference TRPST Example Description See Also Preset active trace conditions. 110 OUTPUT 723;"TRPST;" Reset the traces to a de ned state. Use the TRPST command to reset the traces to a de ned state without a ecting the measurement parameters. The TRPST command executes the following commands to preset trace functions: Clear-write trace A. (CLRW TRA) Blank trace B. (BLANK TRB) Blank trace C. (BLANK TRC) Turn o trace-A-minus-trace-B.
Language Reference TRSTAT TRSTAT Return the status of the active trace. Example Description Query Response 10 ALLOCATE Status$[40] 20 OUTPUT 723;"TRSTAT?;" 30 ENTER 723 USING "-K";States$ De ne computer array for storing characters. Query trace states. Store response in States$, including line feeds. The TRSTAT query returns the status of traces A, B, and C. The status can be clear-write, blank, max-hold, min-hold, on (view mode), or o .
Language Reference TRSTAT See Also CLRW, VIEW, BLANK, TRDSP, TRPST 7-512
Language Reference TS TS Sweep the current measurement range. Example Description See Also 10 OUTPUT 723;"MKN;TS;MKMIN;" The TS command sweeps the current measurement range and stores new amplitude information in the active trace(s). Use TS for the following reasons: Insure trace re ects current measurement range settings. Capture traces before processing them with math commands. Capture traces before positioning markers. Each sweep begins when the trigger conditions are met.
Language Reference TWNDOW Format trace array for use with fast Fourier transform. Item Description Destination-Amplitude Range 0 { 10,000 measurement units for linear trace data. Destination-Length Range 3 { 2048 position units. 032,768 { +32,767 measurement units for logarithmic trace data.
Language Reference TWNDOW Example 170 OUTPUT 723;"CENTERWL 750NM;" 180 OUTPUT 723;"SP 0;ST 50MS;" 190 OUTPUT 723;"TWNDOW TRC,FLATTOP;" 200 OUTPUT 723;"CLRW TRB;BLANK TRA;" 210 OUTPUT 723;"SNGLS;TS;" 220 OUTPUT 723;"FFT TRA,TRB,TRC;" 230 OUTPUT 723;"BLANK TRB;VIEW TRA;" Description Set measurement range. Store at-top-window algorithm in trace C. Measure with trace B. Blank trace A. Sweep once. Perform fast-Fourier transform on trace B and store the results in trace A. Blank trace B.
Language Reference TWNDOW The prede ned windows simulate passband shapes that represent a give-and-take between amplitude uncertainty, sensitivity, and wavelength resolution. They also minimize side e ects caused by the non-continuous, nite nature of the discrete Fourier transform. One side e ect is the appearance of aliasing. This is handled by rapid sampling and signal ltering. Another side e ect is spurious responses caused by sampling the measurement range for a nite period.
Language Reference USERERR USERERR Create customized error messages and error conditions. Item Example Description See Also Description Error-Number Range 1 { 9999 Error-Text Range 0 { 20 characters 150 OUTPUT 723;"USERERR,1234,@MAG@;" 160 OUTPUT 723;"WAIT 2S;" 170 OUTPUT 723;"XERR?;" Report error 1234. Wait 2 seconds. Query error report to computer. The USERERR command displays an error message of your own creation and assigns the error a number.
Language Reference USERKEY Example Return or receive data that con gures 4USER5 keys. Transmit the 4USER5 key menu to and from the computer. 200 OUTPUT 723;"USERKEY?;" 210 ALLOCATE Userkeys$[350] 220 ENTER 723 USING "-K";Userkeys$ 230 OUTPUT 723;"KEYPST;" 240 P=POS(Userkeys$,"USERKEY") 250 OUTPUT 723;Userkeys$[P]; 260 DEALLOCATE Userkeys$ 7-518 Return key menu to computer. De ne string variable for storing keys. Up to 350 characters can be stored.
Language Reference USERKEY Description The USERKEY command transmits the key labels accessed with the front-panel 4USER5 key. Any labels that are associated with custom keypad keys will also be transmitted. Refer to the KEYDEF command for an explanation of de ning custom keypad keys. USERKEY? returns the key labels to the controller. The block-data eld syntax (#A) reloads the key labels. The label names are sent as an absolute, block-data eld.
Language Reference USERLOCK Example Limit front-panel operation to the 4USER5 keys. 10 OUTPUT 723;"USERLOCK ON;" 20 OUTPUT 723;"USERLOCK OFF;" Description Observe that 4MENU5 keys cannot be accessed when 4MENU5 is pressed. Make 4MENU5 keys operational. The USERLOCK command limits front-panel operation to keys accessed with the 4USER5 key, making the 4INSTR PRESET5 or 4I-P5 key, and keys accessed with the 4MENU5 key, inoperative.
Language Reference USERMSG USERMSG Example Description See Also Write a message on the spectrum-analyzer display that is cleared at your discretion. 10 OUTPUT 723;"USERMSG @Set center wavelength to 300MHz.@;" The USERMSG command writes a message of 39 characters or less in the message area on the display. The message is cleared by pressing any key, or executing IP or MSG?.
Language Reference USERWARN Display a user de ned warning message. Item Example Description Description Warning-Number Range 10001|19999 Warning-Text Range 0|20 characters 100 OUTPUT 723;";" 100 OUTPUT 723;"USERWARN 17000, ^Connect the input signal!^;" The USERWARN command allows you to write your own warning message on the display. Use warnings to indicate that the user might not be performing a task properly.
Language Reference USERWARN When creating a user message, do not use the numbers 10000, or 16001 through 16012; these are reserved warning message numbers. Refer to Chapter 4 of the HP 71450B/1B/2B Optical Spectrum Analyzer Reference for de nitions of these reserved warnings. The warning message removed from the display after one of the following events occurs: 6 seconds elapse from the time the message is displayed. Another warning message is displayed. A display key is pressed.
Language Reference USTATE Example Description Query or receive data that con gures internal memory. 10 OUTPUT 723;"USTATE?;" Query user state to computer. The USTATE command transmits all information that is stored in internal memory by the user. This information is called the user state and includes settings determined by the user and una ected by instrument preset, such as the HP-IB addresses, power-up setting (POWERON), and the protect-state-register setting (PSTATE).
Language Reference USTATE Query Response See Also USTATE? queries the user state to the computer. Also queried are instructions required by the spectrum analyzer when the user state information is transmitted to the spectrum analyzer. User-state data is in absolute, block-data format and is preceded by spectrum-analyzer instructions.
Language Reference VARDEF Store user-de ned variables in internal memory. Item Example Description Variable-Name Range 1 { 12 characters: A { Z, 0 { 9, and the underscore ( ) Variable-Name Restrictions A delimiter is required before and after a le name when it contains a number or lowercase letters. When the le name is uppercase alpha characters only, delimiters are optional. 160 OUTPUT 723;"VARDEF VAR,0;" 170 OUTPUT 723;"VAR EP;" De ne user-de ned variable, called VAR, equal to zero.
Language Reference VARDEF Description The VARDEF command creates a user-de ned variable and assigns it a value. User-de ned variables can be used in many of the spectrum-analyzer remote-control processes. Use user-de ned variables wherever user-de ned variable appears in the syntax diagrams. An error results if a variable name is the same as any reserved word. User-de ned variables occupy internal memory. Use the PURGE, FORMAT, or DISPOSE command to clear user-de ned variables from memory.
Language Reference VARIANCE Computes the amplitude variance of the speci ed trace, in measurement units. Item Source-Amplitude Range Description 0 { 10,000 measurement units for linear trace data. 032,768 { +32,767 measurement units for logarithmic trace data. Source-Length Range Example 3 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC. 140 OUTPUT 723;"SNGLS;TS;" 150 OUTPUT 723;"VARIANCE TRA?;" 7-528 Activate single-sweep mode and sweep measurement range.
Language Reference VARIANCE Description The VARIANCE command must be used as either a query or as a source in another analyzer-command function. Form a query by ending the VARIANCE statement with a question mark (?). When used as a query, VARIANCE gives the variance to the computer. Use VARIANCE as a source by incorporating the VARIANCE statement into the source of any command having prede ned function in its syntax diagram.
Language Reference VAVG Reduce amplitude variation of trace using digital averaging. Item Example Description Averaging-Length Range 0 { 10,000 Step Increment 1, 2, 5, 10 sequence Preset State VAVG OFF; VAVG 100 60 OUTPUT 723;"SNGLS;" 70 OUTPUT 723;"TS;" 80 OUTPUT 723;"VAVG EP;" Activate single-sweep mode. Sweep measurement range. Specify number of sweeps averaged. Enter value with front-panel controls, then press ACCEPT VALUE . Sweep.
Language Reference VAVG When video averaging is on, the take-sweep command (TS) resets the counter to 1, then initiates the number of sweeps speci ed for averaging. The counter is also reset to 1 whenever any command changes the measurement data. VAVG activates sample detection. Commands that follow VAVG are executed while the averaging routine is executing. However, if TS follows VAVG, subsequent commands after TS are not executed until the end of the averaging routine.
Language Reference VB Select post-detection, video-bandwidth lter to reduce noise oor of trace data. Item Example Description Bandwidth Range 1 { 3 kHz, or hardware limit. Coupling Sweep time (ST) is coupled to video bandwidth. Video bandwidth is coupled to resolution bandwidth (RB). Step Increment 1, 3, 10 sequence Preset State VB AUTO 140 OUTPUT 723;"VB 3KHZ;" 7-532 Set video bandwidth to 3 kHz.
Language Reference VB Description The VB command sets the post-detection, video-bandwidth lter. The video-bandwidth and sensitivity settings are coupled to yield the maximum amplitude response. Specifying a bandwidth with VB, or executing VB MAN breaks the coupling. To reestablish coupling, execute VB AUTO. There are two types of detectors used in conjunction with post-detection processing. The optical spectrum analyzer rmware automatically determines which detection mode to enable.
Language Reference VIEW Stop sweeping the trace and store trace data. Example Description See Also 120 OUTPUT 723;"CLRW TRB;BLANK TRA;" 130 OUTPUT 723;"VIEW TRB;" Measure with trace B. Blank trace A. View trace B. The VIEW command stops sweeping the speci ed trace and displays it.
Language Reference VTDL VTDL Control the video trigger display lines. Item Preset State Example Description Description VTDL OFF 100 OUTPUT 723;"VTDL ON;" The VTDL command displays two horizontal video trigger display lines: trigger level and hysteresis o set. The trigger level line is a line that is placed at a level which corresponds to the current video trigger level. On HP 70004A displays, the line is the same color as de ned for MARKERS. This is determined by the display's \Adjust Color" menu.
Language Reference VTDL command can be used to override the automatic operation. The displays work in logarithmic, linear volts, and linear watts display modes.
Language Reference VTH VTH Select slope of detected signal shape that triggers sweep. Item Range Example Description 6 300 dB Description Step Increment 1 major vertical division during log mode. 1 major vertical division at top graticule line (.915 dB) during linear mode. Preset State VTH 3DB 30 OUTPUT 723;"VTH;" The VTH command determines the video trigger hysteresis.
Language Reference VTH Query Response See Also TS, VTL, TM 7-538
Language Reference VTL VTL Select signal level that triggers sweep. Item Example Description Description Amplitude Range 6 300 dBm or hardware limit. Step Increment 1 major vertical division Preset State VTL -100DBM (or value at bottom of graticule). 10 OUTPUT 723;"VTL -50DBM;" During the video trigger mode, the sweep begins when the detected signal level has reached a speci c amplitude level. The VTL command speci es the amplitude level.
Language Reference VTL Query Response See Also TS, TM, VTH 7-540
Language Reference VW VW Blank or display graphics item. Example 50 OUTPUT 723;"IT 1;VW OFF;" 60 OUTPUT 723;"TEXT$This is item #1.$;" 70 OUTPUT 723;"IT 1;OR 300,600;" 80 OUTPUT 723;"VW ON;" Description See Also Address item 1. Blank item so that it is not seen while it is being de ned. De ne item 1 as text. Position item. Display item 1. The VW command blanks or displays graphics items that have been created with the IT command.
Language Reference WAIT Suspend program execution. Item Range Example Description Description 0 { 1000 seconds 130 OUTPUT 723;"TRDSP TRA,OFF;" 140 OUTPUT 723;"WAIT 2S;" 150 OUTPUT 723;"TRDSP TRA,ON;" Blank trace A. Suspend program operation for 2 seconds. Display trace A. The WAIT command suspends program execution for the speci ed time.
Language Reference WARN? WARN? Example Description Return a listing of all reported warning codes. 100 OUTPUT 723;";" 100 OUTPUT 723;"WARN?;" If no warnings have been displayed, the default value of 10000 is returned. Bit 1 of the status byte is used to report the presence of a warning. Refer to STB and related commands for other information concerning the status byte. The following list shows the possible error messages. Of course, user-de ned error messages are not included.
Language Reference WARN? Query Response See Also STB, USERWARN, WARN?, WARNCTRL, XWARN 7-544
Language Reference WARNCTRL WARNCTRL Enable or disable warning messages. 100 OUTPUT 723;";" 100 OUTPUT 723;"WARNCTRL ON;" Description The WARNCTRL command prevents the display and reporting of warnings. An instrument preset (IP command) enables warnings. If display of the active function area is disabled, the warning area will also be suppressed. Warnings can still be accessed via WARN and XWARN.
Language Reference WLLIMIT Extend wavelength measurement range. Item Preset State Example Description Description WLLIMIT ON 10 OUTPUT 723;"WLLIMIT OFF;" The WLLIMIT command extends the wavelength measurement range. The normal range (WLLIMIT ON) is from 600 nm to 1700 nm. The extended range (WLLIMIT OFF) is from 350 nm to 2000 nm (uncorrected). Query Response See Also Commands a ecting wavelength, such as CENTERWL, STARTWL, STOPWL, FS, and SP.
Language Reference WLMKRL WLMKRL Example Position the left power integration point to a location based upon the wavelength value entered. 100 OUTPUT 723;"CENTERWL 900NM;" 105 OUTPUT 723;"TS;" 110 OUTPUT 723;"WMLKRR 1000E 09;" 12 OUTPUT 723;"WLMKRL 800 NM;" Description See Also Set the center wavelength to 900 nm. Update the current trace. Position the right power integration point to 1000 nm. Position the left power integration point to 800 nm.
Language Reference WLMKRR Example Position the right power integration point to a location based upon wavelength value entered. 100 OUTPUT 723;"CENTERWL 900NM;" 105 OUTPUT 723;"TS;" 110 OUTPUT 723;"WMLKRR 1000E09;" 12 OUTPUT 723;"WLMKRL 800 NM;" Description See Also Set the center wavelength to 900 nm. Update the current trace. Position the right power integration point to 1000 nm. Position the left power integration point to 800 nm.
Language Reference WLOFFSET WLOFFSET O set wavelength scale for all absolute wavelength readouts, inputs, and outputs. Item Example Description Description O set range Actual range limited by hardware. Step Increment For spans greater than 0, the step increment is span/10. For zero span, the step increment is the resolution bandwidth.
Language Reference WLOFFSET Query Response See Also WLOFFSET value is returned as measurement units. Measurement units = 100 2 value in dBm. Commands a ecting wavelength, such as CENTERWL, STARTWL, STOPWL, FS, and SP.
Language Reference WLUNITS WLUNITS Convert trace position units to wavelength. Item Description Reference-Trace Length Range 3 { 2048 position units. Default is 800 when using TRA, TRB, TRC. Source Range 1 to 2048 position units. Reference-Trace-Amplitude Range 0 { 10,000 measurement units for linear trace data. 032,768 { +32,767 measurement units for logarithmic trace data.
Language Reference WLUNITS Example Determine the wavelength that corresponds to a point's relative position on a trace. 10 20 30 40 50 60 CLEAR 723 OUTPUT 723;"IP;"; OUTPUT 723;"CLRDSP;" OUTPUT 723;"PU;PA 200,700;" OUTPUT 723;"TEXT$8th element is $;" OUTPUT 723;"DSPLY WLUNITS 8,TRA,7,2;" 70 OUTPUT 723;"TEXT$M$;" Description Initialize analyzer. Clear graphics from memory. Place pen up, then move it to (200,700). Write text. Display wavelength value of 8th element in trace A. Print \M" after variable.
Language Reference WLUNITS Predened-Function Syntax 7-553
Language Reference WLUNITS Query Syntax Query Response 7-554
Language Reference XAMPSW XAMPSW Example Description CAUTION Activate the rear-panel TRANS-Z INPUT connector. 10 OUTPUT 723;"XAMPSW ON;" The XAMPSW command allows input via the rear-panel TRANS-Z INPUT connector. Normally, the output of the optical spectrum analyzer's internal photodetector connects to a transimpedance ampli er. Using the ON argument switches the ampli er's input from the photodetector to the rear-panel TRANS-Z INPUT connector.
Language Reference XCH Exchange source contents.
Language Reference XCH Item Source or Destination Amplitude Range Description 0 { 10,000 measurement units for linear trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 032,768 { +32,767 measurement units for logarithmic trace data in TRA, TRB, TRC, trace range, or user-de ned trace. 6 1.8 2 10308 when using number, prede ned variable, or user-de ned variable. Source-Length Range Example 1 { 2048 position units. Default is 800 position units when using TRA, TRB, TRC.
Language Reference XERR Return error information. Example 140 ALLOCATE Error$[200] 150 OUTPUT 723;"JKLD;" 160 OUTPUT 723;"VB -2NM;" 170 180 190 200 OUTPUT 723;"CLRW;" OUTPUT 723;"WAIT 2S;" OUTPUT 723;"XERR?;" ENTER 723 USING "-K";Error$ 210 PRINT Error$ Description Send the spectrum analyzer a meaningless command. Attempt to set the spectrum analyzer to an unavailable video bandwidth. Send the spectrum analyzer illegal syntax. Wait 2 seconds. Query reported errors to computer.
Language Reference XWARN XWARN Return an extended listing of all reported warnings. 100 OUTPUT 723;";" 100 OUTPUT 723;"XWARN?;" Description If no warnings have been displayed, the default value of 10000 is returned. Bit 5 of the status byte is used to report the presence of a warning Refer to STB and related commands for other information concerning the status byte. The following list shows the possible error messages. Of course, user-de ned error messages are not included.
Language Reference XWARN Query Response See Also STB, USERWARN, WARN?, WARNCTRL, XWARN 7-560
Language Reference ZERO ZERO Enable automatic zeroing of photo-diode's dark current.