ORBITRD

Description

Reads orbit information from a text file into a new or existing orbit segment.

Parameters

orbitrd(file, orbit, tfile, dbsn, dbsd)

Name	Type	Caption	Length	Value range
FILE *	str	Output file name	1 -
ORBIT	List[int]	Output orbit segment	0 - 1	1 -
TFILE *	str	Orbit information text file	1 -
DBSN	str	Orbit segment name	0 - 8	Default: ORBIT
DBSD	str	Orbit segment description	0 - 64	Default: Orbital Ephemeris Data

* Required parameter

Parameter descriptions

FILE

Specifies the name of the PCIDSK image file that will contain the output orbit segment.

ORBIT

Specifies the orbit segment (type 16) to which orbit information will be added. If this parameter is not specified, a new orbit segment is created. If specified, this value must be greater than zero.

TFILE

Specifies the name of the input text file from which to read the orbit information.

Note: If you input the FULL format text file (from ORBITWR function, RTYP parameter), the per-scanline data will not be read; the scanline data values will be defaulted to zero. See ORBITWR for more information.

DBSN

Specifies a name (up to 8 characters) identifying the output orbit segment. This string is displayed by ASL and may be changed with MAS.

This parameter is used only if a new segment is created. The default segment name is "ORBIT".

DBSD

Describes (in up to 64 characters) the contents or origins of the output orbit segment. This string is displayed with ASL and may be changed with MAS.

This parameter is used only if a new segment is created. The default value is "Orbital Ephemeris Data".

Details

ORBITRD reads orbit information from a text file (TFILE). It then writes it to an output orbit segment (ORBIT) in the output file (FILE).

If the ORBIT segment (type 160) is specified, the orbit information in the text file updates the existing orbit segment. If ORBIT is not specified, a new orbit segment (type 160) is created.

DBSN (Orbit Layer Name) and DBSD (Orbit Layer Description) define the name and description of the output orbit segment, respectively.

Example

Read orbit information for the SPOT satellite from the text file 'spot.orb'. A new segment (type 160) will be created in 'spotleft.pix' to contain the orbit information.

from pci.orbitrd import orbitrd

file='spotleft.pix'
orbit=[]
tfile='spot.orb'
dbsn='SPOT_ORB'
dbsd='SPOT Satellite Orbit Ephemeris Data'

orbitrd(file, orbit, tfile, dbsn, dbsd)

Environments	PYTHON :: EASI :: MODELER
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Example :: Related