Settings by initialization script

Most of sph.input applies to every run: the timestep controls, the equation of state and the output intervals are read by the integrator and mean the same thing whatever INAME is set to.

The settings below are the exception. Each is read only by the setup routines listed, so setting one for any other script has no effect and produces no warning. This page is generated from the source, by looking at which file actually mentions each variable.

`1es`, a single polytrope

Variable	Default	Meaning
`equalmass`	`0`	particle mass is proportional to rho^(1-equalmass), so equalmass=1 has equal mass particles and equalmass=0 is for constant number density.
`starmass`	`1d0`	mass of the polytrope to build, in solar masses
`starradius`	`1d0`	radius of the polytrope to build, in solar radii

`1mc`, a single polytrope with a compact core

Variable	Default	Meaning
`equalmass`	`0`	particle mass is proportional to rho^(1-equalmass), so equalmass=1 has equal mass particles and equalmass=0 is for constant number density.
`starmass`	`1d0`	mass of the polytrope to build, in solar masses
`starradius`	`1d0`	radius of the polytrope to build, in solar radii

`2cr`, a corotating binary

Variable	Default	Meaning
`binaryfile`	`'input.bs'`	text file describing the binary, read by bps and 2cr
`mbh`	`10d0`	mass of the point mass used as the second object when startfile2 is absent
`startfile1`	`'sph.start1u'`	first body of the encounter, in out*.sph format, usually the last snapshot of a relaxation
`startfile2`	`'sph.start2u'`	second body, same format as startfile1. If absent, a single point mass of mass mbh is used

`bhe`, an encounter with a supermassive black hole

Variable	Default	Meaning
`startfile1`	`'sph.start1u'`	first body of the encounter, in out*.sph format, usually the last snapshot of a relaxation
`startfile2`	`'sph.start2u'`	second body, same format as startfile1. If absent, a single point mass of mass mbh is used
`triplefile`	`'input.3s'`	text file describing the third body, read by bhe and tri

`bph`, a binary plus a black hole

Variable	Default	Meaning
`bpbhfile`	`'sph.bpbh'`	text file giving the orientation angles and black hole mass, read by bph
`e0`	`-1.d30`	orbital eccentricity: 1 is parabolic, above 1 hyperbolic, below 1 bound
`semimajoraxis`	`0.d0`	orbital semimajor axis. 0 means unset, so that it is deduced from the others
`startfile1`	`'sph.start1u'`	first body of the encounter, in out*.sph format, usually the last snapshot of a relaxation
`vinf2`	`1.d30`	square of the relative speed at infinity. 1d30 means unset, so it is deduced from the others

`bps`, a binary plus a single star

Variable	Default	Meaning
`binaryfile`	`'input.bs'`	text file describing the binary, read by bps and 2cr
`startfile1`	`'sph.start1u'`	first body of the encounter, in out*.sph format, usually the last snapshot of a relaxation
`startfile2`	`'sph.start2u'`	second body, same format as startfile1. If absent, a single point mass of mass mbh is used

`erg`, a star from a stellar-evolution profile

Variable	Default	Meaning
`equalmass`	`0`	particle mass is proportional to rho^(1-equalmass), so equalmass=1 has equal mass particles and equalmass=0 is for constant number density.
`mco`	`-1d30`	mass of compact object or core particle
`profilefile`	`'eg.last1.muse_s2mm'`	stellar-evolution profile that erg builds its star from
`stellarevolutioncodetype`	`1`	which code wrote profilefile, since the column layouts differ

`hbs`, a binary encountering a single star

