Star Catalogue Format - Revision history

Alexwolf: /* Star Data Records */

2011-08-25T05:29:20Z

Star Data Records

Alexwolf: /* File Header Record */

2011-08-25T04:42:19Z

File Header Record

Lee Carré: moved Star Catalogue to Star Catalogue Format: Disambiguation of subject.

2011-08-06T14:53:50Z

moved Star Catalogue to Star Catalogue Format: Disambiguation of subject.

Alexwolf: /* Star Data Records */

2011-05-05T18:30:16Z

Star Data Records

Show changes

Alexwolf: /* Zone Records */

2011-05-05T18:25:24Z

Zone Records

Alexwolf: /* File Header Record */

2011-05-05T18:24:34Z

File Header Record

Alexwolf: /* File Sections */

2011-05-05T18:23:07Z

File Sections

Alexwolf: /* General Description */

2011-05-05T18:21:44Z

General Description

Alexwolf: /* General Description */

2011-04-14T11:10:00Z

General Description

Alexwolf: /* Zone Records */

2011-02-19T20:00:25Z

Zone Records

@@ Line 274: / Line 274: @@
   | unsigned char
   | 1
-  |class="rbn"| This is the magnitudemagnitude level in B-V colour. This value refers to one of 256 discrete steps in the magnitude range for the file
+  |class="rbn"| This is the magnitude level in B-V colour. This value refers to one of 256 discrete steps in the magnitude range for the file
   |-
   | mag
@@ Line 280: / Line 280: @@
   | unsigned char
   | 1
-  |class="rbn"| This is the magnitudemagnitude level in the V-I colour. This value refers to one of 256 discrete steps in the magnitude range for the file
+  |class="rbn"| This is the magnitude level in the V-I colour. This value refers to one of 256 discrete steps in the magnitude range for the file
   |-
   | sp_int
@@ Line 331: / Line 331: @@
   | int
   | 14 bits
-  |class="rbn"| This is the proper motionproper motion of the star in axis 1
+  |class="rbn"| This is the proper motion of the star in axis 1
   |-
   | dx1
@@ Line 343: / Line 343: @@
   | unsigned int
   | 7 bits
-  |class="rbn"| This is the magnitudemagnitude level in B-V colour. This value refers to one of 256 discrete steps in the magnitude range for the file
+  |class="rbn"| This is the magnitude level in B-V colour. This value refers to one of 256 discrete steps in the magnitude range for the file
   |-
   | mag
@@ Line 349: / Line 349: @@
   | unsigned int
   | 5 bits
-  |class="rbn"| This is the magnitudemagnitude level in the V-I colour. This value refers to one of 256 discrete steps in the magnitude range for the file
+  |class="rbn"| This is the magnitude level in the V-I colour. This value refers to one of 256 discrete steps in the magnitude range for the file
   |}
@@ Line 376: / Line 376: @@
   | unsigned int
   | 7 bits
-  |class="rbn"| This is the magnitudemagnitude level in B-V colour. This value refers to one of 256 discrete steps in the magnitude range for the file
+  |class="rbn"| This is the magnitude level in B-V colour. This value refers to one of 256 discrete steps in the magnitude range for the file
   |-
   | mag
@@ Line 382: / Line 382: @@
   | unsigned int
   | 5 bits
-  |class="rbn"| This is the magnitudemagnitude level in the V-I colour. This value refers to one of 256 discrete steps in the magnitude range for the file
+  |class="rbn"| This is the magnitude level in the V-I colour. This value refers to one of 256 discrete steps in the magnitude range for the file
   |}

@@ Line 173: / Line 173: @@
   | int
   | 4
