Skip to content

Planetary Data Hub

ballisticfox edited this page Dec 28, 2025 · 6 revisions

Sol Planetary Data Hub

Welcome to the Sol planetary data hub.

The goal of this hub is to provide users with physical and orbital data about every celestial object in Sol.

Below you can find links to every object in Sol and detailed information on which each variable means.

Tip

I've done my best to ensure units are presented when they might be ambiguous or relevant, values commonly used in KSP are:

  • m - meters
  • kg - kilograms
  • deg - degrees
  • u - unitless
  • K - kelvin

If you're interested in any of the details below check out the Kopernicus wiki


System Overview

Sol is split up into 11 different 'sectors' with each sector hosting their own hub.

[SystemMapImage]

Sectors:

  • [Sol]
  • [Mercury]
  • [Venus]
  • [Earth System]
  • [Mars System]
  • [Jupiter System]
  • [Saturn System]
  • [Uranus System]
  • [Neptune System]
  • [Asteroid Belt]
  • [Kuiper Belt]

System Information

The epoch of the solar system in Sol is 1951-Jan-01 00:00:00.000 UTC. This means the pacific starts facing towards the sun at the beginning of the game and Greenwich England is facing roughly toward the anti-solar point.

Note

Unlike RealSolarSystem which specifies time at the beginning of the BK4 reference epoch and runs time forward, Sol doesn't do this and elects to provide orbital parameters for the instant the system starts.

Sol is intended to be as accurate as possible to our real system. For specific interest on why specific celestials have been added to Sol and why some haven't you can read the blog [Choosing What to Add to Sol]. Generally though celestials were selected off of the following critera:

  • Is a major planet: Immediate add.
  • Is a major moon: Immediate add.
  • Visited by a spacecraft: Highly likely.
  • Interesting orbit: Increased likelihood.
  • Interesting geographical features: Somewhat increased likelihood.
  • Low amounts of imagery data: Highly unlikely.
  • Complex shape model: Highly unlikely.
  • Mean radius smaller than 450m~: Impossible.

Orbital Parameters

image

Orbits are defined by 7 different parameters in KSP, these are: semiMajorAxis, eccentricity, inclination, meanAnomalyAtEpochD. longitudeOfAscendingNode, argumentOfPeriapsis and epoch.

You can roughly think of these as doing the following:

  • semiMajorAxis (m): mean distance of the center from the center of the object.
  • eccentricity (u): the asymmetry Ap and Pe.
  • inclination (deg): the tilt of the orbital plane.
  • meanAnomalyAtEpochD (deg): how far along the orbit the satellite in degrees.
  • longitudeOfAscendingNode (deg): where the orbital plane crosses the ecliptic.
  • argumentOfPeriapsis (deg): where the periapsis is placed in the orbit.
  • epoch (seconds): when this state occurs

In reality all of these values shift around due to gravitational influences of their neighbors, but due to limitations in the patched conics system they remain static in KSP. For this reason we split these parameters into mean and instantaneous values.

  • semiMajorAxis, eccentricity and inclination are both averaged over a century of data points with a two day time interval between each point.
  • meanAnomalyAtEpochD, longitudeOfAscendingNode, argumentOfPeriapsis are instantaneous at the epoch.
  • epoch is always 0 unless the data points for the celestial don't exist at 1951-Jan-01.

Physical Parameters

In KSP celestial objects are defined by the following properties: radius, gravParameter, rotationPeriod, initialRotation.

  • Radius (m): is typically the minimum radius of the object, this is to avoid terrain being under 0m sea level as it can cause bugs with terrain rendering.
  • gravParameter (m^3/s^2): is the mass of the object multiplied by the gravitational parameter.
  • rotationPeriod (rev/s): number of seconds per revolution
  • initialRotation (deg): The location of the prime meridian relative to the "0-axis", which is defined by setting all orbital parameters to 0 and drawing a line as SMA approaches infinity.
  • isTidallyLocked (bool): whether the object is tidally locked to its parent. The same hemisphere always faces the parent object.
  • albedo (u): percentage of sunlight diffusely reflected by the object.
  • emissivity (u): percentage of incident thermal light re-emitted by the object.

Biome Parameters

In KSP each body has a biome map that specifies different geographical regions. These different geographical regions influence science reports and scatter spawning.

In Sol, biomes are encoded into an R8 array meaning each pixel only uses a single byte of information allowing for up to 256 different biomes.

Each biome has an internal reference name, a display name with localization, a science multiplier, and a color which matches an indexed color on the map.

Warning

Kerbalism does not respect the science multiplier values for biomes.


Science Values

KSP features science multipliers for each scenario you may find yourself when dealing with an object, these are:

  • landedDataValue
  • inSpaceLowDataValue
  • inSpaceHighDataValue
  • flyingLowDataValue
  • flyingHighDataValue
  • recoveryValue
  • flyingAltitudeThreshold (m): point at which you are considered "flying high / flying low".
  • spaceAltitudeThreshold (m) : point at which you are "in space high / in space low".

Atmosphere Parameters

KSP's atmosphere system has a weirdly complex temperature curve system allowing you to parameterize your atmosphere rather precisely.

Atmospheres are defined by the following values:

  • oxygen (bool)
  • adiabaticIndex (u)
  • atmosphereDepth/maxAltitude (m)
  • atmosphereMolarMass (kg/mol)
  • pressureCurve (m,kPa)
  • temperatureSeaLevel (K)
  • temperatureCurve (m, K)
  • temperatureSunMultCurve (m, scalar)
  • temperatureLatitudeBiasCurve (deg, K)
  • temperatureLatitudeSunMultCurve (deg, K)
  • temperatureAxialSunBiasCurve (trueAnomaly: deg, K)
  • temperatureAxialSunMultCurve (trueAnomaly: deg, K)
  • temperatureEccentricityBiasCurve (trueAnomaly: rad/pi, K)

Player Information


Planets & Technical


Credits & Licensing

  • [Credits]
  • [Licensing]

Clone this wiki locally