AGI STK Objects 11 Send comments on this topic.
IAgStar Interface





Description

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

Object Model




Public Properties

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

Example

Create a star (on current scenario central body)
[C#] Copy Code
// Create the Star 
IAgStar star = root.CurrentScenario.Children.New(AgESTKObjectType.eStar, "MyStar"as IAgStar; 
 

Configure basic properties
[C#] Copy Code
// 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#] Copy Code
// 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] Copy Code
' Create the Star
Dim star As IAgStar = TryCast(root.CurrentScenario.Children.[New](AgESTKObjectType.eStar, "MyStar"), IAgStar)

Configure basic properties
[Visual Basic .NET] Copy Code
' 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] Copy Code
' 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)

CoClasses that Implement IAgStar

Name
AgStar
© 2016 Analytical Graphics, Inc. All Rights Reserved.

STK Programming Interface 11.0.1