plutonianempire/stargen

Stargen is a program that generates random solar systems

This is a fork of a version of stargen from https://github.com/sirus20x6/stargen

New Features

• Preset Mie Atmospheres.
• Fixed IC 3094 Spectral types.
• Earthlike generation around B and A stars. (Unrealistic, I know.)

TODO (Probably too optimistic given my limited abilities, but w/e.)

• Port over whatever additional changes made by sirus20x6.
• Fix certain rotational parameters.
• Split albedos into BondAlbedo and GeomAlbedo.
• Add an export option to export planets to SpaceEngine .sc script.
• Fix distances of moons; they are currently based solely on hill spheres; making the innermost moons take 90 days to orbit a planet that is far from their sun(s).

Known Issues

• A typo I can't find is causing radius errors for certain planet masses, causing StarGen to quit. This will interfere with large batches of systems. Only solution is to start over. :(

Build instructions

git clone https://github.com/PlutonianEmpire/stargen.git
cd stargen
cmake ./CMakeLists.txt
cmake --build .

Tip use

make -jx

where x is number of threads +1 to compile faster

Command Line Usage

Usage: stargen [options] [system name]
  Options:
Seed values:
    -s#  Set random number seed [default: from time]
    -i#  Number to increment each random seed [default: 1]
    -n#  Specify number of systems [default: 1]
    -A#  set accretion dust density ratio_arg to # [default: 0.0]
    -q#  set accretion inner dust border to # [default: 0.3]
    -Q#  set accretion planetesimal seed eccentricity coefficient to # [default: 0.077]
Preset seeds:
    -k   Use known planets as planitesimal seeds [from internal tables]
    -K   Generate only known planets [from internal tables]
    -x   Use the Solar System's masses/orbits
    -a   Use the Solar System's masses/orbits varying Earth
Stars:
	Please note that for a custom star, you need to specify a mass and/or a luminosity
	as well as a spectral type and/or a temperature. Other wise the program will not work.
    -m#  Specify stellar mass # [fraction of Sun's mass] (optional if -y is used)
    -y#  Specify stellar luminosity # [fraction of Sun's luminosity] (optional if -m is used)
    -Y#  Specify minimum age for star (years) (optional)
    -MY# Specify maximum age for star (years) (optional)
    -b#  The temperature of the star (optional if -B is used)
    -B   Spectral type of the star (optional if -b is used)
    -CB  Make this a circumbinary system like Tatoonine in Star Wars (optional)
    -w#  The mass of a companion star (optional and required if the -CB option is used)
    -j#  The luminosity of a companion star (optional and required if the -CB option is used)
    -X#  The temperature of a companion star (optional and required if the -CB option is used)
    -N   Spectral type of the companion star (optional and required if the -CB option is used)
    -d#  The distance to a companion star (optional and required if the -CB option is used)
    -f#  The eccentricity of the orbit of the companion star (optional and required if the -CB option is used)
  For a predefined star:
    -D   Use all of Dole's 16 nearby stars
    -D#  Use Dole's system #
    -F   Use all 34 AU systems
    -F#  Use AU system #
    -W   Use all 78 nearby stars taken from the Web
    -W#  Use Web system #
    -O   Use all 307283 fictious stars in the fictious Omega Galaxy
    -O#  Use Omega Galaxy system #
    -R   Use all 60001 fictious stars in the fictious Ring Universe galaxy
    -R#  Use Ring Universe system #
    -I   Use all 5001 fictious stars in IC 3094 that cham generated
    -I#  Use IC 3094 system #
    -U   Use all 1001 fictious stars in the Andromeda Galaxy that cham generated
    -U#  Use Andromeda Galaxy system #
    -G   Use the 22 predefined stars from Star Trek
    -G#  Use Star Trek system #
    -PHL Use the 41 predefined stars listed at the Planetary Habitability Library
    -PHL#Use potentially habitable system #
    -l   List stars of selected table and exit
    -L   List stars of selected table as HTML and exit
Filters:
    Please note that these options are only usefull if you are making
	a large batch of systems and only want to save certain ones.
    -E   Only systems with earthlike planets
    -H   Only systems with habitable planets
    -2   Only systems with 2 or more habitable planets
    -3   Only systems with 3 or more habitable planets
    -T   Only systems with habitable planets more than 2 Earth Masses in size
    -P   Only systems with planets habitable by the Planetary Habitability Laboratory's criteria
    -J   Only systems with Jovian planets in habitable region
    -g   Include atmospheric gases
    -v   List verbosities [hex values] and exit
    -v#  Set output verbosity [hex value]
    -V   Use vector graphics [SVG] images [default: GIF]
    -z   Do numeric size check and exit
    -Z   Dump tables used for gases and exit
File specs:
    --   use stdout
    -o   Name for the output file(s) [default: taken from star name]
    -p   Path for where the output file(s) are saved [default: ./html]
    -u   Internet URL path for/in the output file(s) [default: none]
Output formats: (only one is generated) default HTML to file
    -c   Celestia .ssc to stdout
    -C   Excel .csv [dl: no thumbnail html] to file
    -JS  JSON .json [dl: no thumbnail html] to file
    -e   Excel .csv to file
    -S   Vector graphics (SVG) to file
    -t   Text to stdout
    -sn# Number of decimal places for numbers
Other:
    -M   Generate moons (highly experimental and incomplete)
    -r   Allow planet migration after forming. (highly experimental)
    -ak  Acknowledgement
    -ex  Examples

HTML Output