Tektronix Optical Signals User manual
xx
Optical Signals
ZZZ
Application Plug-in
Programmer Manual
*P077125000*
077-1250-00
xx
Optical Signals
ZZZ
Application Plug-in
Programmer Manual
www.tek.com
077-1250-00
Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries
or suppliers, and are protected by national copyright laws and international treaty provisions.
Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication
supersedes that in all previously published material. Specifications and price change privileges reserved.
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
®
SourceXpress
is a registered trademark of Tektronix, Inc.
Contacting Tektronix
Tektronix, Inc.
14150 SW Karl Braun Drive
P.O. Box 5 0 0
Beaverto
USA
For product information, sales, service, and technical support:
n, OR 97077
In North America, call 1-800-833-9200.
Worldwide, visit www.tek.com to find contacts in your area.
Table of Contents
Getting Started
Introducti
Documentation............. .................................. ................................ ..................... 1-2
on ........................ ................................ ................................ ............... 1-1
Syntax and Commands
Command Syntax.................................... ................................ ............................. 2-1
Command G
Control commands.................... ................................ ................................ ....... 2-3
Compile commands .................................... ................................ ..................... 2-3
Setup commands ............................................................................................. 2-4
Modulation commands ............... .................................. ................................ ..... 2-4
Custom modulation commands . ................................ ................................ ........... 2-4
Data s
Filter commands .......... ................................ ................................ ................... 2-7
IQ impairments commands ................................................................................. 2-7
S-Parameter commands ........................ ................................ ............................. 2-8
Commands in alphabetical order......................... ................................ ..................... 2-11
roups ................................................................................................ 2-3
ource commands......................... ................................ ............................. 2-5
Optical Signals Plug-in Programmer Manual i
Table of Contents
ii Optical Signals Plug-in Programmer Manual
Getting Started
Introduction
This programmer manual provides information on how to use commands for
remotely controlling the Optical Signals plug-in application.
The Optical Signals plug-in can be installed in either the SourceXpress software
application or an AWG70000A series arbitrary waveform generator.
Communication with the plug-in is through the SourceXpress programmatic
interface or the AWG70000A series instrument’s programmatic interface. Using
a single VISA or raw socket session, it is possible to communicate with both
SourceXpress and AWG70000A series instruments.
For information on the Remote Control, GPIB Parameters, LAN Parameters,
Connecting to the Instrument using GPIB, and Setting up GPIB Communication,
refer to t
Manual.
he AWG70000A series Arbitrary Waveform Generators Programmer
Optical Signals Plug-in Programmer Manual 1-1
Documentation
Documentation
In addition to this Optical Signals Programmer Guide, the following
documentation is included with this application:
Optical Signals Help. The help provides in-depth operation and user interface
help.
Optical Signals User Manual (PDF). This is adapted from the Optical Signal
help system.
1-2 Optical Signals Plug-in Programmer Manual
Syntax and Commands
Command Syntax
For information on the Syntax Overview, Command and Query Structure,
Clearing the Instrument, Command Entry, Parameter Types, SCPI Commands
and Queries,
Programmer Manual.
refer to the AWG70000A Series Arbitrary Waveform Generators
Optical Signals Plug-in Programmer Manual 2-1
Command Syntax
2-2 Optical Signals Plug-in Programmer Manual
Command Groups
Control comma
nds
Table 2-1: Control commands and their descriptions
Command Descriptio
WPLugin:AC
OPTical:RESet Resets the Optical signal plug-in by setting all the values within the module to their
Tive
Sets or retu
of the other PI commands of the active plug-in.
default values.
n
rns the active waveform creation plug-in. This command allows the use
Compile commands
Table 2-
Command Description
OPTical:COMPile Compiles and generates a waveform using the Optical plug-in compile settings.
OPTical:COMPile:CANCel Cancels a compilation currently in progress.
OPTical:COMPile:CORRection:APPLy:X Sets or returns the Apply Corrections to X state (enabled or disabled) for the Compile
OPTical:COMPile:CORRection:APPLy:Y Sets or returns the Apply Corrections to Y state (enabled or disabled) for the Compile
OPTi
OPTical:COMPile:CORRection:PATH:Y Sets or returns the path of the corrections file to apply to the Y data source during
OPTical:COMPile:NAMe Sets or returns the prefix to use to name the compiled waveforms.
OPTical:COMPile:PLAY Sets or returns the Play after assign state (enabled or disabled) for the Compile
O
O
OPTical:COMPile:WLENgth:WAUto Sets or returns if the waveform length will be automatically calculated at compile time.
OPTical:COMPile:WOVerwrite Sets or returns the Overwrite existing waveform state (enabled or disabled) for
OPTical:COMPile:XICHannel Sets or returns which channel the X data source I waveform is assigned to upon
OPTical:COMPile:XQCHannel Sets or returns which channel the X data source Q w aveform is assigned to upon
OPTical:COMPile:XWLength Sets or returns the X-Polarized waveform length.
OPTical:COMPile:YICHannel Sets or returns which channel the Y data source I waveform is assigned to upon
2: Compile commands and their descriptions
cal:COMPile:CORRection:PATH:X
PTical:COMPile:SRATe
PTical:COMPile:SRATe:AUTO
Settings.
ings.
Sett
or returns the path of the corrections file to apply to the X data source during
Sets
compile.
compile.
ttings.
Se
ets or returns the sampling rate for the compile settings.
S
ets or returns the value that indicates if the sampling rate will be automatically
S
calculated at compile time.
compiling waveforms.
compile.
compile.
compile.
Optical Signals Plug-in Programmer Manual 2-3
Command Groups
Table 2-2: Compile commands and their descriptions (cont.)
Command Description
OPTical:COMPile:YQCHannel Sets or returns which channel the Y data source Q waveform is assigned to upon
compile.
OPTical:COMPile:YWLength Sets or returns the Y-Polarized waveform length.
Setup commands
Table 2-3: Setup commands and their descriptions
Command Description
OPTical:MODE Sets or returns the Optical Polarization mode, Single or Dual.
OPTical:BRATe Sets or returns the Baud Rate of the optical signal.
OPTical:XPOLarization:BBOFfset Sets or returns the Base Band Offset of X-Polarized optical
signals.
OPTical:YPOLarization:BBOFfset Sets or returns the Base Band Offset of Y-Polarized optical
signals.
Modulation commands
Table 2-4: Modulation commands and their descriptions
Command Description
OPTical:MODulation Sets or returns the Modulation type, using either predefined
modulation types or using specific modulation parameters.
OPTical[:PREDefined]:PAM Sets or returns the PAM modulation type.
OPTical[:PREDefined]:PAM:NVAlue Sets or returns the PAM Normalized Level of the specified index
in the PAM table.
OPTical[:PREDefined]:PSK Sets or returns the PSK modulation type.
OPTical[:PREDefined]:QAM Sets or returns the QAM modulation type.
OPTical[:PREDefined]:TYPE Sets or returns the modulation type when using a predefined
type.
Custom modulation commands
Table 2-5: Custom modulation commands and their descriptions
Command Description
OPTical:CMODulation:ADDMap Adds the specified number of maps to the Custom Modulation
map.
OPTical:CMODulation:DELMap Deletes a single map from the Custom Modulation table.
2-4 Optical Signals Plug-in Programmer Manual
Command Groups
Table 2-5: Custom modulation commands and their descriptions (cont.)
Command Description
OPTical:CMODulation:ISYMbol Sets or returns the I symbol value of the currently selected
Custom Modulation map.
OPTical:CMODulation:MMODe Sets or returns the Modulation mode for the Custom Modulation.
OPTical:CMODulation:MOFFset Sets or returns the O ffset modulation state (enabled or disabled)
for Custom Modulation.
OPTical:CMODulation:QSYMbol Sets or returns the Q symbol value of the currently selected
Custom Modulation map.
OPTical:CMODulation:SELMap Sets or returns the selected m ap in the Custom Modulation table.
Data source commands
Table 2-6: Data source commands and their descriptions
Command Description
OPTical:XPOLarization:DSEBit:DATA Sets or returns the X-Polarization Data Pattern type for the
specified Bit index when the X Data Source is set to define a
pattern type for each bit.
OPTical:XPOLarization:DSEBit:DATA:FILE Sets or returns the X-Polarization Data Pattern file and file path
for the specified Bit index when the X Data Source is set to
define a pattern type for each bit.
OPTical:XPOLarization:DSEBit:DATA:PATTern Sets or returns the X-Polarization D ata Pattern for the specified
Bit index when the X Data Source is set to define a pattern type
for each bit.
OPTical:XPOLarization:DSEBit:DATA:PRBS Sets or returns the X-Polarization PBRS data type for the
specified Bit index when the X Data Source is set to define a
pattern type for each bit.
OPTical:XPOLarization:DSEBit:DATA:PRBS:UDEFined:
PLOYnomial
OPTical:XPOLarization:DSEBit:DATA:PRBS:UDEFined:RESet Resets the X-Polarization User Defined PRB S polynomial
OPTical:XPOLarization:DSEBit:DATA:PRBS:UDEFined:
SREGister
OPTical:XPOLarization:DSTYpe Sets or returns the Data Source Pattern type of the X-Polarized
OPTical:XPOLarization[:SDSource]:DATA Sets or returns the X-Polarization Data Pattern type when the X
Sets or returns the X-Polarization PRBS Polynomial Expression
for the User Defined PRBS for the specified Bit index when the X
Data Source is set to define a pattern type for each bit.
expression and shift register to their default values for the
specified Bit index when the X Data Source is set to define a
pattern type for each bit.
Sets or returns the X-Polarization PRBS Polynomial Shift
Register Initial Value for the User Defined PRBS for the specified
Bit index when the X Data Source is set to define a pattern type
for each bit.
optical signal.
Data Source is set to use a single data source.
Optical Signals Plug-in Programmer Manual 2-5
Command Groups
Table 2-6: Data source commands and their descriptions (cont.)
Command Description
OPTical:XPOLarization[:SDSource]:DATA:FILE Sets or returns the X-Polarization Data Pattern file and file path
when the X Data Source is set to use a single data source.
OPTical:XPOLarization[:SDSource]:DATA:PATTern Sets or returns the X -Polarization user defined data pattern when
the X Data Source is set to use a single data source.
OPTical:XPOLarization[:SDSource]:DATA:PRBS Sets or returns the X-Polarization PBRS data type when the Data
Source Pattern is set to PRBS when the X Data Source is set to
use a single data source.
OPTical:XPOLarization[:SDSource]:DATA:PRBS:UDEFined:
POLYnomial
OPTical:XPOLarization[:SDSource]:DATA:PRBS:UDEFined:
RESet
OPTical:XPOLarization[:SDSource]:DATA:PRBS:UDEFined:
SREGister
OPTical:YPOLarization:DSEBit:DATA Sets or returns the Y-Polarization Data Pattern type for the
OPTical:YPOLarization:DSEBit:DATA:FILE Sets or returns the Y-Polarization Data Pattern file and file path
OPTical:YPOLarization:DSEBit:DATA:PATTern Sets or returns the Y-Polarization Data Pattern for the specified
OPTical:YPOLarization:DSEBit:DATA:PRBS Sets or returns the Y-Polarization PBRS data type for the
OPTical:YPOLarization:DSEBit:DATA:PRBS:UDEFined:
PLOYnomial
OPTical:YPOLarization:DSEBit:DATA:PRBS:UDEFined:RESet Resets the Y-Polarization User Defined PRBS polynomial
OPTical:YPOLarization:DSEBit:DATA:PRBS:UDEFined:
SREGister
OPTical:YPOLarization:DSTYpe Sets or returns the Data Source Pattern type of the Y-Polarized
OPTical:YPOLarization[:SDSource]:DATA Sets or returns the Y-Polarization Data Pattern type when the Y
Sets or returns the X-Polarization PRBS Polynomial Expression
for the User Defined PRBS when the X Data Source is set to
use a single data source.
Resets the X-Polarization User Defined PRBS polynomial
expression and shift register to their default values when the X
Data Source is set to use a single data source.
Sets or returns the X-Polarization PRBS Polynomial Shift
Register Initial Value for the User Defined PRBS when the X
Data Source is set to use a single data source.
specified Bit index when the Y Data Source is set to define a
pattern type for each bit.
for the specified Bit index when the Y Data Source is set to
define a pattern type for each bit.
Bit index when the Y Data Source is set to define a pattern type
for each bit.
specified Bit index when the Y Data Source is set to define a
pattern type for each bit.
Sets or returns the Y-Polarization PRBS Polynomial Expression
for the User Defined PRBS for the specified Bit index when the Y
Data Source is set to define a pattern type for each bit.
expression and shift register to their default values for the
specified Bit index when the Y Data Source is set to define a
pattern type for each bit.
Sets or returns the Y-Polarization PRBS Polynomial Shift
Register Initial Value for the User Defined PRBS for the specified
Bit index when the Y Data Source is set to define a pattern type
for each bit.
optical signal.
Data Source is set to use a single data source.
2-6 Optical Signals Plug-in Programmer Manual
Command Groups
Table 2-6: Data source commands and their descriptions (cont.)
Command Description
OPTical:YPOLarization[:SDSource]:DATA:FILE Sets or returns the Y-Polarization Data Pattern file and file path
when the Y Data Source is set to use a single data source.
OPTical:YPOLarization[:SDSource]:DATA:PATTern Sets or returns the Y-Polarization user defined data pattern when
the Y Data Source is set to use a single data source.
OPTical:YPOLarization[:SDSource]:DATA:PRBS Sets or returns the Y-Polarization PBRS data type when the Data
Source Pattern is set to PRBS when the Y Data Source is set to
use a single data source.
OPTical:YPOLarization[:SDSource]:DATA:PRBS:UDEFined:
POLYnomial
OPTical:YPOLarization[:SDSource]:DATA:PRBS:UDEFined:
RESet
OPTical:YPOLarization[:SDSource]:DATA:PRBS:UDEFined:
SREGister
Sets or returns the Y-Polarization PRBS Polynomial Expression
for the User Defined PRBS when the Y Data Source is set to
use a single data source.
Resets the Y-Polarization User Defined PRBS polynomial
expression and shift register to their default values when the Y
Data Source is set to use a single data source.
Sets or returns the Y-Polarization PRBS Polynomial Shift
Register Initial Value for the User Defined PRBS when the Y
Data Source is set to use a single data source.
Filter commands
Table 2-7: Filter commands and their descriptions
Command Description
OPTical:FILTer:ALPHa Sets or returns the Alpha (filter roll off) value.
OPTical:FILTer:CLENgth Sets or returns the Filter Convolution Length in symbols.
OPTical:FILTer:FILe Sets or returns the path of the filter fileforuserdefined filter.
OPTical:FILTer:TYPE Sets or returns the Filter Type.
IQ impairments commands
Table 2-8: IQ impairments commands and their descriptions
Command Description
OPTical:IQIMpairment:CLEAkage:IOFFset Sets or returns the I Offset percentage for C arrier Leakage for IQ
Impairments.
OPTical:IQIMpairment:CLEAkage:IQOFfset Sets or returns the IQ Offset level for Carrier Leakage for IQ
Impairments.
OPTical:IQIMpairment:CLEAkage:QOFFset Sets or returns the Q Offset percentage for Carrier Leakage for
IQ Impairments.
OPTical:IQIMpairment:CLEAkage:TON Sets or returns the Carrier Leakage state (enabled or disabled)
for IQ Impairments.
Optical Signals Plug-in Programmer Manual 2-7
Command Groups
Table 2-8: IQ impairments commands and their descriptions (cont.)
Command Description
OPTical:IQIMpairment:IQIMbalance:IMBalance Sets or returns the Imbalance percentage for IQ Imbalance for
IQ Impairments.
OPTical:IQIMpairment:IQIMbalance:TON Sets or returns the IQ Imbalance state (enabled or disabled)
for IQ Impairments.
OPTical:IQIMpairment:IQSWap:TON Sets or r eturns the Swap I & Q state (enabled or disabled) for IQ
Impairments.
OPTical:IQIMpairment:NLDistortion:AM2K Sets or returns the k2 level for AM/AM Nonlinear Distortions for
IQ Impairments.
OPTical:IQIMpairment:NLDistortion:AM3K Sets or returns the k3 level for AM/AM Nonlinear Distortions for
IQ Impairments.
OPTical:IQIMpairment:NLDistortion:PM2K Sets or returns the k2 level for AM/PM Nonlinear Distortions for
IQ Impairments.
OPTical:IQIMpairment:NLDistortion:PM3K Sets or returns the k3 level for AM/PM Nonlinear Distortions for
IQ Impairments.
OPTical:IQIMpairment:NLDistortion:TON Sets or returns the Nonlinear Distortions state (enabled or
disabled) for IQ Impairments.
OPTical:IQIMpairment:QERRor:ERRor Sets or returns the I/Q Error percentage for Quadrature Error
for IQ Impairments.
OPTical:IQIMpairment:QERRor:TON Sets or returns the Quadrature Error state (enabled or disabled)
for IQ Impairments.
S-Parameter commands
Table 2-9: S-Parameter commands and their descriptions
Command Description
OPTical:SPARameter:MODE Sets or returns the S-Parameter mode (Cascading or
Non-Cascading).
OPTical:SPARameter:SFORmat Sets or returns the currently used signal format for all
S-Parameter values.
OPTical:SPARameter:SFORmat:LPOLarizations Sets or returns the S-Parameters Couple Settings state (enabled
or disabled).
OPTical:SPARameter:TON Sets or returns the S-Parameter state (enabled or disabled).
OPTical:SPARameter:BANDwidth Sets or returns the S-Parameter bandwidth when setting
manually.
OPTical:SPARameter:BANDwidth:AUTO Sets or returns the S-P arameter automatic bandwidth calculation
setting.
OPTical:SPARameter:CASCading:AGGRessor2[:ENABle] Sets or returns the aggressor 2 signal type state (enabled or
disabled) in Cascading mode.
OPTical:SPARameter:CASCading:AGGRessor[n]:AMPLitude Sets or returns the specified Aggressor's amplitude, in Cascading
mode.
2-8 Optical Signals Plug-in Programmer Manual
Command Groups
Table 2-9: S-Parameter commands and their descriptions (cont.)
Command Description
OPTical:SPARameter:CASCading:AGGRessor[n]:CTALk Sets or returns the specified Aggressor's crosstalk type, in
Cascading mode.
OPTical:SPARameter:CASCading:AGGRessor[n]:DRATe Sets or returns the specified Aggressor's data rate, in Cascading
mode.
OPTical:SPARameter:CASCading:AGGRessor[n]:SIGNal Sets or returns specified A ggressor's signal type, in Cascading
mode.
OPTical:SPARameter:CASCading:AGGRessor[n]:SIGNal:FILE Sets or returns the filepath to the aggressor file for the specified
Aggressor, in Cascading mode.
OPTical:SPARameter:CASCading:AGGRessor[n]:SIGNal:PRBS Sets or returns the specified Aggressor's PRBS signal type, in
Cascading mode.
OPTical:SPARameter:CASCading:DEEMbed Sets or returns whether the Cascading S-Parameters is to
de-embed (invert) the S-Parameters, in Cascading mode.
OPTical:SPARameter:CASCading:STAGe[m]:DRX[n] Sets or returns the S-Parameter port assignment of the specified
Stage and the channel’s specified receiver port number (Rx-Port)
in Cascading mode and Differential Signalling Scheme (where
applicable).
OPTical:SPARameter:CASCading:STAGe[m]:DTX[n] Sets or returns the S-Parameter port assignment of the specified
Stage and the channel’s specified transmission port number
(Tx-Port) in Cascading mode and Differential S ignalling Scheme
(where applicable).
OPTical:SPARameter:CASCading:STAGe[m]:ENABle Sets or returns the state of the specified Cascaded S-Parameter
stage (enabled or disabled).
OPTical:SPARameter:CASCading:STAGe[m]:FILE Sets or returns the filepath for the specified S -Parameters
Cascading Stage, in Cascading mode.
OPTical:SPARameter:CASCading:STAGe[m]:RX[n] Sets or returns the S-Parameter port assignment of the specified
Stage and the channel’s specified receiver port number (Rx-Port)
in Cascading mode and Single-Ended Signalling Scheme ( where
applicable).
OPTical:SPARameter:CASCading:STAGe[m]:SSCHeme Sets or returns the S-Parameter Signalling Scheme, in
Cascading mode.
OPTical:SPARameter:CASCading:STAGe[m]:TX[n] Sets or returns the S-Parameter port assignment of the specified
Stage and the channel’s specified transmission port number
(Tx-Port) in Cascading mode and Single-Ended Signalling
Scheme (where applicable).
OPTical:SPARameter:CASCading:STYPe Sets or returns S-Parameter signal type (victim or aggressor), in
Cascading mode.
OPTical:SPARameter:CASCading:TYPE Sets or returns the S-Parameter number of ports, in Cascading
mode.
OPTical:SPARameter:NCAScading:AGGRessor2[:ENABle] Sets or returns the aggressor 2 signal type state (enabled or
disabled) in Non-Cascading mode.
OPTical:SPARameter:NCAScading:AGGRessor[n]:AMPLitude Sets or returns the specified Aggressor's amplitude, in
Non-Cascading mode.
Optical Signals Plug-in Programmer Manual 2-9
Command Groups
Table 2-9: S-Parameter commands and their descriptions (cont.)
Command Description
OPTical:SPARameter:NCAScading:AGGRessor[n]:CTALk Sets or returns the specified Aggressor's crosstalk type, in
Non-Cascading mode.
OPTical:SPARameter:NCAScading:AGGRessor[n]:DRATe Sets or returns the specified Aggressor's data rate, in
Non-Cascading mode.
OPTical:SPARameter:NCAScading:AGGRessor[n]:SIGNal Sets or returns specified Aggressor's signal type, in
Non-Cascading mode.
OPTical:SPARameter:NCAScading:AGGRessor[n]:SIGNal:FILE Sets or returns the filepath to the aggressor file for the specified
Aggressor, in Non-Cascading mode.
OPTical:SPARameter:NCAScading:AGGRessor[n]:SIGNal:
PRBS
OPTical:SPARameter:NCAScading:DEEMbed Sets or returns whether the Non-Cascading S-Parameters is to
OPTical:SPARameter:NCAScading:DRX[n] Sets or returns the S-Parameter port assignment of the channel’s
OPTical:SPARameter:NCAScading:DTX[n] Sets or returns the S-Parameter port assignment of the channel’s
OPTical:SPARameter:NCAScading:FILE Sets or returns the filepath and file name of the S-Parameter
OPTical:SPARameter:NCAScading:LAYout Sets or returns the 4 port S-Parameter Matrix Configuration, in
OPTical:SPARameter:NCAScading:RX[n] Sets or returns the S-Parameter port assignment of the channel’s
OPTical:SPARameter:NCAScading:SSCHeme Sets or returns the S-Parameter Signalling Scheme, in
OPTical:SPARameter:NCAScading:STYPe Sets or returns S-Parameter signal type (victim or aggressor), in
OPTical:SPARameter:NCAScading:TX[n] Sets or returns the S-Parameter port assignment of the channel’s
OPTical:SPARameter:NCAScading:TYPE Sets or returns the S-Parameter number of ports, in
Sets or returns the specified Aggressor's PRBS s ignal type, in
Non-Cascading mode.
de-embed (invert) the S-Parameters, in Non-Cascading mode.
specified receiver port number (Rx-Port) in Non-Cascading mode
and Differential S ignalling Scheme (where applicable).
specified transmission port number (Tx-Port) in Non-Cascading
mode and Differential Signalling Scheme (where applicable).
file, in Non-Cascading mode.
Non-Cascading mode.
specified receiver port number (Rx-Port) in Non-Cascading mode
and Single-Ended Signalling Scheme (where applicable).
Non-Cascading mode. Signalling Scheme is only available when
the Number of Ports is set to 4, 8, or 12.
Non-Cascading mode.
specified transmission port number (Tx-Port) in Non-Cascading
mode and Single-Ended Signalling Scheme (where applicable).
Non-Cascading mode.
2-10 Optical Signals Plug-in Programmer Manual
Commands in alphabetical order
This section contains all available commands. They are presented in alphabetical
order.
Use the Command Groups section to simplify navigating to specific groups
of commands.
OPTical:BRATe
This command sets or returns the Baud Rate of the optical signal.
Group
Syntax
Arguments
Returns
Examples
Setup
OPTical:BRATe <baudrate>
OPTical:BRATe
<baudrate>::= <NR3> value.
A single <NR3> value.
OPTICAL:BRATE 1E9 setstheBaudRateto1GHz.
OPTICAL:BRATE? might return 900.0000000000E+6, indicating that the Baud
Rate is set to 900 MHz.
OPTical:CMODulation:ADDMap (No Query Form)
This command adds the specified number of maps to the Custom Modulation map.
Group
Syntax
Arguments
Examples
Optical Signals Plug-in Programmer Manual 2 -11
Custom modulation
OPTical:CMODulation:ADDMap <maps>
<maps>::= <NR1> value.
OPTICAL:CMODULATION:ADDMAP 2 adds 2 new maps at the end of the Custom
Modulation table.
Commands in alphabetical order
OPTical:CMOD
ulation:DELMap (No Query Form)
This command deletes a single map from the Custom Modulation table.
Group
Syntax
Arguments
Examples
Custom modulation
OPTical:CMODulation:DELMap <index>
<index>::= <NR1> value.
OPTICAL:CMODULATION:DELMAP 2 deletes map 2 in the Custom Modulation
table.
OPTical:CMODulation:ISYMbol
mmand sets or returns the I symbol value of the currently selected Custom
om modulation
Group
This co
Modulation map.
Cust
Syntax
Related Commands
guments
Ar
Returns
Examples
OPTical:CMODulation:ISYMbol <I_symbol>
OPTical:CMODulation:SELMap
<I_symbol>::= <NR2> value.
A single <NR2> value.
OPTICAL:CMODULATION:ISYMBOL 25 sets the I symbol value of the currently
selected map to 25.
OPTICAL:CMODULATION:ISYMBOL? might return 5.0000000000, indicating
that the I symbol value o f the currently selected map is set to 5.
2-12 Optical Signals Plug-in Programmer Manual
Commands in alphabetical order
OPTical:CMOD
Arguments
Examples
ulation:MMODe
This command sets or returns the Modulation mode for the Custom Modulation.
Group
Syntax
Returns
Custom modulation
OPTical:CMODulation:MMODe {NORMal|DIFFerential}
OPTical:CMODulation:MMODe?
NORMal
DIFFerential
NORM
DIFF
OPTICAL:CMODULATION:MMODE NORM sets the Modulation mode for Custom
Modulation to Normal.
OPTICAL:CMODULATION:MMODE? might return DIFF, indicating that the
Modulation mode for Custom Modulation is set to Differential.
OPTical:CMODulation:MOFFset
This command sets or returns the Offset modulation state (enabled or disabled)
for Custom Modulation.
Group
Syntax
Arguments
Returns
Custom modulation
OPTical:CMODulation:MOFFset {1|0|ON|OFF}
OPTical:CMODulation:MOFFset?
OFF or 0 disables Offset modulation. OFF or 0 is the default value.
ON or 1 enables Offset modulation.
A single <Boolean> value.
Optical Signals Plug-in Programmer Manual 2-13
Commands in alphabetical order
Examples
OPTICAL:CMODU
OPTICAL:CMODULATION:MOFFSET? might return 0, indicating that Offset
modulation is
OPTical:CMODulation:QSYMbol
This command sets or returns the Q symbol value of the currently selected
Custom Modulation map.
Group
Syntax
Related Commands
Arguments
Custom modulation
OPTical:CMODulation:QSYMbol <Q_symbol>
OPTical:CMODulation:SELMap
<Q_symbol>::= <NR2> valu
LATION:MOFFSET 1
disabled.
e.
enables Offset modulation.
Returns
Examples
A single <NR2> value.
OPTICAL:CMODULATION:QSYMBOL 25 sets the Q symbol value of the currently
selected map to 25.
OPTICAL:CMODULATION:QSYMBOL? might return 5.0000000000, indicating
that the Q symbol value of the currently selected map is set to 5.
OPTical:CMODulation:SELMap
This command sets or returns the selected map in the Custom Modulation table.
Group
Syntax
Arguments
Custom modulation
OPTical:CMODulation:SELMap <index>
OPTical:CMODulation:SELMap?
<index>::= <NR1> value.
Returns
2-14 Optical Signals Plug-in Programmer Manual
A single <NR1> value.
Commands in alphabetical order
Examples
OPTICAL:CMODU
Modulation table.
OPTICAL:CMOD
the second map in the Custom Modulation table is selected.
OPTical:COMPile (No Query Form)
This command compiles and generates a waveform using the Optical plug-in
compile settings.
The active plug-in must be Optical signal.
Conditio
ns
Group
Syntax
This is an overlapping command. Overlapping commands run c oncurrently with
other commands, allowing additional commands to start before the overlapping
command has finished.
Compile
OPTical:COMPile
LATION:SELMAP 3
ULATION:SELMAP?
selects the third map in the Custom
might return 2.00 00000000, indicating that
Examples
OPTICAL:COMPILE compiles and generates the waveforms.
OPTical:COMPile:CANCel (No Query Form)
s command cancels a compilation currently in progress.
Thi
Conditions
Group
Syntax
Examples
The active plug-in must be Optical signal.
Compile
OPTical:COMPile:CANCel
OPTICAL:COMPILE:CANCEL immediately ends the current compile process.
Optical Signals Plug-in Programmer Manual 2-15
Commands in alphabetical order
OPTical:COMP
Related Commands
Arguments
Examples
ile:CORRection:APPLy:X
This command sets or returns the Apply Corrections to X state (enabled or
disabled) for the Compile Settings.
Group
Syntax
Returns
Compile
OPTical:COMPile:CORRection:APPLy:X {1|0|ON|OFF}
OPTical:COMPile:CORRection:APPLy:X?
OPTical:COMPile:CORRection:PATH:Y
OFF or 0 disables Apply Corre
ON or 1 enables Apply Corrections to X.
A single <Boolean> value.
OPTICAL:COMPILE:CORRECTION:APPLY:X ON enables Apply Corrections
to X.
ctions to X. OFF or 0 is the default value.
OPTICAL:COMPILE:CORRECTION:APPLY:X? might return 0, indicating that
Apply Corrections to X is disabled.
OPTical:COMPile:CORRection:APPLy:Y
This command sets or returns the Apply Corrections to Y state (enabled or
disabled) for the Compile Settings.
Group
Syntax
Related Commands
Arguments
Compile
OPTical:COMPile:CORRection:APPLy:Y {1|0|ON|OFF}
OPTical:COMPile:CORRection:APPLy:Y?
OPTical:COMPile:CORRection:PATH:Y
OFF or 0 disables Apply Corrections to Y. OFF or 0 is the default value.
ON or 1 enables Apply Corrections to Y.
2-16 Optical Signals Plug-in Programmer Manual
Commands in alphabetical order
Returns
Examples
A single <Boole
OPTICAL:COMPILE:CORRECTION:APPLY:Y ON enables Apply Corrections
to Y.
OPTICAL:COMPILE:CORRECTION:APPLY:Y? might return 0, indicating that
Apply Corrections to Y is disabled.
an> value.
OPTical:COMPile:CORRection:PATH:X
This command sets or returns the path of the corrections file to apply to the X
data source during compile.
Group
Syntax
Arguments
Compile
OPTical:COMPile:CORRection:PATH:X <filepath>
OPTical:COMPile:CORRection:PATH:X?
<filepath>::=<string> defines path to the corrections file.
Returns
Examples
Asingle<filepath> string.
OPTICAL:COMPILE:CORRECTION:PATH:X
"C:\temp\XCorrectionFile.corr"
filename for the X data source.
OPTICAL:COMPILE:CORRECTION:PATH:X? might return
"C:\temp\XCorrectionFile.corr".
OPTical:COMPile:CORRection:PATH:Y
This command sets or returns the path of the corrections file to apply to the Y
data source during compile.
Group
Syntax
Arguments
Compile
OPTical:COMPile:CORRection:PATH:Y <filepath>
OPTical:COMPile:CORRection:PATH:Y?
<filepath>::=<string> defines path to the corrections file.
sets the Correction File's path and
Optical Signals Plug-in Programmer Manual 2-17
Commands in alphabetical order
Returns
Examples
OPTical:COMPile:NAMe
Group
Syntax
Asingle<filepa
OPTICAL:COMPILE:CORRECTION:PATH:Y
"C:\temp\YCorrectionFile.corr"
filename for the Y data source.
OPTICAL:COMPILE:CORRECTION:PATH:Y? might return
"C:\temp\YCorrectionFile.corr".
This commands sets or returns the prefix to use to name the compiled waveforms.
Compile
OPTical:COMPile:NAMe <signal_name>
OPTical:COMPile:NAMe?
th> string.
sets the Correction File's path and
Arguments
Returns
Examples
OPTical:COMPile:PLAY
Group
<signal_name>::= <string> defines the prefix for the signal names.
<string>
OPTICAL:COMPILE:NAME "OpticalWfm" sets the waveform name prefixto
OpticalWfm.
OPTICAL:COMPILE:NAME? might return "OpticalWfm".
This command sets or returns the Play after assign state (enabled or disabled) for
the Compile Settings.
Play after assign is active only when Compile and assign is enabled.
Compile
Syntax
2-18 Optical Signals Plug-in Programmer Manual
OPTical:COMPile:PLAY {0|1|OFF|ON}
OPTical:COMPile:PLAY?
Loading...