Skip to content

Getting started

It is recommended to have a look at Running Snowpack once you have installed SNOWPACK on your system.

Getting SNOWPACK

In order to reduce the maintenance burden and to make SNOWPACK easier to tailor to specific needs, it has been decomposed into several tools:

  • inishell for graphical configuration of the simulations. Please use it to configure your simulations, it makes it much easier!
  • MeteoIO for data retrieval and preprocessing
  • the snowpack model with its libsnowpack
  • niViz for simulation output visualization (or go to https://niviz.org)

Precompiled SNOWPACK

The Snowpack releases that are found in the Downloads bundle MeteoIO and Snowpack but NOT Inishell that has to be downloaded separately. They are available for Linux, Windows and osX and contain an HTML documentation (either in the start menu or in the share sub-folder of the installation directory).

SNOWPACK from source

Please have a look at the same page for MeteoIO: Getting-started. If you recompile SNOWPACK from sources, you need to download and install a few other of the package mentioned above. At the minimum, you need to have MeteoIO on your system, compiled and preferably installed.

Directory structure

If you don't want to install MeteoIO on your system, it is highly recommended to keep the following directory structure (so it can still be automatically found):

                💻
                ┣━━╾ 📂 snowpack trunk
                ┗━━╾ 📂 meteoio trunk

If you install MeteoIO, you have to provide the installation root directory to cmake (something such as "/usr" or "~/usr") and make sure this directory exists. Please do not confuse the source directory (ie where your sources are) and the installation directory (where the compiled versions are made available to your system). When you do a make install, you basically copy the binaries from your source directory to the install directory of your choice.

Online Documentation

Regarding the documentation, you can either generate it from your download using doxygen (see MeteoIO's Getting-started) or separately download a documentation only package (in the Downloads).

Having SNOWPACK in your PATH

In order to run SNOWPACK from the command line without having to type its full path every time, SNOWPACK's path should be added to the PATH environment variable (if this has not already been done by the installer).

PATH for Linux and MacOS

Edit either your ${HOME}/.profile or ${HOME}/.bashrc file (on MacOS, it is recommended to put it in ${HOME}/.bash_profile) and add the following:

  • on both Linux and MacOS: export PATH={install path to SNOWPACK}/bin:$PATH
  • on Linux: export LD_LIBRARY_PATH={install path to SNOWPACK}/lib:$LD_LIBRARY_PATH
  • on MacOS: export DYLD_FALLBACK_LIBRARY_PATH={install path to SNOWPACK}/lib:$DYLD_FALLBACK_LIBRARY_PATH

On MacOS, this file might have to be created, see tech-recipes.com.

PATH for Windows

When using a pre-compiled package, this step should not be necessary. However, if you did not use a pre-compiled package or if the installer failed, you should check/do this step. The exact location depend on the version of Windows that you are using. For Windows7, from the start menu, got to: Start > Control Panel > System and Security > System > Advanced system settings. Then in the Advanced tab, either create/edit the PATH variable in the User variables or in the System variables to contain {install path to SNOWPACK}/bin.

Running Snowpack

Please have a look at Running Snowpack.

When something does not work

Please have a look at Getting Help.