Description | Example | Return Message | Group

Prune

Control amount of data stored for a vehicle (data thinning)

Syntax

Prune <ObjectPath> {PruneOption} <Parameters>

Description

The Prune command allows you to control the amount of data being kept by the system for a vehicle when receiving it via Connect.

For example, if you collected a vehicle's data at a refresh rate of 1 second over a period of 10 hours, you may wish to prune some of the older data to a more reasonable amount when you begin your eighth hour. Using this command, you can request that data be reduced to 1 data set per minute (instead of 1 per second) for the first five hours while continuing to accrue data at 1 data set per second from the sixth hour on.

{PruneOption} can be:

{PruneOption} Parameters Description
<Interval> {KeepPoints <NumPoints> | BeforeTime {TimeValue}} [Attitude] Enter the <Interval> (in seconds) to be used to thin the data. The KeepPoints and BeforeTime options indicate how to determine the number of points to keep intact.

With the KeepPoints <NumPoints> option pruning will take place on all points preceding the number of points indicated.

With the BeforeTime {TimeValue} option pruning will take place on all points preceding the time indicated. For valid {TimeValue} values see Time Options.

If the attitude option is included, attitude data is also pruned according to the parameters set.

All [Attitude] Remove all ephemeris for the object. If the Attitude option is included, all attitude data is also pruned.

Note: If the vehicle's propagator is set to Realtime, then Attitude data will not be pruned.

Example

To prune ephemeris and attitude data so that STK keeps the last data point and the 2 data points prior to that and then thins the data preceding those two points to be at 120-second steps:

Prune */Satellite/Shuttle 120 KeepPoints 2 Attitude

To prune ephemeris data so that STK keeps the last data point and the data points prior to the time "17640.0" epoch seconds and then thins the data preceding those two points to be at 600-second steps:

setunits / epochsec

Prune */Satellite/TestSat 600 BeforeTime "17640.0"

To prune all ephemeris and attitude data:

Prune */Satellite/TestSat All Attitude

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Vehicles

Version

10

STK Programming Interface 11.0.1