-  |class="rbn"| Sets the level of sub-division of the geodesic sphere used to create the zones. 0 means an icosahedron (20 sizes), subsequent levels of sub-division lead to numbers of zones as described in section [sub:Zones]
+  |class="rbn"| Sets the level of sub-division of the geodesic sphere used to create the zones. 0 means an icosahedron (20 sizes), subsequent levels of sub-division lead to numbers of zones as described in section [[Star_Catalogue#Zones|Zones]]
   |-
   | Magnitude Minimum

@@ Line 196: / Line 196: @@
 ====Zone Records====
 The ''Zone Records'' section of the file lists the number of star records there are per zone. The number of zones is determined from the level value in the File Header Record, as described in section [[Star_Catalogue#Zones|Zones]]. The Zones section is simply a list of integer values which describe the number of stars for each zone. The total length of the Zones section depends on the number of zones. See table ''Zones section''.
-{| class="standard"
+{| class="guidetable"
   |+ Zones section
   | ''Name''
@@ Line 202: / Line 202: @@
   | ''Type''
   | ''Size''
-  | ''Description''
+  |class="rbn"| ''Description''
   |-
   | num stars in zone 0
@@ Line 208: / Line 208: @@
   | int
   | 4
-  | The number of records in this file which are in zone 0
+  |class="rbn"| The number of records in this file which are in zone 0
   |-
   | num stars in zone 1
@@ Line 214: / Line 214: @@
   | int
   | 4
-  | The number of records is this file which are in zone 1
+  |class="rbn"| The number of records is this file which are in zone 1
   |-
   | ...
@@ Line 220: / Line 220: @@
+  |
+  |
+  |class="rbn"|
   |-
   | num stars in zone ''n''
@@ Line 226: / Line 226: @@
   | int
   | 4
-  | The number of records is this file which are in zone ''n''
+  |class="rbn"| The number of records is this file which are in zone ''n''
   |}

@@ Line 137: / Line 137: @@
 ====File Header Record====
 The File Header Record describes file-wide settings. It also contains a magic number which servers as a file type identifier. See table ''Header Record''.
-{| class="standard"
+{| class="guidetable"
   |+ Header Record
   | ''Name''
@@ Line 143: / Line 143: @@
   | ''Type''
   | ''Size''
-  | ''Description''
+  |class="rbn"| ''Description''
   |-
   | Magic
@@ Line 149: / Line 149: @@
   | int
   | 4
-  | The magic number which identifies the file as a star catalogue. 0xde0955a3
+  |class="rbn"| The magic number which identifies the file as a star catalogue. 0xde0955a3
   |-
   | Data Type
@@ Line 155: / Line 155: @@
   | int
   | 4
-  | This describes the type of the file, which defines the size and structure of the Star Data record for the file.
+  |class="rbn"| This describes the type of the file, which defines the size and structure of the Star Data record for the file.
   |-
   | Major Version
@@ Line 161: / Line 161: @@
   | int
   | 4
-  | The file format major version number
+  |class="rbn"| The file format major version number
   |-
   | Minor Version
@@ Line 167: / Line 167: @@
   | int
   | 4
-  | The file format minor version number
+  |class="rbn"| The file format minor version number
   |-
   | Level
@@ Line 173: / Line 173: @@
   | int
   | 4
-  | Sets the level of sub-division of the geodesic sphere used to create the zones. 0 means an icosahedron (20 sizes), subsequent levels of sub-division lead to numbers of zones as described in section [sub:Zones]
+  |class="rbn"| Sets the level of sub-division of the geodesic sphere used to create the zones. 0 means an icosahedron (20 sizes), subsequent levels of sub-division lead to numbers of zones as described in section [sub:Zones]
   |-
   | Magnitude Minimum
@@ Line 179: / Line 179: @@
   | int
   | 4
-  | The low bound of the magnitude scale for values in this file. Note that this is still an integer in Stellarium's own internal representation
+  |class="rbn"| The low bound of the magnitude scale for values in this file. Note that this is still an integer in Stellarium's own internal representation
   |-
   | Magnitude Range
@@ Line 185: / Line 185: @@
   | int
   | 4
-  | The range of magnitudes expressed in this file
+  |class="rbn"| The range of magnitudes expressed in this file
   |-
   | Magnitude Steps
@@ Line 191: / Line 191: @@
   | int
   | 4
-  | The number of steps used to describes values in the range
+  |class="rbn"| The number of steps used to describes values in the range
   |}
 ====Zone Records====
 The ''Zone Records'' section of the file lists the number of star records there are per zone. The number of zones is determined from the level value in the File Header Record, as described in section [[Star_Catalogue#Zones|Zones]]. The Zones section is simply a list of integer values which describe the number of stars for each zone. The total length of the Zones section depends on the number of zones. See table ''Zones section''.

@@ Line 115: / Line 115: @@
 ===File Sections===
 The catalogue files are split into three main sections as described in table ''File sections''.
-{| class="standard"
+{| class="guidetable"
   |+ File sections
   | ''Section''
   | ''Offset''
-  | ''Description''
+  |class="rbn"| ''Description''
   |-
   | File Header Record
   | 0
-  | Contains magic number, geodesic subdivision level, and magnitude range
+  |class="rbn"| Contains magic number, geodesic subdivision level, and magnitude range
   |-
   | Zone Records
   | 32
-  | A list of how many records there are for each zone. The length of the zones section depends on the level value from the header
+  |class="rbn"| A list of how many records there are for each zone. The length of the zones section depends on the level value from the header
   |-
   | Star Data Records
   | 32+4''n''
-  | This section of the file contains fixed-size star records, as described below. Records do not contain zone information, which must be inferred by counting how many records have been read so far and switching zones when enough have been read to fill the number of stars for the zone, as specified in the zones section above. The value of ''n'' used in the offset description is the number of zones, as described above.
+  |class="rbn"| This section of the file contains fixed-size star records, as described below. Records do not contain zone information, which must be inferred by counting how many records have been read so far and switching zones when enough have been read to fill the number of stars for the zone, as specified in the zones section above. The value of ''n'' used in the offset description is the number of zones, as described above.
   |}
 ===Record Types===
 ====File Header Record====

@@ Line 39: / Line 39: @@
 A given catalogue file models stars for one and only one level (i.e. for a fixed number of zones), which is recorded in the header of the file. Individual star records do not contain full positional coordinates, instead they contain coordinates relative to the central position of the zone they occupy. Thus, when parsing star catalogues, it is necessary to know about the zone model to be able to extract positional data.
-{| style="background-color:transparent;border:3px double #aaa;border-collapse:collapse;"
+{| class="guidetable"
   |+ Stellarium's star catalogue files
-  !style="border-right:1px dotted #aaa;padding:5px;"| ''File''
+  | ''File''
-  !style="border-right:1px dotted #aaa;padding:5px;"| ''Data Type''
+  | ''Data Type''
-  !style="border-right:1px dotted #aaa;padding:5px;"| ''Data Record Size''
+  | ''Data Record Size''
-  !style="border-right:1px dotted #aaa;padding:5px;"| ''Geodesic Level''
+  | ''Geodesic Level''
-  !style="border-right:1px dotted #aaa;padding:5px;"| ''#Records''
+  | ''#Records''
-  !style="padding:5px;"| ''Notes''
+  !class="rbn"| ''Notes''
-  |- style="vertical-align:text-top;"
+  |-
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|stars_0_0v0_1.cat
+  |stars_0_0v0_1.cat
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|0
+  |0
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|28 bytes
+  |28 bytes
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|0
+  |0
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|5,013
+  |5,013
-  |style="border-top:1px solid #aaa;padding:5px;"|Hipparcos
+  |class="rbn"|Hipparcos
-  |- style="vertical-align:text-top;"
+  |-
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|stars_1_0v0_1.cat
+  |stars_1_0v0_1.cat
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|0
+  |0
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|28 bytes
+  |28 bytes
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|1
+  |1
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|21,999
+  |21,999
-  |style="border-top:1px solid #aaa;padding:5px;"|Hipparcos
+  |class="rbn"|Hipparcos
-  |- style="vertical-align:text-top;"
+  |-
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|stars_2_0v0_1.cat
+  |stars_2_0v0_1.cat
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|0
+  |0
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|28 bytes
+  |28 bytes
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|2
+  |2
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|151,516
+  |151,516
-  |style="border-top:1px solid #aaa;padding:5px;"|Hipparcos
+  |class="rbn"|Hipparcos
-  |- style="vertical-align:text-top;"
+  |-
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|stars_3_1v0_0.cat
+  |stars_3_1v0_0.cat
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|1
+  |1
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|10 bytes
+  |10 bytes
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|3
+  |3
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|434,064
+  |434,064
-  |style="border-top:1px solid #aaa;padding:5px;"|Tycho
+  |class="rbn"|Tycho
-  |- style="vertical-align:text-top;"
+  |-
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|stars_4_1v0_0.cat
+  |stars_4_1v0_0.cat
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|1
+  |1
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|10 bytes
+  |10 bytes
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|4
+  |4
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|1,725,497
+  |1,725,497
-  |style="border-top:1px solid #aaa;padding:5px;"|Tycho
+  |class="rbn"|Tycho
-  |- style="vertical-align:text-top;"
+  |-
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|stars_5_2v0_0.cat
+  |stars_5_2v0_0.cat
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|2
+  |2
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|8 bytes
+  |8 bytes
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|5
+  |5
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|7,669,011
+  |7,669,011
-  |style="border-top:1px solid #aaa;padding:5px;"|NOMAD
+  |class="rbn"|NOMAD
-  |- style="vertical-align:text-top;"
+  |-
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|stars_6_2v0_0.cat
+  |stars_6_2v0_0.cat
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|2
+  |2
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|8 bytes
+  |8 bytes
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|6
+  |6
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|26,615,233
+  |26,615,233
-  |style="border-top:1px solid #aaa;padding:5px;"|NOMAD
+  |class="rbn"|NOMAD
-  |- style="vertical-align:text-top;"
+  |-
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|stars_7_2v0_0.cat
+  |stars_7_2v0_0.cat
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|2
+  |2
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|8 bytes
+  |8 bytes
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|7
+  |7
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|57,826,266
+  |57,826,266
-  |style="border-top:1px solid #aaa;padding:5px;"|NOMAD
+  |class="rbn"|NOMAD
-  |- style="vertical-align:text-top;"
+  |-
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|stars_8_2v0_0.cat
+  |stars_8_2v0_0.cat
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|2
+  |2
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|8 bytes
+  |8 bytes
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|7
+  |7
-  |style="border-top:1px solid #aaa;border-right:1px dotted #aaa;padding:5px;"|116,923,084
+  |116,923,084
-  |style="border-top:1px solid #aaa;padding:5px;"|NOMAD
+  |class="rbn"|NOMAD
   |}
 For a given catalogue file, there may be one of three formats for the actual star data. The variation comes from the source of the data - the larger catalogues of fainter stars providing less data per star than the brighter star catalogues. See tables ''Stellarium's star catalogue'' and for details.