Click or drag to resize

Satellite Database Files

To obtain information about spacecraft using STK database files, use the StkSatelliteDatabase class. This type uses a directory and a base filename to identify a set of files with the same name but differing extensions which together define the database. For more information on the format of these files, see the section on the database format below.

Satellite Databases in STK Components

STK uses a "satellite database" to encode satellite ephemeris and metadata available from Celestrak and other sources.

After instantiating an instance of StkSatelliteDatabase, queries can be made to obtain a set of satellites matching a set of criteria. Here is an example of how to query the database for satellites:

Java
StkSatelliteDatabase db = new StkSatelliteDatabase(dbDirectory, "stkSatDb");

// Create a query object and then populate it with the properties to query on.
// Regular expressions are used to query on strings.
StkSatelliteDatabaseQuery query = new StkSatelliteDatabaseQuery();
query.setCommonName(Pattern.compile("QUICK"));
query.setMinimumApogee(200000.0);

// Get the database entries matching the query and print out the SSC number of each.
for (StkSatelliteDatabaseEntry entry : db.getEntries(query)) {
    System.out.println(entry.getSatelliteNumber());
}
Satellite Database Format

The satellite database is comprised of a total of six files. You can create your own satellite database by following the required format. For example, the stkSatDb database, which contains all satellites considered active and having a two-line element (TLE) set available, includes the following files:

File

Contents

stkSatDb.sd

Main database file

stkSatDb.fr

Frequency Information

stkSatDb.wr

Write Ups

stkSatDb.om

Owner/Mission

stkSatDb.tce

Two-line Element Sets

stkSatDb.gd

Latest update information

The first three files contain fixed-width fields, where one row represents a single entry. The remaining contain a standard text format.

stkSatDb.sd File

This is the main satellite database file; it contains all searchable fields. The format, starting at column zero (0) is as follows:

Column

Width

Description

0-4

5

SSC number. Valid values are 00001 - 99999 (KEY FIELD) Leading zeros are expected.

5-19

15

Common name. This is any common name that may be used. There may be multiple entries for a satellite; these may differ in the common name.

20-34

15

Official name. This is the unique official name for the entry

35-45

11

International number. Unique number assigned to all objects achieving orbit and observed by U.S. Strategic Command (USSTRATCOM).

46-55

10

Owner/country. Owner of satellite.

56-65

10

Mission. Category of mission.

66-68

3

Launch site. May be abbreviated.

69-76

8

Launch date. YYYYMMDD format.

77-80

4

Launch time (UTC). HHMM format (0000-2359).

81-100

20

Orbit outcome. For example, heliocentric orbit. For decayed objects, no orbital elements available is displayed.

101-104

4

This field is blank.

105-112

8

Mass in kg. This is the dry mass of the satellite

113-118

6

Apogee in Km above the surface.

119-123

5

Perigee in Km above the surface.

124-130

7

Period. Time in minutes for the satellite to complete one revolution of the Earth. This number is rounded to nearest tenth of a minute.

131-135

5

Inclination. Angle (deg) between the plane of the orbit and the equatorial plane of the planet.

136-140

5

This field is blank.

141-148

8

Status. Active or Inactive.

149-156

8

Date of last database update (YYYYMMDD)

stkSatDb.fr File

This is the frequency file; it contains all downlink frequencies known for the satellite. Frequencies are stored in Megahertz. Currently, this information is for description purposes only. There may be multiple entries for a particular satellite; one column represents a single entry. The format, starting at column zero (0) is as follows:

Column

Width

Description

0-4

5

SSC number. Valid values 00001 - 99999 (KEY FIELD)

5-11

7

Low frequency. Low frequency in a range or an individual frequency if known.

12-19

7

High frequency. High frequency in a range.

stkSatDb.wr File

This is the write up file. There can be multiple rows for a single satellite. The format, starting at column zero (0) is as follows:

Column

Width

Description

0-4

5

SSC number. Valid values 00001 - 99999 (KEY FIELD)

5-49

45

Write Up. Write up text.

stkSatDb.om File

This is the Owner/Mission file. It contains a list of all the valid owners and missions in the database. This file is used to supply the list of owners and missions returned by the getOwners and getMissions methods.

Example owner/mission file
BEGIN Owner
ARGN
ASRA
ESA
ESRO
UK
US
END Owner

BEGIN Mission
Astronomy
Comm
Earth Sci
Engineer
Human Crew
Life Sci
Micro Grav
Navigation
Planet Sci
Resupply
Solar Phys
Space Phys
Space Scie
Surv/Mil
Tech App
Unknown
END Mission

stkSatDb.tce File

This file contains all TLE sets for the satellites in the database. Single entries are supported in this file. The element sets represent the latest available TLE data for each satellite.

Example stkSatDb.tce file
1 00005U 58002B   05015.94626345 -.00000062  00000-0 -10317-3 0  9658
2 00005  34.2544 279.4240 1851477 235.3377 105.8748 10.83848344594048
1 00011U 59001A   05015.08582723  .00000155  00000-0  62942-4 0  1094
2 00011  32.8742 252.5821 1484798 239.7234 104.8236 11.82002579949142
1 00012U 59001B   05015.81379938  .00000334  00000-0  20907-3 0  5848
2 00012  32.8922 192.9596 1681078  80.7514 297.8531 11.40765732878338
1 00016U 58002A   05015.94728841  .00000029  00000-0  13838-4 0  3987
2 00016  34.2736 202.9570 2031906 271.0047  65.9929 10.47957803867837
1 00020U 59007A   05015.35273971  .00000630  00000-0  26956-3 0  5357
2 00020  33.3472 351.0938 1690744  52.6138 321.6759 11.50473782580498
1 00022U 59009A   05015.95064910  .00000663  00000-0  92921-4 0  1783
2 00022  50.2929 278.4707 0179209 252.3746 105.7553 14.80402097387262
1 00029U 60002B   05013.90124256  .00000037  00000-0  38295-4 0  3936
2 00029  48.3834 186.5671 0024985 314.7880  45.0995 14.71345039388318
1 00045U 60007A   05015.74008867  .00000100  00000-0  53717-4 0  4356
2 00045  66.6974  78.4199 0253333  89.3317 273.6828 14.31832518315974

stkSatDb.gd File

This is the generic database file. It contains information concerning the last update of the database.

Example stkSatDb.gd file
BEGIN DatabaseUpdate
  Version          1.1
  LastUpdate       20160616
END DatabaseUpdate