Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
voetberg authored Jul 2, 2024
1 parent 00f2730 commit 1b701ae
Showing 1 changed file with 34 additions and 0 deletions.
34 changes: 34 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ pytest

## Quickstart

[View the template yaml here for a minimially working example with our supplied sample data to get started.](https://github.com/deepskies/DeepDiagnostics/blob/main/config.yml.template)

### Pipeline
`DeepDiagnostics` includes a CLI tool for analysis.
* To run the tool using a configuration file:
Expand Down Expand Up @@ -170,6 +172,8 @@ class NewPlot(Display):

#### Adding to the package
If you wish to add the addition to the package to run using the CLI package, a few things need to be done.
For this example, we will add a new metric, but an identicial workflow takes place for plots, just modifying the `plots` submodule instead of `metrics`.


1. Add the name and mapping to the submodule `__init__.py`.

Expand Down Expand Up @@ -228,6 +232,36 @@ python3 -m pytest tests/test_metrics.py::test_newmetric

```

4. Add documentation

##### `docs/source/metrics.rst`

``` rst
from deepdaigonstics.metrics import NewMetric
.. _metrics:
Metrics
=========
.. autoclass:: deepdiagnostics.metrics.metric.Metric
:members:
...
.. autoclass:: deepdiagonstics.metrics.newmetric.NewMetric
:members: calculate
.. bibliography::
```

### Building documentation:
* Documentation automatically updates after any push to the `main` branch according to [`readthedocs.yml`](https://github.com/deepskies/DeepDiagnostics/blob/main/.readthedocs.yml). Verify the documentation built by checking the readthedocs badge.

### Publishing a release:
* Releases to pypi are built automatically off the main branch whenever a github release is made.
* Update the version number to match with the release you are going to make before publishing in the `pyproject.toml`
* Create a new github release and monitor the [`publish.yml` action](https://github.com/deepskies/DeepDiagnostics/actions/workflows/publish.yml) to verify the new release is built properly.

## Citation
```
@article{key ,
Expand Down

0 comments on commit 1b701ae

Please sign in to comment.