A planetary system config file has a content similar to the following. The extension for
this file is usually
.cfg, but it can be any extension. It is called at runtime by the use of the
Any blank line or line begining this a # is ignored.
A line containing a planet description contains the following information (the separators between the different fields can be an arbitray number, or combination, of tabulations and spaces):
- The first field is the planet name. It must begin with a character (‘a’ to ‘z’ or ‘A’ to ‘Z’).
Jupiter4is a valid planet name,
15earthmassis not : this planet will not be recognised.
- The second field is the planet orbital radius . Note that the planet at has , , and (unless you give it some eccentricity).
- The third field is the planet to primary mass ratio. Note that the primary is assumed to have mass 1.
- The fourth parameter sets the accretion properties within the Roche lobe. It is the inverse of the accretion timescale, therefore setting this parameter to 0 inhibits accretion. For further details about the accretion procedure, see Kley (1999) or have a look at the function
- The fifth parameter has to be either
NO. It indicates whether the planet “feels” the disk tidal field or not. If you want the planet to remain on a fixed circular orbit, set this field to
NO. Setting it to
YESallows the planet to migrate.
- Finally, the sixth and last parameter indicates whether this planet feels the potential of the other planets possibly present in the system. You have to set it to
YESif you want for instance to get mean motion resonances between the planets. Note that a planet always feels the primary potential.