Description | Example | Return message | Group

GraphCreate

Generate a graph to display or save.

Syntax

GraphCreate <ObjectPath> ({Option} <Value>)...

Related commands

Description

The GraphCreate command generates a graph, based on the style specified, and allows you to save it as a file or display it on the screen. The valid {Option} <Value> pairs are described in the table below. The Style and Type options are required for this command.

The GraphCreate command is only available when running STK Desktop.

{Option} <Value>Description
Style "<GraphStyleName>"Enter the name of the graph style to create, the style must match an existing graph style within STK. Available styles display in the STK Report & Graph Manager window.

For details on how to specify "<GraphStyleName>" see Report Style Names

The Style option is required.

Type {Display | Save}Enter the type of the report to create.

Enter Display to display the specified graph on the screen.

Enter Save to save the graph file in one of these formats: jpg, bmp, png, emf, wmf. The extension on the input file name determines the format used. The file is specified with the File option.

The Type option is required.

File "<FilePath>"Enter the path and name of the file to be created. The extension on the file name determines the format in which the file will be saved. Valid extension values are: jpg, bmp, png, emf, wmf.

The File option is required if Type is Save.

TimePeriod {{TimeInterval} | UseAccessTimes | Intervals {"<FilePath>" | "<IntervalListSpec>"}} Enter {TimeInterval} to define the start time and stop time for the report span. For valid {TimeInterval} values see Time Options.

Or specify UseAccessTimes to only report data during access times between the <ObjectPath> and an AccessObject, but you must also specify at least one AccessObject.

Or use the Intervals option to specify an STK interval file for the time period or a Interval List component specification. For help on creating the STK interval file, see Create & Import External Files - Interval List in STK Help. For information about "<IntervalListSpec>" see Component Specification.

TimeStep {<Value> | Array "<TimeArraySpec>"}Enter the time step <Value> to be used in creating the graph. This value is entered in seconds and must be between 0.000001 and 1000000000.0 seconds.

Or enter the Array keyword with a Time Array component specification to use the array times as time steps. For information about "<TimeArraySpec>" see Component Specification.

OutputSize <Width> <Height>Specify the output size of a saved graph. <Width> and <Height> values are entered in pixels.

This option is only used for graphs whose Type is Save.

AccessObject <AccessObjectPath>If graphing access, specify the object to which access will be calculated. Access will be calculated from the object for which the command is being issued (specified using the <ObjectPath> parameter). This option can be entered multiple times, to specify multiple access objects.
AdditionalData "<Data>"Some Graph Styles require additional or pre-data, such as a comparison object for the RIC graph for a Satellite. For these types of graphs you must include this option. More information on styles that require AdditionalData can be found at "Report Additional Data".
Title "<MainTitle>"Enter a main title for the graph. Entering a Title will override any Title Options set in the graph style.
Subtitle "<SubTitle>"Enter a subtitle for the graph.

Examples

To save an Access graph for the Shuttle satellite and the Wallops facility:

GraphCreate */Satellite/Shuttle Type Save Style "Access" File "c:\Data\shuttleaccesswallopsgraph.bmp" AccessObject */Facility/Wallops

To display a graph of vehicle position only during access with the facility and at a step size of 120 seconds:

GraphCreate */Satellite/Satellite1 Type Display Style "VehPosG" AccessObject */Facility/Facility1 TimePeriod UseAccessTimes TimeStep 120.0

To save an RIC graph as a bitmap file for the GEO1 satellite in reference to the LEO11 satellite:

GraphCreate */Satellite/geo1 Type Save Style "RIC" File "c:\temp\grp1.bmp" AdditionalData "Satellite/leo11"

To display a graph of the selected vector for the GEO1 satellite in reference to the Principal axes:

GraphCreate */Satellite/geo1 Type Display Style "Vector Choose Axes" AdditionalData "Satellite/geo1 Principal"

To save an RIC graph as a jpg file, with a specified size:

GraphCreate */Satellite/geo1 Type Save Style "RIC" File "c:\temp\grp1.jpg" AdditionalData "Satellite/leo11" OutputSize 750 600

Return message

Group membership

This command belongs to the following group(s):

Object Tools

Version

10.1