Keysight Pathwave 89600 VSA .NET API
Constellation Class
Members  Example  See Also 
Agilent.SA.Vsa.CustomIQ.Interfaces Assembly > Agilent.SA.Vsa.CustomIQ Namespace : Constellation Class


Glossary Item Box

The Constellation class represents the definition of a constellation for use in Custom IQ modulation analysis.

Object Model

Constellation ClassConstellationStateCollection ClassConstellationState ClassConstellationState Class

Syntax

Visual Basic (Declaration) 
Public MustInherit Class Constellation 
   Inherits Agilent.SA.Vsa.RemotableObject
   Implements Agilent.SA.Vsa.IPropertyInfoAgilent.SA.Vsa.IPropertyInfo2Agilent.SA.Vsa.IRemoteNotifyPropertyChangedAgilent.SA.Vsa.IRemoteNotifyPropertyInfoChanged, Agilent.SA.VsaInternal.IObjectModel, Agilent.SA.VsaInternal.IObjectModel2, Agilent.SA.VsaInternal.IObjectModel3 
C# 
public abstract class Constellation : Agilent.SA.Vsa.RemotableObject, Agilent.SA.Vsa.IPropertyInfoAgilent.SA.Vsa.IPropertyInfo2Agilent.SA.Vsa.IRemoteNotifyPropertyChangedAgilent.SA.Vsa.IRemoteNotifyPropertyInfoChanged, Agilent.SA.VsaInternal.IObjectModel, Agilent.SA.VsaInternal.IObjectModel2, Agilent.SA.VsaInternal.IObjectModel3  
C++/CLI 
public ref class Constellation abstract : public Agilent.SA.Vsa.RemotableObject, Agilent.SA.Vsa.IPropertyInfoAgilent.SA.Vsa.IPropertyInfo2Agilent.SA.Vsa.IRemoteNotifyPropertyChangedAgilent.SA.Vsa.IRemoteNotifyPropertyInfoChanged, Agilent.SA.VsaInternal.IObjectModel, Agilent.SA.VsaInternal.IObjectModel2, Agilent.SA.VsaInternal.IObjectModel3  

Remarks

The constellation definition includes a representation of ideal states (ConstellationStates), properties of the constellation as a whole, and methods supporting the creation and management of the constellation definition.

Example

This example shows you how to modify the constellation
C#Copy Code
//Select custom IQ measurement extension
var customIQDemod = app.Measurements.SelectedItem.SetMeasurementExtension<CustomIQ.MeasurementExtension>();
            
//Preset constellation to PSK 16
var constellation = customIQDemod.Constellation;
constellation.Preset(ConstellationStyle.Psk, 16);
            
//Add and modify a constellation state
var states = constellation.ConstellationStates;
var newState = states.Create();
newState.Real = 1.1;
newState.Imaginary = 1.1;
            
var anotherState = states.Create();
anotherState.Real = -1.1;
anotherState.Imaginary = -1.1;
                
//Check if the constellation is still valid
if(!constellation.Validate())
{
    string validateFailureReason = constellation.ValidationFailureDescription;
    //constellation is not valid
    //TODO: view validateFailureReason and fix it.
}
            
// ... Do other task on constellation

Requirements

Target Platforms: Windows 11 Professional or Enterprise; Windows 10 Professional, Enterprise, or Education (64-bit)

Minimum Software Version Requirement: Keysight PathWave 89600 VSA Ver 18.00

See Also