Skip to content

Commit

Permalink
Update README/LICENSE
Browse files Browse the repository at this point in the history
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
trey-stafford committed Oct 4, 2023
1 parent 9734b1d commit c28c110
Show file tree
Hide file tree
Showing 3 changed files with 77 additions and 36 deletions.
File renamed without changes.
21 changes: 0 additions & 21 deletions LICENSE_NASA

This file was deleted.

92 changes: 77 additions & 15 deletions README.md
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
Expand All @@ -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
Expand All @@ -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.

0 comments on commit c28c110

Please sign in to comment.