This repository contains examples of stock synthesis models for users. The model metadata more fully describes key features of the examples.
- How to download
- Do these models always use Stock Synthesis best practices?
- How can I submit my model to be a user example?
- How do I request a certain type of example?
- Metadata for example models
- Selectivity examples
- Contributing guide
- Disclaimer
- Use https://download-directory.github.io/ to download just the model_files subfolder.
- Clone the repository
- Download the repository. To get a .zip file of the repository, click on the "code" button on the main page, then the "Download ZIP" button.
Not always, as Stock Synthesis best practices are constantly evolving. However, all of these models are valid stock synthesis setups. In the future, these example models may be updated to follow best practices (feel free to suggest changes by submitting an issue or pull request).
To learn more about general stock assessment (i.e., not specific to Stock Synthesis) best practices, visit the Center for the Advancement of Population Assessment Methodology (CAPAM) website.
Model contributions are welcome! Please open a pull request after reading the contribution guide and code of conduct.
First, please take a look at the current examples available and their notable features. If there isn't one available that meets your needs, please request the type of example model that would be helpful by opening an issue or sending an email to nmfs.stock.synthesis@noaa.gov.
| Model name | Notable features |
|---|---|
| simple | Long-standing example model. Includes most data types |
| simple_with_discard | "simple" with discard data added |
| simple_long | Simple with a longer time series and best practices |
| simple_long_wtatage | simple_long but uses empirical weight-at-age |
| empirical_wtatage_and_age_selex | Uses empirical weight-at-age, based on "simple" |
| selex_age_example | Illustrates setup for 6 age-based selectivity types. More detail below. |
| selex_length_example | Illustrates setup for 6 length-based selectivity types. More detail below. |
The models selex_length_example and selex_age_example can be used to see the control file setup for 5 length-based and 6 age-based selectivity types as shown in the figure below.
These examples were created for a tutorial at the 2013 CAPAM workshop on selectivity. In these models, each fleet is provided the same simulated data so the large differences in estimated uncertainty associated with each type (as shown in the plot below) are an illustration of the flexibility of each type. Note: this figure depends on iteratively changing the fleet associated with the reported selectivity uncertainty specified at the bottom of the control file.
Thank you for your interest in contributing example models! Before contributing, please read the code of conduct.
We strive to follow the NMFS Fisheries Toolbox Contribution Guide. Note that these are guidelines, not rules, and we are open to collaborations in other ways that may work better for you. Please feel free to reach out to us by opening an issue in this repository or by emailing the developers at nmfs.stock.synthesis@noaa.gov.
- Fork the stock synthesis repository (or, if you are a member of the ss3-team, clone the repository).
- Create a new branch and make the changes (likely adding new model files).
- Commit the changes and push up to the github fork.
- Submit a pull request to the main branch of the ss3-user-examples repository.
This project and everyone participating in it is governed by the NMFS Fisheries Toolbox Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to fisheries.toolbox@noaa.gov. Note that the maintainers of SS do not have access to this email account, so unacceptable behavior of the maintainers can also be reported here.
The NFMS Fisheries Toolbox Code of Conduct is adapted from the Contributor Covenant, version 1.4, available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
For answers to common questions about this code of conduct, see https://www.contributor-covenant.org/faq
“The United States Department of Commerce (DOC) GitHub project code is provided on an ‘as is’ basis and the user assumes responsibility for its use. DOC has relinquished control of the information and no longer has responsibility to protect the integrity, confidentiality, or availability of the information. Any claims against the Department of Commerce stemming from the use of its GitHub project will be governed by all applicable Federal law. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by the Department of Commerce. The Department of Commerce seal and logo, or the seal and logo of a DOC bureau, shall not be used in any manner to imply endorsement of any commercial product or activity by DOC or the United States Government.”