11# MUSE2 data analysis
22
3- Python scripts and Jupyter notebooks for analysing and visualising MUSE2 data files.
3+ > : warning : ** Note that this repository is currently a work in progress. ** : warning :
44
5- This is a Python application that uses [ uv] for packaging and dependency management.
6- It provides [ ` pre-commit ` ] [ pre-commit ] hooks for various linters
7- and formatters and automated tests using [ ` pytest ` ] [ pytest ] and [ GitHub Actions] .
8- Pre-commit hooks are automatically kept updated with a dedicated GitHub Action, this can
9- be removed and replaced with [ pre-commit.ci] if using a public repo. The package version
10- is dynamically generated from the most recent git tag using
11- [ ` setuptools-scm ` ] [ setuptools-scm ] .
5+ This repository contains Python scripts and Jupyter notebooks for analysing and
6+ visualising [ MUSE2] data files.
127
13- It was developed by the [ Imperial College Research Software Engineering Team] .
8+ We recommend using [ uv] for installing dependencies and managing your virtual
9+ environment.
1410
1511## Usage
1612
1713To get started:
1814
19151 . [ Download and install uv] following the instructions for your OS.
20- 1 . Activate a git repository (required for ` pre-commit ` and the package versioning with
21- ` setuptools-scm ` ):
22-
23- ```bash
24- git init
25- ```
2616
27171 . Install the package and dependencies and set up the virtual environment:
2818
@@ -44,53 +34,14 @@ the virtual environment (see [uv activate] for more info):
4434 uv run < command>
4535 ` ` `
4636
47- 1. Install the pre-commit git hooks:
48-
49- ` ` ` bash
50- uv run pre-commit install
51- ` ` `
52-
53- 1. Update the pre-commit hooks
54-
55- ` ` ` bash
56- uv run pre-commit autoupdate
57- ` ` `
58-
59- 1. Run the main app:
60-
61- ` ` ` bash
62- uv run python -m muse2_data_analysis
63- ` ` `
64-
65- 1. Run the tests:
66-
67- ` ` ` bash
68- uv run pytest
69- ` ` `
70-
71- 1. Create an initial commit (it' s possible there might be some failures in pre-commit):
72-
73- ```bash
74- git add .
75- git commit -m "Initial commit"
76- ```
77-
78- ## Updating Dependencies
79-
80- Use the commands `uv add <package>` and `uv remove <package>` to add or remove dependencies.
81-
82- - Use the optional flag `--dev` to add/remove development dependencies.
83- - Include the optional flag `--group <group-name>` to add/remove dependencies from specific groups.
84- - These will automatically update the `pyproject.toml` file.
85-
86- For further information, see the [uv] docs for managing dependencies.
37+ There are some example notebooks in the [` notebooks` ] folder to get you started.
8738
39+ [MUSE2]: https://github.com/EnergySystemsModellingLab/MUSE2
8840[uv]: https://docs.astral.sh/uv
89- [pre-commit]: https://pre-commit.com/
90- [pytest]: https://pytest.org/
91- [GitHub Actions]: https://github.com/features/actions
92- [pre-commit.ci]: https://pre-commit.ci
93- [setuptools-scm]: https://setuptools-scm.readthedocs.io/en/latest/
94- [Imperial College Research Software Engineering Team]: https://www.imperial.ac.uk/admin-services/ict/self-service/research-support/rcs/service-offering/research-software-engineering/
9541[Download and install uv]: https://docs.astral.sh/uv/getting-started/installation/
9642[uv activate]: https://docs.astral.sh/uv/pip/environments/
43+ [` notebooks` ] ./notebooks
44+
45+ # # Copyright
46+
47+ Copyright © 2026 Imperial College London
0 commit comments