Download Trojan clusters objects

Summary
Summary .............................................................................................................................................. 1
Template and guidelines ...................................................................................................................... 2
Model ............................................................................................................................................... 2
Parsing guidelines : .......................................................................................................................... 2
Root tags .............................................................................................................................................. 3
System .............................................................................................................................................. 3
Primary containers ............................................................................................................................... 4
Primary ............................................................................................................................................. 4
DoubleStar ....................................................................................................................................... 4
DoubleStarComponent ..................................................................................................................... 5
Orbital paths containers ....................................................................................................................... 6
Orbit ................................................................................................................................................. 6
MassiveObject .................................................................................................................................. 7
DoubleObject ................................................................................................................................... 7
DoubleObjectComponent................................................................................................................. 8
Bode orbits containers .......................................................................................................................... 9
BodeSequence .................................................................................................................................. 9
BodeOrbit ......................................................................................................................................... 9
Trojan clusters objects ....................................................................................................................... 10
Trojan ............................................................................................................................................. 10
AntiTrojan ...................................................................................................................................... 10
Cluster ............................................................................................................................................ 10
Stellar and Orbital bodies ................................................................................................................... 11
StarType ......................................................................................................................................... 12
Star ................................................................................................................................................. 12
PlanetType ..................................................................................................................................... 13
Planet .............................................................................................................................................. 13
Object3DType ................................................................................................................................ 14
Object3D ........................................................................................................................................ 14
JumpPoint....................................................................................................................................... 15
Template and guidelines
Just a template for copy-paste building of tags descriptions
Model
Description :
Allowed Attributes :
Subtags :
Comments :
Limits on subtags :
Parsing guidelines :
Tags generate objects
Attributes generate property values inside the objects
In some cases, a tag can generate a full subtree of objects
For instance, asteroids belt or cluster
Root tags
Define the contents of a stellar system
System
Description :
Defines a single stellar system
Codes location within the map and system contents
Attributes :
Name
1
Allowed Subtags :
Primary
1
BodeSequence
0-1
Orbit
0-n
Comments :
Allowed as root tag of a Stellar System XML file
Only one Bode Sequence is allowed as it is a global sequencing model
Extra orbits allow for extra objects outside the main sequence
Limits on subtags :
Summed masses of a Primary's satellites
Not heavier than 1/10 the Primary's mass
Inner orbital distance
Roche limit
Primary Separation if Primary is a double star
This is a stellar system. It always comprises a primary and can be built out of a Bode sequence with
extra orbits added by hand, or by directly entering orbits.
Primary containers
Define the structural tree of the primary, either a star or a double star
Primary
Description :
Defines the primary
This position always sits at (0;0;0) in system space
Attributes :
None
Allowed Subtags :
Star | DoubleStar
1
Limits on subtags :
None
This is a primary, located at the center of a stellar system. It is either a star or a double primary
object, that is, two stars linked to each other and orbiting around their common center of gravity.
DoubleStar
Description :
Defines a double object on a Primary position
Allowed Attributes :
Separation
1
Subtags :
DoubleStarComponent
2
Limits on subtags :
Mass ratio between lighter and heavier Components
Can not exceed 10
This is a double star sitting as a system's primary. It is defined by its separation radius, that is the
distance between the centers of the two components, and by a set of two stellar components.
DoubleStarComponent
Description :
Defines the first/second of a pair of objects within a DoubleStar
Must contain only a Star element
Can be surrounded by satellites
Allowed Attributes :
None
Subtags :
Star
1
BodeSequence
0-1
Orbit
0-n
Comments :
Actual positions will be computed from the mass ratio of the objects
BodeSequence and Orbit subtags define satellites around the Component
Limits on subtags :
Summed masses of the satellites
Cannot exceed 1/10 of the Star's mass
Inner orbital distance
Roche limit
Outer orbital distances
Computed from parent DoubleStar's Separation
It defines a stellar component from a double star. Each component is a star, but can also have
satellites, defined as in a single-star stellar system, by a set of orbits.
Orbital paths containers
Define the structural tree of either the system or a subsystem around a double star component
Orbit
Description :
Defines an orbital position around a parent object
Allowed Attributes : (to be redefined, see below)
Apocenter
1
MajorAxisDirection
0-1
Pericenter
0-1
AngularOffsetAtT0
0-1
Retrograde
0-1
Subtags :
Choice
MassiveObject | DoubleObject
1
BeltCluster
1..n
Comments :
The Retrograde attribute doesn't need a value
See Celestia EllipticalOrbit below :
Limits on subtags :
None
Inspired from the Celestia data model following :
EllipticalOrbit
{
Period <number>
SemiMajorAxis <number>
PericenterDistance <number>
ArgOfPericenter <degrees>
LongOfPericenter <degrees>
MeanAnomaly <degrees> # default: 0
MeanLongitude <degrees>
Eccentricity <number> # default: 0
Inclination <degrees> # default: 0.0
AscendingNode <degrees> # default = 0.0
Epoch <date> # default: J2000.0
}
The distances are specified by Apocenter and Pericenter instead of eccentricity, which is less easy
to interpret. Angles are also simplified because we only work in 2D here.
An orbit cannot be void. It must be checked for distance against its Parent's orbital physical limits.
It can hold a Trojan or AntiTrojan cluster on its stable Lagrange points L4 and L5.
MassiveObject
Description :
Defines a container within an orbit for a single massive object
Allowed Attributes :
None
Subtags :
Star | Planet | Object3D
| JumpPoint 1
Orbit
0-n
Trojan
0-1
AntiTrojan
0-1
Comments :
Orbit subtags define satellites of the MassiveObject
Limits on subtags :
Summed mass of all satellites
Cannot exceed 1/10 of the MassiveObject's mass
Inner orbital distance
Roche limit
Outer orbital distance
Computed from the parent hierarchy
This is a placeholder for a single massive object. This object can either be a star, a planet, a 3D
object or a jump point. It can have satellites defined as a set of Orbit subtags.
DoubleObject
Description :
Defines a double object
Allowed Attributes :
Separation
1
Subtags :
DoubleObjectComponent
2
Orbit
0-n
Trojan
0-1
AntiTrojan
0-1
Comments :
Orbit subtags define satellites of the DoubleObject
Limits on subtags :
Mass ratio between lighter and heavier Components
Cannot exceed 10
Summed mass of all satellites
Cannot exceed 1/10 of the MassiveObject's mass
Inner orbital distance
Computed from Roche limit and Separation
Outer orbital distance
Computed from the parent hierarchy
This is a double object, made up of two components.
DoubleObjectComponent
Description :
Defines the first/second of a pair of objects within a DoubleObject
Must contain a physical element
Allowed Attributes :
None
Subtags :
Star | Planet | Object3D | JumpPoint
1
Orbit
0-n
Comments :
Actual positions will be computed from the mass ratio of the objects
Orbit subtags define satellites of the Component
Limits on subtags :
Summed mass of all satellites
Cannot exceed 1/10 of the Component's mass
Inner orbital distance
Roche limit
Separation from the parent hierarchy
Outer orbital distance
Computed from the parent hierarchy
This is a component of a double object. It can also have satellites of its own.
Bode orbits containers
BodeSequence
Description :
Defines a series of regularly spaced orbital positions around a parent object
Allowed Attributes :
MinPeriod
1
DermottParameter
1
NumberOfOrbits
1
RandomSeed
1
Dispersion
0-1
Subtags :
BodeOrbit
n=Number
Comments :
Dermott law gives revolution periods as with T(0) and C defining the law :
This is a Bode sequence defining multiple orbits around a parent object. It is given by a minimum
distance, a parameter defining the objects spacing, and the number of orbits to create. Bode law is a
special case of the more general Dermott law, modeled here. A dispersion can be added, if absent,
orbits are regularly spaced as computed by Dermott law, otherwise, they are modified to be less
regular. A random seed must be specified.
This objects generates NumberOfOrbits independent orbits, which are then populated according to
the BodeOrbit subtags.
BodeOrbit
Description :
Defines an orbital position among a Bode sequence
Allowed Attributes :
Eccentricity
0-1
MajorAxisDirection
0-1
AngularOffsetAtT0
0-1
Retrograde
0-1
Subtags :
Choice
Empty
MassiveObject | DoubleObject
1
BeltCluster
1..n
Comments :
A place in a Bode sequence can be empty
Mean distance is provided by the Bode sequence
Comments :
Behaves like Orbit, except for distance, provided by parent BodeSequence
Apocenter and Pericenter are computer from Bode distance and Eccentricity
This is an orbital placeholder for a Bode sequence. It can hold a single or double object, or be void.
Trojan clusters objects
Trojan
Description :
Defines the Trojan (L4) position of an orbit
Must contain a cluster
Allowed Attributes :
None
Subtags :
Cluster
1-n
Comments :
Actual positions will be computed from the parent Orbit
This is a Trojan position. It must contain clusters of small objects.
AntiTrojan
Description :
Defines the anti-Trojan (L5) position of an orbit
Must contain a cluster
Allowed Attributes :
None
Subtags :
Cluster
1-n
Comments :
Actual positions will be computed from the parent Orbit
This is an anti-Trojan position. It must contain clusters of small objects.
Cluster
Description :
Generates multiple objects within a set distance of the location
Allowed Attributes :
Width
1
Angle
1
Number
1
ObjectsSet
1
RandomSeed
0-1
Subtags :
None
Comments :
Used only inside Lagrange point as they break regular orbit rules
All objects follow the Lagrange point
Their movement relative to the L-point must be simulated
This is a cluster of small objects, lying within the influence of a Lagrange point. The dispersion
parameters define an area in which the objects are randomly scattered. A random seed must be
specified. The total mass of all objects within a Cluster can not exceed 1/100 the main object's
mass.
Belt-like clusters objects
BeltCluster
Description :
Defines a belt-like cluster
Allowed Attributes :
Width
1
Number
1
ObjectsSet
1
RandomSeed
0-1
Subtags :
None
Comments :
Actual positions will be computed from the parent Orbit
This is a belt-like cluster of small objects, lying on an entire orbit.
Rings
Description :
Defines a set of rings around a planet
Allowed Attributes :
InnerWidth
1
OuterWidth
1
Number
1
ObjectsSet
1
RandomSeed
0-1
Texture
0-1
Subtags :
None
A rings set around a planet is defined by a texture used to represent it from afar and a belt-like
cluster of 3D objects used to navigate the individual ring objects. This is of course a simplification
as number of objects will amount to around 1000 instead of around 1e6 in real life.
Stellar and Orbital bodies
Define the physical elements that sit at the leafs of the system's structural tree
StarType
Description :
Defines a star type used for instantiating stars
Attributes :
StellarType
1
Mass
1
Radius
1
Texture
1
RotationPeriod
1
Allowed Subtags :
None
This is a stellar type (for instance G5V for the Sun). It is used to instantiate stars without having to
specify all recurring physical parameters every time.
Star
Description :
Defines a star that can be either a primary or an orbital object
Attributes :
CommonName
1
StellarType
1
Gliese
0-1
HD
0-1
HR
0-1
Hipparcos
0-1
BayerFlamsteed
0-1
OtherName
0-n
Mass
0-1
RotationPeriod
0-1
RotationOffsetAtT0
0-1
Radius
0-1
Texture
0-1
Allowed Subtags :
None
This is a single star. It is basically defined by its stellar type and common name. Optional naming
parameters can add up names in well-known nomenclatures or even user-set names. Optional
physical parameters can alter the star's appearance from the standard of its type, within preset limits.
PlanetType
Description :
Defines a type of large and spherical orbital object
Allowed Attributes :
PlanetType
1
Mass
1
RotationPeriod
1
Radius
1
Texture
1
Subtags :
None
This is a planet type (for instance “Telluric Desert” for Mars). It is used to instantiate planets
without having to specify all recurring physical parameters every time.
Planet
Description :
Defines a large and spherical orbital object
Allowed Attributes :
Name
1
PlanetType
1
Mass
0-1
RotationPeriod
0-1
RotationOffsetAtT0
0-1
Radius
0-1
Texture
0-1
Subtags :
Rings
0-1
This is a single planet, defined as a large spherical object. It is basically defined by referring to a
preset planet type and a name. Then, optional parameters can alter its appearance from the standard
of the type, within preset limits.
Object3DType
Description :
Defines a type of small non-spherical orbital object
Allowed Attributes :
Object3DType
1
Mass
1
RotationPeriod
1
Mesh
1
MeshScale
0-1
Texture
1
Subtags :
None
This is a type of 3D objects (for instance “XXIth Century Station” for the ISS or “Asteroid” for an
asteroid template). It is used to instantiate 3D objects without having to specify all recurring
physical parameters every time.
Object3D
Description :
Defines a small non-spherical orbital object
Allowed Attributes :
Name
1
Object3DType
1
Mass
0-1
RotationPeriod
0-1
RotationOffsetAtT0
0-1
Mesh
0-1
MeshScale
0-1
Texture
0-1
Subtags :
None
This is any non-spherical object, be it natural or artificial. It is basically defined by referring to a
preset 3D object type and a name. Then, optional parameters can alter its appearance from the
standard of the type, within preset limits.
JumpPoint
Description :
Defines a massive object that opens a tunnel to another system
Allowed Attributes :
Name
1
Mass
1
Subtags :
None
This is an invisible massive object that is linked to a tunnel end within the interstellar topology. It is
purely defined by its name and mass.
For now, Jump Points are not linked because the current model only specifies simple Stellar
Systems and no Jump Topology
In further interstellar mapping applications, Jump Points will be the base on which Jump Topology
will be built.