Metadata-Version: 2.1
Name: acom_music_box
Version: 2.1.1
Summary: This is the music_box package.
Author-email: NCAR/ACOM <musica-support@ucar.edu>
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: Apache Software License
Requires-Dist: musica==0.6.1.dev0
Project-URL: Home, https://github.com/NCAR/music-box


MusicBox
========

MusicBox: A MUSICA model for boxes and columns.

[![License](https://img.shields.io/github/license/NCAR/music-box.svg)](https://github.com/NCAR/music-box/blob/main/LICENSE)
[![CI Status](https://github.com/NCAR/music-box/actions/workflows/test.yml/badge.svg)](https://github.com/NCAR/music-box/actions/workflows/test.yml)

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`](https://pypi.org/project/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](https://docs.pytest.org/en/8.2.x/). 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](https://www.sphinx-doc.org/en/master/). 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.
