:CONFigure:IMPairment:ACTive?
Command Syntax
:CONFigure:IMPairment:ACTive "<impairment-name>", {ON | OFF}
Where <impairment-name> is the name that identifies the Impairment block on the Hardware Diagram.
Query Syntax
:CONFigure:IMPairment:ACTive? "<impairment-name>"
Query Response
{0 | 1}
Description
Installs or removes an Impairment, such as a fiber spool, on the Hardware Diagram. When installing a new Impairmentyou can use any unique string that you like up to 20 characters in length. Or, if you enter an empty string, the default strings will be assigned which are "DUT Fixture #' or 'WDM DUT Fixture'.
You can use any string that you like up to 20 characters in length. The string must contain valid Windows file name characters. You can always rename the Impairment later using the :CONFigure:IMPairment:REName command. Send the query to determine if the Impairment is installed on the Hardware Diagram.
FlexOTO allows you to create up to 8 Impairment blocks. The default names of Impairments created via the GUI are Impairment 1, Impairment 2, and so forth as shown on the Hardware Diagram. However, you can install a Impairment using any name that you like. For example, "Fiber Spool".
hwdiagram.write(':CONFigure:IMPairment:ACTive "Impairment 1", ON') # install 1st Impairment with standard name
hwdiagram.write(':CONFigure:IMPairment:ACTive "Fiber Spool", ON') # install 2nd Impairmentwith custom name
The name of a Impairmentis important as the name is passed as an argument to other commands including the universal port connect command :CONFigure:PORT:CONNect which is used to connect Fixture ports to other blocks in the Hardware Diagram. The Fixture name is also shown in FlexOTO's panels and reports.
Token Parameters
The second command argument can be one of the following tokens:
ON- Installs an Impairment on the Hardware Diagram.
OFF- Uninstalls an Impairment from the Hardware Diagram.
Send the query to determine if the Impairment is installed on the Hardware Diagram.
To enter the nominal attenuation of the selected Impairment block, use the :CONFigure:IMPairment:ATTenuation command.
Example Command
hwdiagram.write(':CONFigure:IMPairment:ACTive "Impairment 1", ON')