Skip to content

NCAR/music-box

Repository files navigation

MusicBox

MusicBox: A MUSICA model for boxes and columns.

License CI Status

Copyright (C) 2020 National Center for Atmospheric Research

Installation

The project is configured to be installed using pip by the pyproject.toml file.

This package requires musica to be installed in order to run. musica can be installed by running:

pip install musica==0.6.1.dev0

To install the music-box package into a Python environment, run the following command from the root directory:

pip install .

The package is also available on PyPi and can be installed in any Python environment through:

pip install acom_music_box

Tests

The tests directory contains 4 different tests that can be ran with PyTest. PyTest can be installed by running:

pip install pytest

After PyTest is intalled, the tests can be ran through the following commands from the root directory:

cd tests
pytest

Documentation

MusicBox documentation can be built using Sphinx. Sphinx can be installed by running:

pip install sphinx

After installing Sphinx, the documentation can be generated by running the following commands in the root directory:

cd doc/sphinx_files
make html

Then, open music-box/doc/sphinx_files/build/html/index.html in a browser.

The documentation includes more detailed instructions for configuring the model, along with developer resources.