Description

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

Public Properties

AccessConstraints	Get the constraints imposed on the star.
Epoch	Epoch 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.
Graphics	Get the star's 2D Graphics properties.
LocationDeclination	The star's declination: the angle from the inertial equator measured toward the inertial positive Z-axis. Uses Angle Dimension.
LocationRightAscension	The 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.
Magnitude	Magnitude, the visual brightness of the star. Dimensionless.
Parallax	Annual parallax: motion of a star due to changes in the Earth's position relative to the solar system barycenter. Uses Angle Dimension.
ProperMotionDeclination	Motion 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.
ProperMotionRadialVelocity	Property motion radial velocity. Uses Distance dimension.
ProperMotionRightAscension	Motion 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.
ReferenceFrame	Returns a reference frame.
VO	Get the star's 3D Graphics properties.

Interfaces

Implemented Interface
IAgStkObject
IAgLifetimeInformation

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)

STK Objects	Send comments on this topic.
IAgStar Interface