Skip to content

Commit 47a9e81

Browse files
Merge pull request #4 from MattGrossi-NOAA/dev
Update README with branch descriptions
2 parents e9f6004 + d3ba454 commit 47a9e81

1 file changed

Lines changed: 8 additions & 2 deletions

File tree

README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# Menhaden Ageing Model
22

3-
This Menhaden Ageing Model provides an innovative method for automatically estimating Menhaden age using scale images and fish length, weight, and month of catch (hereafter, “metadata”.) Built upon state-of-the-art deep learning algorithms, the model enables rapid generation of fish age predictions by simply pointing to a directory containing configuration file that instructs the model where to find the data and metadata, how to preprocess the images, and where to write the output. See the [official documentation pages](https://sefsc.github.io/FATES-BLH-ScaleAgeing/) for more thorough instructions.
3+
This Menhaden Ageing Model provides an innovative method for automatically estimating Menhaden fish age using scale images and fish length, weight, and month of catch (hereafter, “metadata.”) Built upon state-of-the-art deep learning algorithms, the model enables rapid generation of fish age predictions by simply pointing to a directory containing configuration file that instructs the model where to find the data and metadata, how to preprocess the images, and where to write the output. See the [official documentation pages](https://sefsc.github.io/FATES-BLH-ScaleAgeing/) for more thorough instructions.
4+
5+
This repo consists of four primary branches, each serving a distinct purpose to facilitate development, documentation, and model deployment:
6+
- `main`: The main branch containing the most stable version of the code and a series of Jupyter notebooks demonstrating the workflow.
7+
- `dev`: A development branch where new features and updates are tested before being merged into the main branch. Any modification to and testing of the model or accompanying notebooks should be done here (or a new development branch created from `main`, if desired) and merged into `main` once changes are verified to be stable.
8+
- `docs`: A branch dedicated to hosting the documentation for the project. This should be updated as needed whenever changes to the model are made in `main` to ensure the model documentation remains up-to-date.
9+
- `gh-pages`: A branch used for GitHub Pages to serve the project's documentation website, which happens automatically using GitHub Actions whenever changes are pushed to the `docs` branch. There is no need to modify or even clone this branch.
410

511
## Prerequisites
612

@@ -34,4 +40,4 @@ This repository is a scientific product and is not official communication of the
3440

3541
### License
3642

37-
This content was created by U.S. Government employees as part of their official duties. This content is not subject to copyright in the United States (17 U.S.C. §105) and is in the public domain within the United States of America. Additionally, copyright is waived worldwide through the CC0 1.0 Universal public domain dedication.
43+
This content was created by U.S. Government employees as part of their official duties. This content is not subject to copyright in the United States (17 U.S.C. §105) and is in the public domain within the United States of America. Additionally, copyright is waived worldwide through the CC0 1.0 Universal public domain dedication.

0 commit comments

Comments
 (0)