PhenoCamSnow

PhenoCamSnow is a Python package for quickly building deep learning models to classify PhenoCam images.

Installation

PhenoCamSnow supports Python 3.7+ and can be installed via pip:

pip install phenocam-snow

Optional dependencies for development and documentation purposes can be installed by specifying the extras [dev] and [docs], repsectively.

Example Usage

The following code snippets show how to train and evaluate a model on classifying images from the canadaojp site into "snow", "no snow", and "too dark".

python -m phenocam_snow.train \
   canadaojp \
   --model resnet18 \
   --learning_rate 5e-4 \
   --weight_decay 0.01 \
   --new \
   --n_train 120 \
   --n_test 30 \
   --classes snow no_snow too_dark

This will print out the file path of the best model, which can be substituted into the next command.

python -m phenocam_snow.predict \
   canadaojp \
   [path/to/best_model.ckpt] \
   resnet18 \
   --categories snow no_snow too_dark
   --url https://phenocam.nau.edu/data/latest/canadaojp.jpg

Advanced usage details can be found in the documentation.

Citation

If you use PhenoCamSnow for your work, please see CITATION.cff or use the citation prompt provided by GitHub in the sidebar.

Acknowledgements

Professor Jochen Stutz and Zoe Pierrat.

Metadata

Release files for phenocam-snow 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for phenocam-snow 0.1.1
File	Size	Uploaded
phenocam-snow-0.1.1.tar.gz	14.2 kB	Jun 14, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for phenocam-snow 0.1.1
File	Interpreter	ABI	Platform	Reset
phenocam_snow-0.1.1-py3-none-any.whl 15.9 kB Jun 14, 2023	Python 3	none	any	Details

Total release size: 30.1 kB

Release files / phenocam-snow-0.1.1.tar.gz

Download URL	phenocam-snow-0.1.1.tar.gz
Size	14.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`e081e81dd1c95aebda7563e3b589a178f2ec6bed51613390571dd97be9155f8a`
BLAKE2b-256 checksum How to use checksums	`546b7f48a6cbde36b7fdad6e7004c7be379518a1cab2c73ee356a6c64a0d2892`
Upload date	Jun 14, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.7.16`

Release files / phenocam_snow-0.1.1-py3-none-any.whl

Download URL	phenocam_snow-0.1.1-py3-none-any.whl
Size	15.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`107eeba68df4a6a92831f5594dd4f3ad9da13c8e423058405bf85858527e31bb`
BLAKE2b-256 checksum How to use checksums	`b34c09b308cfce5f4195cd9863faa1b42e9ad291580644ff9de0b269d79e3781`
Upload date	Jun 14, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.7.16`