Skip to content

Kerbal Weather Project is a groundbreaking weather and climate mod for Kerbal Space Program.

License

Notifications You must be signed in to change notification settings

panarchist/KerbalWeatherProject

 
 

Repository files navigation

Kerbal Weather Project

Kerbal Space Program (KSP) is a popular space-flight simulation video game that has been used as a creative sandbox to promote and teach STEM concepts (Manley, 2016). While the game simulates atmospheres with variable depths and densities it lacks dynamic weather limiting its utility as tool for exploring atmospheric science concepts. To remedy this, Kerbal weather Project (KWP) was developed. In KWP, weather and climate data from a global circulation model (MPAS) were incorporated into KSP gameplay through a C# plugin. More information about KWP is available at the mod webpage. The science behind KWP, as well as its potential as an educational tool, will be presented at the 101st Annual Meeting of the American Meteorological Society (AMS) in January 2021. A link to the AMS poster presentation on KWP is provided here.

Installation

Required Mods

Recommended Mods

Manual Installation
  1. Download and install Toolbar Controller
  2. Download and install ModularFlightIntegrator
  3. Download the repository as a zip or clone it.
  4. Unzip the repository and copy the KerbalWeatherProject folder to your KSP home directory (i.e. GameData folder).
Automatic Installation (Coming Soon - Mod has not been added to CKAN yet)

Using CKAN select Kerbal Weather Project and click install! CKAN should automatically install the two dependencies of the mod: toolbar controller and modular fight integrator. If you'd like to emulate the collection of real-world weather data you can also select KerBalloons in CKAN. This repository provides a wide array of balloons capable of lifting both sensors and Kerbals!

Compatability

KWP works with stock KSP and should work with the vast majority of KSP mods. KWP has been tested, without issue, in a KSP 1.10 playthrough with 220 other popular KSP mods. That said, KWP may conflict with mods like real heat or deadly reentry that modify the stock game's aerodynamic or thermodynamic system. KWP can still be used with these mods as KWP's override of the stock thermodynamic system can be disabled in the settings menu.

KWP is compatible with the aerodynamics overhaul: Ferram Aerospace Research (FAR). Note that since FAR overrides KSP's thermodynamic system, pressure and temperature data from KWP will not affect flight dynamics when FAR is installed.

Background

Kerbin weather and climate analyses were produced using the Model for Prediction Across Scale (MPAS; Skamarock et al., 2012)

MPAS was run for six-years (1st year: spin-up) at a resolution of 2 x 2 decimal degrees. Fortunately, [Kerbin’s atmosphere](https://wiki.kerbalspaceprogram.com/wiki/Kerbin#Atmosphere) has the same chemical composition as Earth’s.

In MPAS, terrain and biome data from KSP were used to classify land use, vegetation type, green fraction, etc.

In addition to land surface modifications, several changes to MPAS were made to enable more realistic simulations of Kerbin's atmosphere. These changes are listed below:

  1. Axial obliquity was set to zero.
  2. Orbital eccentricity was set to zero.
  3. The solar constant was set to 1360 W/m2
  4. The day length was set to 6 hours (21600 s)
  5. The Coriolis parameter was multiplied by 4.

A climatology of Kerbin was developed by averaging the results of the five-year MPAS simulation, by the hour. Results from this simulation were incorporated into the game via KWP. The hourly climatology allows players to experience diurnal and spatial variations in atmospheric conditions Alternatively, weather time series, extracted at select launch sites, allow players to experience dynamic weather conditions.

Settings

On the settings page, KWP parameters and defaults can be adjusted. Under weather settings, the default data source can be selected as either climatology or point weather data. The MPAS climatology ensures weather conditions will vary spatially and diurnally. In contrast, point weather data will allow weather to change in time and height, at selected launch sites. Users can select whether KWP will affect KSP's aerodynamic or thermodynamic models under weather settings. This is useful if using other mods that influence these models.

Under wind settings, KWP includes options for the source of wind data. By default, wind data will be provided by MPAS. As an alternative, a constant wind profile can be selected and tweaked to the player's preferred direction and speed. An additional option, for disabling wind within 50-m of the ground, is provided for players who find landing/takeoff in the presence of wind too challenging.

Since KSP is a game enjoyed around the world, KWP incorporates unit settings that allow players to select their preferred units for meteorological parameters. The units default to S.I. units.

Acknowledgements

  • KSP Developer Squad and KSP creator Felipe Falanghe.
  • KSP Modding Community – specifically KSP forum users linuxgurugamer, JoePatrick1, Fengist, DaMichel, NathanKell, and DMagic. These mod developers, by publishing their code publicly, provided a valuable teaching tool which facilitated many of the advancements implemented in KWP. Without their prior work, incorporating weather data into KSP would have been exceedingly difficult.

References

Manley (2016), Can Kerbal Space Program Really Teach Rocket Science? https://www.youtube.com/watch?v=ogC6ds81gek. Accessed 12 December 2020.

Skamarock, W. C., J. B. Klemp, M. G. Duda, L. D. Fowler, S. Park, and T. D. Ringler, 2012: A Multiscale Nonhydrostatic Atmospheric Model Using Centroidal Voronoi Tesselations and C-Grid Staggering. Mon. Wea. Rev., 140, 3090–3105, https://doi.org/10.1175/MWR-D-11-00215.1.

About

Kerbal Weather Project is a groundbreaking weather and climate mod for Kerbal Space Program.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%