Skip to content

Commit

Permalink
Merge pull request #35 from nsidc/cleanup-external-data-deps
Browse files Browse the repository at this point in the history
Cleanup external data deps
  • Loading branch information
trey-stafford authored Dec 21, 2023
2 parents ed0ae94 + 76432f4 commit a8b66e3
Show file tree
Hide file tree
Showing 28 changed files with 744 additions and 1,384 deletions.
9 changes: 8 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,15 @@
# NEXT_RELEASE
# v0.3.0

* Extract CDR-specific logic from this repository. Moved to the `seaice_ecdr`
(https://github.com/nsidc/seaice_ecdr/)
* Remove `Hemisphere` type. Import from `pm_tb_data` instead.
* Remove CLI for this library. It is now the responsiblity of programs utlizing
this library to define how inputs/outputs are handled. This library purely
focuses on the implementation of the sea ice concentration algorithms.
* Related to the above, remove code related to reading/handling ancillary files
that define e.g., valid ice masks. This code was very specific to NSIDC's
internal infrastructure and unpublished data. It is now the responsibility of
other programs utlizing this library to provide masks, input TBs, etc.

# v0.2.0

Expand Down
46 changes: 2 additions & 44 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,49 +46,7 @@ $ conda activate pm_icecon

## Usage

### CLI

There is a command line interface defined using common defaults for testing
purposes at NSIDC.

NOTE: the CLI relies on hard-coded paths to mask files on NSIDC's virtual
machine infrastructure. This CLI will not currently work for those outside of
NSIDC. We plan to change this in the future.

The CLI can be interacted with via `scripts/cli.sh`:

```
$ ./scripts/cli.sh --help
Usage: python -m pm_icecon.cli.entrypoint [OPTIONS] COMMAND [ARGS]...
Run the nasateam or bootstrap algorithm.
Options:
--help Show this message and exit.
Commands:
bootstrap Run the bootstrap algorithm.
nasateam Run the nasateam algorithm.
```

E.g., to create a NetCDF file with a `conc` variable containing concentration
values from AU_SI12 from the bootstrap algorithm:

```
$ ./scripts/cli.sh bootstrap amsr2 --date 2022-08-01 --hemisphere north --output-dir /tmp/ --resolution 12
2022-09-12 15:21:44.482 | INFO | pm_icecon.bt.cli:amsr2:82 - Wrote AMSR2 concentration field: /tmp/bt_NH_20220801_u2_12km.nc
```

E.g., to create a NetCDF file with a `conc` variable containing concentration
values from AU_SI25 from the nasateam algorithm:

```
$ ./scripts/cli.sh nasateam amsr2 --date 2022-08-01 --hemisphere south --output-dir /tmp/ --resolution 25
2022-09-12 15:23:34.993 | INFO | pm_icecon.nt.cli:amsr2:82 - Wrote AMSR2 concentration field: /tmp/nt_SH_20220801_u2_25km.nc
```

### Scripting
#### Bootstrap
### Bootstrap


Users can write a script using the functions provided in this repo to run the
Expand All @@ -104,7 +62,7 @@ hard-coded defaults for testing purposes at NSIDC. This includes paths to data
on NSIDC infrastructure that are not available to the public.


#### Nasateam
### Nasateam

The main entrypoint to running the nasateam code on input Tbs is the `nasateam`
function defined in `pm_icecon/nt/compute_nt_ic.py`.
Expand Down
Loading

0 comments on commit a8b66e3

Please sign in to comment.