Skip to content
Lincoln Samelson edited this page Apr 29, 2016 · 17 revisions

Cryo3D is a JavaScript tool for visualizing snow and ice data in 3D. Cryo3D helps you bring your virtual reality visualizations to life using Javascript and CesiumJS. Our goal is to combine powerful visualization with a data-driven approach to help educate and promote climate change awareness around the world.

Modifying Cryo3D

For explanations of important files and basic navigation of the Cryo3D code base, please follow these instructions.

Browser / Platform Support

Cryo3D works in all browsers. However, Oculus Rift functionality only works in Firefox. Download the latest version here: https://www.mozilla.org/en-US/firefox/new/

Installing

Download the latest version here: http://cryo3d.github.io/cryo3d/

Usage

  1. Start docker quickstart terminal. (Download Docker and setup if you haven't already)
  2. Clone the repo.
  3. Verify that you have a vhost.conf file in the static folder. If you are developing on linux, change the server_name to localhost. Otherwise, you will need to find your DockerHost variable and set the server_name to this value. Should you not have a vhost.conf file, click [here] (https://github.com/cryo3d/cryo3d/blob/master/vhost.conf) for a sample. Just download this file and save it in your static folder. Since vhost is unique depending on the OS and Docker configurations we created a gitignore for this file.
  4. Type in bash run.sh -r . To see a list of runflag options type in bash run.sh However, for most uses you should only need the -r option.

Here's some extra help on basic setup, cloning, pushing changes, and using Docker/Nginx

Making changes

If you want to modify how Cryo3D is implemented, click the "Fork" button in the top-right corner of this page, and then clone your fork from the command line by replacing username with your GitHub username:

git clone git://github.com/username/cryo3d.git