STK ObjectsSend comments on this topic.
IAgStar Interface

Description

Provides access to the properties and methods used in defining a star object.

Public Properties

Public Property AccessConstraintsGet the constraints imposed on the star.
Public Property EpochEpoch of the star position information as a Julian epoch (yyyy.yy). The Julian epoch is related to the Julian date by the expression JD = 2451545.0 + (yyyy.yy - 2000.0) x 365.25, where 2451545.0 (TT) represents the standard J2000 epoch.
Public Property GraphicsGet the star's 2D Graphics properties.
Public Property LocationDeclinationThe star's declination: the angle from the inertial equator measured toward the inertial positive Z-axis. Uses Angle Dimension.
Public Property LocationRightAscensionThe star's right ascension: the angle in the equatorial plane measured in a right-handed sense about the inertial Z-axis from the inertial X-axis. Uses Angle Dimension.
Public Property MagnitudeMagnitude, the visual brightness of the star. Dimensionless.
Public Property ParallaxAnnual parallax: motion of a star due to changes in the Earth's position relative to the solar system barycenter. Uses Angle Dimension.
Public Property ProperMotionDeclinationMotion of the star relative to the solar system barycenter expressed in arc seconds per year. Here, declination refers to motion from the inertial equator measured towards the inertial positive Z-axis. Uses AngleRate Dimension.
Public Property ProperMotionRadialVelocityProperty motion radial velocity. Uses Distance dimension.
Public Property ProperMotionRightAscensionMotion of the star relative to the solar system barycenter expressed in arc seconds per year. Here, right ascension refers to motion in the equatorial plane measured in a right-handed sense about the inertial Z-axis from the inertial X-axis. Uses AngleRate Dimension.
Public Property ReferenceFrameReturns a reference frame.
Public Property VOGet the star's 3D Graphics properties.

Interfaces

CoClasses that Implement IAgStar

Name
AgStar

Example

Create a star (on current scenario central body)
[C#]
// Create the Star
IAgStar star = root.CurrentScenario.Children.New(AgESTKObjectType.eStar, "MyStar") as IAgStar;
Configure basic properties
[C#]
// Units depend on current unit preferences
star.LocationDeclination = -40.0;
star.LocationRightAscension = 120.0; // in arcSec
star.Magnitude = -1.0;
star.Parallax = 0.0; // in arcSec
star.ProperMotionDeclination = 1.5; // in arcSec
star.ProperMotionRadialVelocity = 0.75; // in meters
star.ProperMotionRightAscension = -0.5; // in arcSec
Create a star from a star database
[C#]
// Import object from database using Connect
string command = "ImportFromDB * Star ScenarioCollection VisualMagnitude 0 1.0 RightAsc 200.0 230.0 Constellation ImportedFromStarDB";
root.ExecuteCommand(command);

IAgStar star = root.GetObjectFromPath("Star/Star-65474") as IAgStar;
Create a star (on current scenario central body)
[Visual Basic .NET]
' Create the Star
Dim star As IAgStar = TryCast(root.CurrentScenario.Children.[New](AgESTKObjectType.eStar, "MyStar"), IAgStar)
Configure basic properties
[Visual Basic .NET]
' Units depend on current unit preferences
star.LocationDeclination = -40
star.LocationRightAscension = 120
' in arcSec
star.Magnitude = -1
star.Parallax = 0
' in arcSec
star.ProperMotionDeclination = 1.5
' in arcSec
star.ProperMotionRadialVelocity = 0.75
' in meters
star.ProperMotionRightAscension = -0.5
' in arcSec
Create a star from a star database
[Visual Basic .NET]
' Import object from database using Connect
Dim command As String = "ImportFromDB * Star ScenarioCollection VisualMagnitude 0 1.0 RightAsc 200.0 230.0 Constellation ImportedFromStarDB"
root.ExecuteCommand(command)

Dim star As IAgStar = TryCast(root.GetObjectFromPath("Star/Star-65474"), IAgStar)
© 2024 Analytical Graphics, Inc. All Rights Reserved.