Skip to content

Latest commit

 

History

History
30 lines (19 loc) · 3.38 KB

CONTRIBUTING.md

File metadata and controls

30 lines (19 loc) · 3.38 KB

Contributing to Stock Synthesis

General Information

Thank you for your interest in contributing to Stock Synthesis! 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 [email protected].

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 [email protected]. 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.

How can I contribute?

We welcome all contributions! For example, report bugs or request features through an issue, suggest code changes through a pull request, or suggest changes to the Stock Synthesis manual.

How to submit a pull request to Stock Synthesis

  1. Fork the stock synthesis repository (or, if you are a member of the nmfs-stock-synthesis organization, clone the repository).
  2. Create a new branch, make the changes, and test out by building stock synthesis locally.
  3. Commit the changes and push up to the github fork.
  4. Submit a pull request to the main branch of Stock Synthesis Repository.

How to build Stock Synthesis from source

  1. Have a local version of the stock synthesis repository (though forking or cloning).
  2. Download ADMB. The current version of ADMB used to compile Stock Synthesis is listed in SS_versioninfo_330safe.tpl.
  3. Add ADMB to the PATH or use the ADMB command window for the following commands.
  4. On Linux or Mac: Change directory to the cloned Stock Synthesis repository and use the script Make_SS_330_new.sh by calling './Make_SS_330_new.sh'. To see all options for the function, use 'help ./Make_SS_330_new.sh'.
  5. On Windows: Change directory to the cloned Stock Synthesis repository's Compile subfolder. and call the Make_SS_safe batch script to build the "safe" version of Stock Synthesis. (to build the optimized and translation (3.24 to 3.30) versions of Stock Synthesis, call the Make_SS_opt or Make_SS_trans batch scripts instead). Upon calling the batch script, SS will be built in the Compile subfolder.

Still have a question on the contributing workflow?

Please email [email protected] for assistance.