Define the display of covariance pointing contours
VO <VehObjectPath> CovarPointContours {CovarOption} <Parameters>
The VO CovarPointContours command enables you to define the display of directional uncertainty contours from the current object to the selected ToObject. The contours created take into account positional uncertainties of the two objects. These uncertainties are assumed uncorrelated, so that the combined uncertainty is represented by the sum of the positional covariances of the two objects. The resulting covariance defines a 3D ellipsoid, which is viewed from the current object location to create a directional uncertainty contour. Use the {CovarOptions} to define the display attributes for 3D Covariance Pointing contours.
All {CovarOptions} available using the VO Covariance command are valid for this command. In addition to the standard {CovarOptions}, the chart below summarizes additional options available using this command only.
| {CovarOption} | <Parameters> | Description |
|---|---|---|
| ToObject | <TruncObjectPath> | The vehicle object that will be used to characterize pointing uncertainty. |
| Size | ScaleToAttSphere | Scale the distance at which the contour is drawn. |
| <ScaleValue> | ||
| ShowCone | {On | Off} | If On, the cone is created by connecting to the center of the current object with the contour. The size of this cone (i.e. the distance at which the contour is shown) can be changed and optionally set to the size of the attitude sphere using the size options outlined above. |
To use the attSat satellite object in the current scenario to characterize uncertainty:
VO */Satellite/Satellite1 CovarPointContours ToObject Satellite/attSat
To set the size of the contour drawn relative to the size of the attitude sphere:
VO */Satellite/Satellite1 CovarPointContours Size ScaleToAttSphere
To specify the size of the contour:
VO */Satellite/Satellite1 CovarPointContours Size 6.5
VO */Satellite/Satellite1 CovarPointContours ShowCone On
To scale scale the contour directly:
VO */Satellite/Satellite1 CovarPointContours Scale 4.96
To size the covariance contour by specifying the probability value:
VO */Satellite/Satellite1 CovarPointContours Scale UseProbability 34.12
To turn on the use of covariance graphics and assign graphics attributes.
VO */Satellite/Satellite1 CovarPointContours Basic Show On Color blue LineWidth 4
VO */Satellite/Satellite1 CovarPointContours Basic Show On Color yellow Translucency 50
To turn on the use of time intervals during which covariance graphics will display:
VO */Satellite/Satellite1 CovarPointContours Intervals On
To set the default attributes that will be assigned to display intervals:
VO */Satellite/Satellite1 CovarPointContours IntervalDefault Show Off Color blue LineWidth 2
To remove all dispay intervals and turn interval graphics off:
VO */Satellite/Satellite1 CovarPointContours Intervals Clear
To load a list of display intervals from an external interval list file (*.int):
VO */Satellite/Satellite1 CovarPointContours Intervals Load "c:\stk\project1\Target1.int"
To add a list of display intervals from an interval list time component:
VO */Satellite/Satellite1 CovarPointContours Intervals Import "Satellite/Satellite1 AccessFac1 Interval List"
To add two display intervals:
VO */Satellite/Satellite1 CovarPointContours Intervals Add 2 "1 Jan 2001 00:38:00.00" "1 Jan 2001 01:58:00.00" "1 Jan 2001 05:38:00.00" "1 Jan 2001 06:58:00.00"
To remove the display interval specified here:
VO */Satellite/Satellite1 CovarPointContours Intervals Remove "1 Jan 2001 00:40:00.00" "1 Jan 2001 01:00:00.00"
To replace the display of the existing contours with the display times here:
VO */Satellite/Satellite1 CovarPointContours Intervals Replace 2 "1 Jan 2001 00:38:00.00" "1 Jan 2001 01:58:00.00" "1 Jan 2001 05:38:00.00" "1 Jan 2001 06:58:00.00"
To add two display intervals with color and line width specified:
VO */Satellite/Satellite1 CovarPointContours Intervals Add 2 "1 Jan 2001 00:38:00.00" "1 Jan 2001 01:58:00.00" "1 Jan 2001 05:38:00.00" "1 Jan 2001 06:58:00.00" Color green LineWidth 3
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10
STK Programming Interface 11.0.1