Skip to content

Add documentation for building, running and testing benchcab #240

@abhaasgoyal

Description

@abhaasgoyal

Building

Dependencies

  • conda env

Dev-Dependencies

  • black, ruff
module load conda
conda env create --name benchcab-dev --file .conda/benchcab-dev.yaml
conda activate benchcab-dev
pip install --user -e .
  • mkdocs
pip install -r mkdocs-requirements.txt

If using on Gadi, use ssh port forwarding

ssh -L 8000:localhost:8000 <username>@gadi.nci.org.au
mkdocs serve

Running

Follow the user guide

Testing

  • pytest, mypy
  • Integration tests
/bin/bash benchcab/data/test/integration.sh

Comparing Models

  • netcdf, cdo

Tips

Add a docstring using numpy style. (autodocstring extension in VS Code can pre-populate for you, make sure to select numpy style on settings first).

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationpriority:highHigh priority issues that should be included in the next release.

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions