Skip to content

nmfs-ost/ss3-source-code

Repository files navigation

Stock Synthesis 3.30

GitHub release (latest by date) GitHub Release Date GitHub last commit GitHub release (latest by date) GitHub release (latest by date) GitHub Release Date GitHub last commit GitHub release (latest by date)

Stock Synthesis (SS3) is a generalized age-structured population dynamics model implemented in ADMB. It is used to assess the effect of fisheries on fish and shellfish stocks while taking into account the influence of environmental factors.

Table of contents

Citing Stock Synthesis

Please cite Stock Synthesis as:

Methot, R.D. and Wetzel, C.R. (2013). Stock Synthesis: A biological and statistical
framework for fish stock assessment and fishery management. Fisheries Research, 
142: 86-99. https://doi.org/10.1016/j.fishres.2012.10.012

Installation

Download the latest compiled versions from Github Releases. For information on specific changes with each release, please refer to the change log on GitHub for changes from v.3.30.19 onward and the Excel spreadsheet version of the change log for changes prior to v.3.30.19.

How can I learn how to use Stock Synthesis?

To learn more about how to use Stock Synthesis, see the getting started guide with Stock Synthesis guide. To learn how to build your own models in Stock Synthesis, see the Develop an Stock Synthesis model guide.

The Stock Synthesis user manual provides the complete documentation of Stock Synthesis.

How do I ask questions about Stock Synthesis?

Please look for answers or submit questions to the Stock Synthesis forums. Note that an account is required to ask questions on the forums. Questions can also be asked by opening an issue in this repository or by emailing nmfs.stock.synthesis@noaa.gov.

How can I contribute to Stock Synthesis?

Have feature requests or bug reports? Want to contribute code? Please open an issue or submit a pull request. For complete details, please see CONTRIBUTING.md

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.

Tools for working with Stock Synthesis

As Stock Synthesis usage has grown, so has the number of tools to work with it. These include repositories on github with the stock-synthesis topic as well as:

  • r4ss: Create plots of Stock Synthesis output and functions to work with Stock Synthesis in R.
  • ss3diags: Run advanced diagnostics for Stock Synthesis models.
  • ss3sim: Conduct simulation studies using Stock Synthesis.
  • SSI: Stock Synthesis Interface, a GUI for developing models and running Stock Synthesis. Links to r4ss.
  • SS3 Shiny helper app: Visualize common selectivity pattern options available within Stock Synthesis.
  • SSMSE: Use Stock Synthesis operating models in Management Strategy Evaluation.
  • sa4ss: Create accessible R markdown stock assessment documents with results from Stock Synthesis models. Note this tool is intended for use by analysts within the Northwest and Southwest Fisheries Science Centers currently.
  • Data limited tools - Options included Simple Stock Synthesis (SSS) and Extended Simple Stock Synthesis (XSSS), as well as SS-DL-tool, a shiny app that includes XSSS and SSS in its functionality.

Have a tool to work with Stock Synthesis that should be mentioned here? Open an issue or pull request to let us know!

Disclaimer

This repository is a scientific product and is not official communication of the National Oceanic and Atmospheric Administration, or the United States Department of Commerce. All NOAA GitHub project code is provided on an ‘as is’ basis and the user assumes responsibility for its use. Any claims against the Department of Commerce or Department of Commerce bureaus stemming from the use of this 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.