Variable	Default	Meaning
`e0`	`-1.d30`	orbital eccentricity: 1 is parabolic, above 1 hyperbolic, below 1 bound
`impactparameter`	`-1.d30`	impact parameter at infinity, an alternative to rp, converted to it using angular momentum
`mbh`	`10d0`	mass of the point mass used as the second object when startfile2 is absent
`semimajoraxis`	`0.d0`	orbital semimajor axis. 0 means unset, so that it is deduced from the others
`startfile1`	`'sph.start1u'`	first body of the encounter, in out*.sph format, usually the last snapshot of a relaxation
`vinf2`	`1.d30`	square of the relative speed at infinity. 1d30 means unset, so it is deduced from the others

`hyp`, two bodies on a Keplerian orbit

Variable	Default	Meaning
`advectedfile`	`'sph.passivelyAdvected'`	per-particle passively advected quantities, read by hyp when present
`bbh_argperi`	`0d0`	argument of periapsis of the compact-object binary, in degrees
`bbh_e0`	`-1.d30`	eccentricity of the compact-object binary
`bbh_inclination`	`0d0`	inclination of the compact-object binary, in degrees
`bbh_longitude`	`0d0`	longitude of the ascending node of the compact-object binary, in degrees
`bbh_m1`	`-1d0`	first mass of a compact-object binary. Required, and only used, when bbh_m2 is positive
`bbh_m2`	`-1d0`	second mass of a compact-object binary. Negative means unset, giving a single point mass of mass mbh
`bbh_rp`	`-1.d30`	separation at closest approach for the compact-object binary
`bbh_semimajoraxis`	`0.d0`	semimajor axis of the compact-object binary. 0 means unset
`bbh_trueanomaly`	`0d0`	true anomaly of the compact-object binary, in degrees
`bbh_vinf2`	`1.d30`	square of the relative speed at infinity for the compact-object binary. 1d30 means unset
`e0`	`-1.d30`	orbital eccentricity: 1 is parabolic, above 1 hyperbolic, below 1 bound
`impactparameter`	`-1.d30`	impact parameter at infinity, an alternative to rp, converted to it using angular momentum
`mbh`	`10d0`	mass of the point mass used as the second object when startfile2 is absent
`semimajoraxis`	`0.d0`	orbital semimajor axis. 0 means unset, so that it is deduced from the others
`startfile1`	`'sph.start1u'`	first body of the encounter, in out*.sph format, usually the last snapshot of a relaxation
`startfile2`	`'sph.start2u'`	second body, same format as startfile1. If absent, a single point mass of mass mbh is used
`vinf2`	`1.d30`	square of the relative speed at infinity. 1d30 means unset, so it is deduced from the others

`meq`, a star whose particle-mass scheme varies with position

Variable	Default	Meaning
`equalmass`	`0`	particle mass is proportional to rho^(1-equalmass), so equalmass=1 has equal mass particles and equalmass=0 is for constant number density.

`res`, a rescaling of an existing model

Variable	Default	Meaning
`startfile1`	`'sph.start1u'`	first body of the encounter, in out*.sph format, usually the last snapshot of a relaxation

`tri`, a triple system

Variable	Default	Meaning
`startfile1`	`'sph.start1u'`	first body of the encounter, in out*.sph format, usually the last snapshot of a relaxation
`startfile2`	`'sph.start2u'`	second body, same format as startfile1. If absent, a single point mass of mass mbh is used
`startfile3`	`'sph.start3u'`	third body of a triple, same format as startfile1
`triplefile`	`'input.3s'`	text file describing the third body, read by bhe and tri

`txt`, particles laid out from an ASCII image

Variable	Default	Meaning
`imagefile`	`'sph.image'`	ASCII picture that txt turns into a particle layout

Settings by initialization script

1es, a single polytrope

1mc, a single polytrope with a compact core

2cr, a corotating binary

bhe, an encounter with a supermassive black hole

bph, a binary plus a black hole

bps, a binary plus a single star

erg, a star from a stellar-evolution profile

hbs, a binary encountering a single star

hyp, two bodies on a Keplerian orbit

meq, a star whose particle-mass scheme varies with position

res, a rescaling of an existing model

tri, a triple system

txt, particles laid out from an ASCII image