Description | Example | Return Message | Group

Define (Star)

Define the basic properties of a star

Syntax

Define <StarObjectPath> {StarOption} <Parameters>

Description

The Define command allows you to define basic properties for a specified star instance.

{StarOption} can be:

{StarOption} <Parameters> Description
Position <RightAscen> <Declination> <RightAscen> and <Declination> are entered in degrees
Motion <RightAscen> <Declination> <RightAscen> and <Declination> are entered in arc seconds/year.
Magnitude <Magnitude> <Magnitude> is a real number between -3.0 and 100.0.
Parallax <Parallax> <Parallax> is entered in arc seconds.
StarDB {ScenarioCollection | "<CollectionName>"} ID <StarID> Define a star from an entry in a Star collection.

Enter ScenarioCollection to use the current default star collection.

<StarID> is the identification number of the star that you wish to select.

Example

To set the position of a star with a right ascension of 20.0 degrees and a declination of 48.0 degrees:

Define */Star/Twinkle Position 20.0 48.0

To set the position of a star with a magnitude of 6.0:

Define */Star/Twinkle Magnitude 6.0

To set the position of a star with a parallax of 3.5 arc seconds:

Define */Star/Twinkle Parallax 3.5

To select the star with ID Number 1256 from the current default star collection:

Define */Star/Star1 StarDB ScenarioCollection ID 1256

To create Star2 and define its basic properties based on the entry in the specified collection that matches Id number 32349:

New / */Star Star2

Define */Star/Star2 StarDB "Hipparcos 2 Mag 6" Id 32349

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Stars & Planets

Version

9.2.1

STK Programming Interface 11.0.1