-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Make more consistent with the `pm_tb_data` repo. We should probably think about re-ogranizing some of these docs into individual files. The README should really just cover front-matter that people need at a glace. A `doc/` directory with individual sections for e.g., development/contributing, testing, etc. (ideally served by e.g., RTD) would be ideal.
- Loading branch information
1 parent
9734b1d
commit c28c110
Showing
3 changed files
with
77 additions
and
36 deletions.
There are no files selected for viewing
File renamed without changes.
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,11 +1,12 @@ | ||
<p align="center"> | ||
<img alt="NSIDC logo" src="https://nsidc.org/themes/custom/nsidc/logo.svg" width="150" /> | ||
<p float="left" align="center"> | ||
<img alt="NSIDC logo" src="https://nsidc.org/themes/custom/nsidc/logo.svg" height="150" /> | ||
<img alt="NOAA@NSIDC logo" src="https://nsidc.org/sites/default/files/images/Logo/noaa_at_nsidc.png" height="150" /> | ||
<img alt="NASA logo" src="https://gpm.nasa.gov/sites/default/files/document_files/NASA-Logo-Large.png" height="150" /> | ||
</p> | ||
|
||
# Enhanced Sea Ice CDR | ||
|
||
# Enhanced SeaIce CDR | ||
|
||
Enhanced SeaIce CDR enables the creation of the 12.5km SeaIce CDR | ||
Enhanced SeaIce CDR (ECDR) enables the creation of the 12.5km SeaIce CDR. | ||
|
||
|
||
## Level of Support | ||
|
@@ -17,34 +18,95 @@ See the [LICENSE](GENERAL) for details on permissions and warranties. Please con | |
[email protected] for more information. | ||
|
||
|
||
## Requirements | ||
## Requirements and installation | ||
|
||
The ]seaice_ecdr_vm repository](https://bitbucket.org/nsidc/seaice_ecdr_vm/src/main/) provides the NSIDC VM configuration for this project. | ||
This code relies on the python packages defined in the included | ||
`environment.yml` file. | ||
|
||
Use [conda](https://docs.conda.io/en/latest/) or | ||
[mamba](https://mamba.readthedocs.io/en/latest/index.html) to install the | ||
requirements: | ||
|
||
## Installation | ||
``` | ||
$ conda env create | ||
``` | ||
|
||
Clone the seaice_ecdr_vm repository and check out appropriate branches of pm_icecon and seaice_ecdr to install this package | ||
To activate the environment: | ||
|
||
``` | ||
$ conda activate pm_tb_data | ||
``` | ||
|
||
## Usage | ||
|
||
TODO | ||
|
||
## Development/contributing | ||
|
||
### For developers at NSIDC | ||
|
||
For developers at the NSIDC, the [seaice_ecdr_vm | ||
repository](https://bitbucket.org/nsidc/seaice_ecdr_vm/src/main/) provides the | ||
NSIDC VM configuration for this project. | ||
|
||
An initial copy of the pm_icecon "cdr" generation can be executed from the VM directory: | ||
|
||
~/seaice_ecdr/ | ||
`~/seaice_ecdr/` | ||
|
||
using the cli.sh command: | ||
|
||
``` | ||
./scripts/cli.sh bootstrap amsr2 --date 2022-08-01 --hemisphere north --output-dir /tmp/ --resolution 12 | ||
``` | ||
|
||
### Adding dependencies | ||
|
||
To add new dependencies to this project, update the `environment.yml` file with | ||
the new dependency. Then update your conda environment: | ||
|
||
``` | ||
$ mamba env update | ||
``` | ||
|
||
Once the conda environment has been updated, lock the environment using `conda-lock`: | ||
|
||
``` | ||
$ conda-lock | ||
``` | ||
|
||
Commit the changes for the `environment.yml` and the `conda-lock.yml` files. | ||
|
||
|
||
### Running tests/CI | ||
|
||
#### Linting / formatting | ||
This project uses [pre-commit](https://pre-commit.com/) to run pre-commit hooks | ||
that check and format this project's code for stylistic consistency (using | ||
`ruff` and `black`) . | ||
|
||
The pre-commit configuration for this project can be found in | ||
`.pre-commit-config.yaml`. Configuration for specific tools (e.g., `mypy`) is | ||
given in the included `pyproject.toml`. | ||
|
||
For more information about using `pre-commit`, please sese the [Scientific | ||
Python Library Development Guide's section on | ||
pre-commit](https://learn.scientific-python.org/development/guides/gha-basic/#pre-commit). | ||
|
||
To install pre-commit to run checks for each commit you make: | ||
|
||
``` | ||
$ pre-commit install | ||
``` | ||
|
||
## Troubleshooting | ||
To manually run the pre-commit hooks without a commit: | ||
|
||
No specific troubleshooting suggestions are currently available. | ||
``` | ||
$ pre-commit run --all-files | ||
``` | ||
|
||
## License | ||
|
||
See [LICENSE](GENERAL). | ||
See [LICENSE](LICENSE). | ||
|
||
|
||
## Code of Conduct | ||
|
@@ -54,5 +116,5 @@ See [Code of Conduct](CODE_OF_CONDUCT.md). | |
|
||
## Credit | ||
|
||
This content was developed by the National Snow and Ice Data Center with funding from | ||
multiple sources. | ||
This software was developed by the National Snow and Ice Data Center with | ||
funding from NASA and NOAA. |