Keysight 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.IPropertyInfo, Agilent.SA.Vsa.IPropertyInfo2, Agilent.SA.Vsa.IRemoteNotifyPropertyChanged, Agilent.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.IPropertyInfo, Agilent.SA.Vsa.IPropertyInfo2, Agilent.SA.Vsa.IRemoteNotifyPropertyChanged, Agilent.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.IPropertyInfo, Agilent.SA.Vsa.IPropertyInfo2, Agilent.SA.Vsa.IRemoteNotifyPropertyChanged, Agilent.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 89600 VSA Ver 18.00

See Also