celestia/src/tools/stardb
Andrew Tribick 2f77629216 Fix parsing and display of luminosity classes Ia-0, Ia, and Ib
- Allow spaces before luminosity class in stc file
- Allow Ia-0 to be spelled "Ia-0" (as displayed), "Ia0" (as previously), or
  "I-a0" (previous display format) in stc file
- Remove str() and ostream << operators on StellarClass (only used in tests)
2022-02-19 11:33:15 +01:00
..
CMakeLists.txt Fix build failures reported by munix9 2020-07-13 11:23:50 +03:00
buildstardb.cpp Fix warnings reported by clang/gcc 2020-06-20 10:11:09 +03:00
buildstardb.pl Revised star database inclusion criteria: 2009-02-02 22:30:54 +00:00
celdat2txt.cpp Fix parsing and display of luminosity classes Ia-0, Ia, and Ib 2022-02-19 11:33:15 +01:00
makestardb.cpp Don't use deprecated methods 2021-05-21 17:44:43 +03:00
makexindex.cpp [tools] Don't allocate file streams on the heap 2020-05-07 20:37:26 +03:00
readme.txt [tools] Implement spherical option for new star database format in startextdump 2020-05-11 08:18:29 +03:00
startextdump.cpp Fix parsing and display of luminosity classes Ia-0, Ia, and Ib 2022-02-19 11:33:15 +01:00

readme.txt

STARTEXTDUMP:

The startextdump program converts a binary Celestia star database to an
easy to edit ASCII format.  The command line is:

startextdump [options] [<input file> [<output file>]]

If the output file is not provided, the ASCII star catalog is written to the
standard output stream.  The options are:

  --old (or -o)
  The input file is an old (Celestia 1.3.2 or earlier) format star database
  file.

  --spherical (or -s)
  Output spherical coordinates (RA/declination/distance) instead of the usual
  rectangular coordinates.  RA is in degrees instead of the more conventional
  hours/minutes/seconds.  Distance is in units of light years.  Also, the
  apparent magnitude will be written instead of the absolute magnitude.

  --hd <filename>
  Dump the HD catalog numbers of an old format star database to a separate
  file.  Each line of the output file has an HD catalog number followed by
  the corresponding HIPPARCOS number.  The file can be converted to a
  Celestia cross index with the makexindex tool.



MAKESTARDB:

Makestardb converts an ASCII star database created by startextdump to a
binary star database readable by Celestia--it is the reverse of the
startextdump.  Makestardb does not support the old star database format;
the output files it produces are only usable with versions of Celestia
newer than 1.3.2.

The command line is:

makestardb [--spherical] [<input file> [<output file>]]

If an input or output file isn't provided, the standard input or output stream
is used.  The --spherical option will cause makestardb to convert the input
positions from spherical to rectangular coordinates, and to convert the
magnitude from apparent to absolute.  Use --spherical for ASCII star files
generated when startextdump is run with its own --spherical option.



MAKEXINDEX:

A cross index file maps numbers from a star catalog to Celestia catalog
numbers.  Makeindex converts ASCII files containing pairs of catalog numbers
into binary cross index files.  The command line is:

makexindex [<input file> [<output file>]]

Star catalog numbers in the input file must be positive integers less than
2^32 - 1.