/interactive_earth

Primary LanguageC++GNU General Public License v2.0GPL-2.0

Interactive Earth

Interactive Earth is a teaching tool for demonstrating mantle convection and its dependence on Rayleigh number. It enables a mantle convection model to be run much more quickly than the codes typically used in research. It solves the same governing equations, but makes comprimises for accuracy for the sake of achieving speed. This speed enables the code to be very responsive to user input.

The simulations can be run in a browser without running any local code here.

More about the project can be found here.

An introduction to the underlying science can be found here.

Compiling on Ubuntu Linux

  • Install fftw3, SDL2, and GLEW using apt-get install libfftw3-dev libsdl2-dev libglew-dev
  • Rename Makefile.linux to makefile
  • Run make on the command line to compile the project
  • run the program by typing its path and name in the command line: ./interactive_earth

Compiling on a Mac

  • brew install the following dependencies: fftw3, SDL2, GLEW
  • rename Makefile.osx to makefile
  • run the command make in the command line
  • run the program by typing its path and name in the command line: ./interactive_earth

Compiling to Javascript

Interactive Earth may be run in the web browser by compiling it to Javascript using emscripten. This takes a bit more work, since you must compile SDL2 and fftw3 manually as well, but can be done. The finished product can be seen here.

User input

With the simulation running, the user can make the following changes:

  • put in positive temperature anomalies (add heat) by clicking
  • put in negative thermal anomalies (remove heat) by right-clicking
  • change the Rayleigh number (the vigor of convection) by scrolling
  • press space to pause the simulation. while it is paused one can click to add earthquakes.

Changing simulation behavior for advanced users

The behavior of the simulation can be modified by changing parameters within the upper part of the main.cpp file. The parameters that readily exposed for being modified include:

  • the resolution of the simulation (and thereby how quickly it runs)
  • whether or not to do a true polar wander (TPW) calculation
  • whether to included a chemical field
  • whether to render the simulation with flattened with an equatorial bulge