-
Notifications
You must be signed in to change notification settings - Fork 3
/
README
201 lines (167 loc) · 8.77 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
To build omega13a's version of Stargen on Linux,
1. install cmake
2. install compilars for C and C++
3. cd to the build directory
4. type the command
cmake ..
5. then type the command
make
To run Stargen on Linux, using the command line termal, cd to the directory Stargen is in and type the command:
./stargen
followed by what ever options you want. See below for more details about the options.
To build omega13a's version of Stargen on Windows,
1. install Cygwin. Be sure to also install all (including the devel packages) the cmake, gcc, libboost and the gsl packages
3. cd to the build directory
4. type the command in the Cygwin terminal
cmake ..
5. then type the command
make
To run Stargen on Windows, open the Cygwin terminal, cd to the dir Stargen is in and type the command:
./stargen.exe
followed by what ever options you want. See below for more details about the options.
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:
For a custom star:
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)
-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 77 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 #
-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
-e Excel .csv to file
-S Vector graphics (SVG) to file
-t Text to stdout
Other:
-M Generate moons (highly experimental and incomplete)
-r Allow planet migration after forming. (highly experimental)
Examples
10000 systems with 1 as the seed for the first system around a custom star with moons and migrated planets and only save ones with an earthlike planet:
stargen -m1.09 -y1.12609 -BG0V -b6215 -M -r -s1 -n10000 -E
10000 systems with 1 as the seed for the first system around a custom star in a circumbinary system with moons and migrated planets and only save ones with an earthlike planet:
stargen -m1.09 -y1.12609 -BG0V -b6215 -CB -w0.75 -j0.178473 -X4493 -NK3V -d0.11146 -f0.011 -M -r -s1 -n10000 -E
10000 systems with 1 as the seed for the first system around a predefined star:
stargen -W73 -M -r -s1 -n10000 -E
10000 systems with 1 as the seed for the first system around a custom star with a distant companion star with moons and migrated planets and only save ones with an earthlike planet:
stargen -m1.09 -y1.12609 -BG0V -b6215 -w0.75 -d1114.6 -f0.011 -M -r -s1 -n10000 -E
The text below was provided with the version of StarGen adapted by JimB.
It has *not* been updated to correspond to omega13a's version.
omega13a
==============================
Welcome to StarGen.
StarGen is a a random solar system generator, derived from the work of a
great number of people over the past three dozen years. (See Credits.txt for
details.) It's called StarGen because there are already enough versions that
call themselves starform to be confusing. StarGen's preferred output format
is its Web pages.
There are 4 differen distributions available. All of them contain:
ReadMe.txt The file you are reading
Credits.txt The history of the program
help A folder/directory containing
Manual.html The user's manual
Manual2-Building.html Software Developer's Manual
WinStarGenHelp.html Windows help
ref A folder containing
*.gif and Key.html Images etc used in generated HTML
*.jpg Images used in the Manual
To get more detailed documentation, feed the file Manual.html in the help
folder or directory to a Web browser or Help viewer that reads HTML files.
The Macintosh binary version (StarGen.sit) contains:
stargen Mac OS X command line version
StarGen PPC Classic Mac version compiled for PPC
StarGen 68K Classic Mac version for the original Mac
The Windows binary version (StarGen.zip) contains:
WinStarGen.exe Clickable Windows version
StarGen.exe DOS command-line version
The source distributions (StarGenSource.zip and StarGenSource.sit) contain:
C sources The source code for the
*.c and *.h program itself
Makefile Make file for Unix/Mac OS X
Macintosh-specific sources: Specific sources for
mac_prefix.h StarGen.r the Mac version
StarGen.prj
Windows project files: Project files for
StarGen.dsp StarGen.dsw Visual C on Windows
Stargen.rc resource.h
To build a Unix or Mac OS X version of StarGen, cd to the directory
containing the files listed above and type
make
You may need to edit the Makefile if you are using a version of Unix or
the GNU development tools very different from the Mac OS X and GNU C and
make that I used for development and testing.
To build the Macintosh-native version you will need a copy of Code
Warrior from Metrowerks. The supplied StarGen.prj file was created with
version 2.1 of Code Warrior and so should work with any version from the
last 5 years.
To build on Windows you will nee Visual C or to use the GNU development
tools from the command line.
To get more detailed documentation on building StarGen, feed the file
Manual2-Building.html in the help folder or directory to a Web browser or
Help viewer that reads HTML files.
JimB. aka Brons
Jim Burrows
Eldacur Technologies
http://www.eldacur.com/~brons/