VO AttitudeView
Define and display an attitude sphere for a vehicle, facility, place, target or sensor.
Syntax
VO <ObjectPath> AttitudeView {AttitudeViewOption} <Parameters>
Description
Use the VO AttitudeView command to display a vehicle, facility, place, target or sensor, together with visualization aids such as vectors and the Attitude Sphere.
| {AttitudeViewOption} | <Parameters> | Description |
|---|---|---|
| Sphere | {SphereOption1} <Value1> [{SphereOption2} <Value2> ...] | Define the display of the attitude sphere, a spherical grid that shows the orientation of the vehicle with respect to the selected coordinate system. |
| Projection | {ProjectionOption1} <Value1> [{ProjectionOption2} <Value2> ...] | Display projections of central bodies and other objects of interest. |
If {AttitudeViewOption} is Sphere, valid values for {SphereOption} are:
At least one {SphereOption} <Value> pair should be entered.
| {SphereOption} | <Value> | Description |
|---|---|---|
| Show | {On | Off} | Display the attitude sphere in the 3D window(s). |
| SphereColor | {Color} | Select the color in which the sphere's grid lines are to display. For valid {Color} options see Common Options. |
| ZeroDegColor | {Color} | Select the color in which the sphere's Equator and Prime Meridian are to display. For valid {Color} options see Common Options. |
| Spacing | {10 | 15 | 18 | 30 | 45 | 90} | Select the spacing in degrees to appear initially between grid lines. |
| MinSpacing | <Value> | Specify the minimum and maximum spacing, between 0.1 and 90.0 degrees, to be maintained between grid lines when the Attitude Sphere increases in size due to zooming in or resizing of the window. |
| MaxSpacing | ||
| LabelType | {None | All | EveryOther} | Opt to display latitude/longitude values on all grid lines, on every other grid line, or on none of them. |
| LabelColor | {Color} | If latitude/longitude labels are shown, select the color in which they are to display. For valid {Color} options see Common Options. |
| FontSize | {Small | Medium | Large} | If latitude/longitude labels are shown, select the font size in which they are to display. |
| ZeroDegLineWidth | <Value> | Indicate a pixel width value for the lines representing the Equator and Prime Meridian by specifying an integer between 1 and 10. |
| GridLineWidth | <Value> | Indicate a pixel width value for the grid lines by specifying an integer between 1 and 10. |
| Scale | <Value> | Enter a logarithmic scaling factor for the sphere by specifying a real number between 0 and 10. |
| ScaleToModel | {On | Off} | If On, the sphere's size will automatically adjust with changes in the model scale. |
| TransparentLines | {On | Off} | If On, new grid lines will fade in or out gradually when zooming into or out from the Attitude Sphere. |
| PixelThreshold | <Value> | Specify the resolution, in pixels, to be applied in determining whether to add or remove grid lines as the sphere increases or decreases in size by specifying an integer between 10 and 2000. |
| PointSize | <Value> | Enter a number between 1 and 10 to specify the size of points appearing next to grid line labels. |
| FadeLevel | <Value> | Enter a percent value to specify the extent to which grid lines fade as a function of their distance from the viewer by specifying a real number between 1 and 100. |
| Frame | "Type Axes {CrdnDefOptions}" | Select an Axes to be used as the coordinate frame for the attitude view. {CrdnDefOptions} are outlined in the Table below. |
If {SphereOption} is Frame, {CrdnDefOptions} are a set of values defining the axes used for the Frame. {CrdnDefOptions} can be specified in any order, and any number of {CrdnDefOptions} can be used in a single command, however the Name option is required. Valid values for {CrdnDefOptions} are:
| {CrdnDefOptions} | <CrdnDefValue> | Description |
|---|---|---|
| Name | <NameOfAxes> | The name of the axes to which the specified parameters are being applied.
The Name option is required when specifying the frame. |
| CBName | <NameOfCentralBody> | The name of the central body to which the specified axes relates. |
| ObjectPath | <ObjectPath> | The path of the object to which the axes relates. |
Using {ProjectionOptions} allows you to visualize a vehicle's attitude with respect to central bodies and other objects of interest, you can project the position of such objects onto the Attitude Sphere. The following {ProjectionOption} <Value> pairs are valid:
| {ProjectionOption} | <Value> | Description |
|---|---|---|
| Name | {<CBName> | <TruncObjectPath>} | The Central Body name or truncated object path of the Sensor or Star whose position will be projected onto the Attitude Sphere. |
| Show | {On | Off} | Display a projection of the selected object |
| ShowLabel | {On | Off} | Display a label identifying the projected object. |
| Color | {Color} | Indicate the color in which the projection is to display. This option is valid for Central Bodies only. For valid {Color} options see Common Options. |
| LineWidth | <Value> | Valid for CentralBodies and Sensors only. Indicate a pixel width value for the line with which the projection is to be drawn by specifying an integer between 1 and 10. |
| PointSize | <Value> | If the projected object is a star, enter a number to specify the size of the point representing it. |
| Volume | {On | Off} | If On, the projection displays in three dimensions. |
Examples
To display the attitude sphere in the attitude view window with red grid lines and yellow labels representing latitude and longitude values:
VO */Satellite/attSat AttitudeView Sphere Show On SphereColor red LabelColor yellow
To display the attitude sphere in the attitude view window with number 2 sized grid lines spaced at 45 degrees using small fonts when displaying latitude and longitude labels:
VO */Satellite/attSat AttitudeView Sphere Spacing 45 FontSize small GridLineWidth 2
To scale the attitude sphere to 5.0 and not scale the model:
VO */Satellite/attSat AttitudeView Sphere Scale 5.0 ScaleToModel Off
To display a projection of the Earth in cyan on the attitude sphere in the attitude view window:
VO */Satellite/attSat AttitudeView Projection Name Earth Show On Color cyan
To display a projection of the Sensor1 object on the attitude sphere in the attitude view window:
VO */Satellite/attSat AttitudeView Projection Name Facility/aosFac/Sensor/Sensor1 Show On
Return message
Group membership
This command belongs to the following group(s):
Version
10