Skip to content

Commit 4d7732e

Browse files
committed
Update README.md
1 parent 1e8e3c0 commit 4d7732e

1 file changed

Lines changed: 12 additions & 61 deletions

File tree

README.md

Lines changed: 12 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,18 @@
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

1713
To get started:
1814

1915
1. [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

2717
1. 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

Comments
 (0)