{"id":28332418,"url":"https://github.com/ss3sim/ss3models","last_synced_at":"2026-01-27T06:01:26.837Z","repository":{"id":22414879,"uuid":"25752414","full_name":"ss3sim/ss3models","owner":"ss3sim","description":"SS3 model setups for use with ss3sim","archived":false,"fork":false,"pushed_at":"2021-09-08T18:50:15.000Z","size":79494,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-06-19T07:44:22.331Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ss3sim.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-26T00:55:48.000Z","updated_at":"2021-09-08T18:44:55.000Z","dependencies_parsed_at":"2022-08-20T13:01:01.452Z","dependency_job_id":null,"html_url":"https://github.com/ss3sim/ss3models","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ss3sim/ss3models","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ss3sim%2Fss3models","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ss3sim%2Fss3models/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ss3sim%2Fss3models/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ss3sim%2Fss3models/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ss3sim","download_url":"https://codeload.github.com/ss3sim/ss3models/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ss3sim%2Fss3models/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28805327,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T05:43:52.625Z","status":"ssl_error","status_checked_at":"2026-01-27T05:43:48.957Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-26T19:50:11.625Z","updated_at":"2026-01-27T06:01:26.831Z","avatar_url":"https://github.com/ss3sim.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput:\n  md_document:\n    variant: markdown_github\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file and run\n     `rmarkdown::render()` on this file. --\u003e\n\n```{r, echo = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  cache = TRUE,\n  autodep = TRUE\n)\noptions(\"width\" = 90)\nlibrary(\"magrittr\")\n```\n\n# ss3sim models\n\n[![Travis-CI Build Status](https://travis-ci.org/ss3sim/ss3models.png?branch=master)](https://travis-ci.org/ss3sim/ss3models)\n\nThis R package contains operating model (OM) and estimating model (EM) files and case files for use within the [ss3sim][ss3sim] package. [ss3sim][ss3sim] is an R package that facilitates flexible, rapid, and reproducible fisheries stock assessment simulation testing with the widely-used [Stock Synthesis 3][SS3] (SS3) statistical age-structured stock assessment framework.\n\n```{r, echo = FALSE, message = FALSE}\ndevtools::load_all()\n```\n\nInstall the ss3models package with:\n\n```{r, eval = FALSE}\n# install.packages(\"devtools\")\ndevtools::install_github(\"ss3sim/ss3models\")\nlibrary(\"ss3models\")\n```\n\nThe model setups are stored in the package in the [`inst/models`](inst/models) folder. The local file path to the operating models (`om` folders) and estimating models (`em` folders) can be accessed using the `ss3model` function:\n\n```{r, eval = FALSE}\nss3model(\"hake\", \"em\")\n#\u003e \"/Library/Frameworks/R.framework/Versions/3.1/Resources/library/ss3models/models/hake/em\"\nss3model(\"flatfish\", \"om\")\n#\u003e \"/Library/Frameworks/R.framework/Versions/3.1/Resources/library/ss3models/models/flatfish/om\"\n```\n\nYou can get a list of all available models in R with:\n\n```{r}\nlist_models()\n```\n\nThe SS3 model setup files in the operating model folders are:\n\n```{r}\nss3model(\"hake\", \"om\") %\u003e%\n  dir\n```\n\nSS3 files in the estimating model folders are:\n\n```{r}\nss3model(\"hake\", \"em\") %\u003e%\n  dir\n```\n\nThe ss3models package also contains a couple helper functions for working with and checking model setups. For example:\n\n```{r}\nsystem.file(\"models\", package = \"ss3models\") %\u003e%\n  get_parvalues(write_csv = FALSE) %\u003e%\n  head\n```\n\nYou can test all the operating model setups (run them through SS3 with `-noest`) and run all the \\code{.dat} files through `ss3sim::check_data()` by running `devtools::test()` in the base `ss3models` folder.\n\nIf you also want to test the estimation model setups (run them through SS3 with `-nohess`) then uncomment the relevant code in [`tests/testthat/test-models.R`](tests/testthat/test-models.R). For now the code is commented out while we develop the models. They take a while to run. \n\n## Included models\n\n### Base models (length-based selectivity)\n\n1. `cod`: length-based double normal selectivity (mimicking logistic) in OM, length-based double normal selectivity (mimicking logistic) in EM, narrow bounds\n\n2. `flatfish`: length-based double normal selectivity (mimicking logistic) in OM, length-based double normal selectivity (mimicking logistic) in EM, narrow bounds\n\n3. `yellow`: (yellowtail flounder) length-based double normal selectivity (mimicking logistic) in OM, length-based double normal selectivity (mimicking logistic) in EM, length-based maturity\n\n4. `hake`: length-based double normal selectivity (mimicking logistic) in OM, length-based double normal selectivity (mimicking logistic) in EM, length-based maturity (slightly changed compared t o the original assessment to match the purpose of this simulation study)\n\n### Base models (age-based selectivity)\n\n1. `cod-age`: TODO\n\n2. `flatfish`: TODO\n\n3. `yellow-age`: (yellowtail flounder) age-based double normal selectivity (mimicking logistic) in OM, age-based double normal selectivity (mimicking logistic) in EM, age-based maturity\n\n4. `hake-age`: age-based double normal selectivity (mimicking logistic) in OM, age-based double normal selectivity (mimicking logistic) in EM, age-based maturity (converted from the 'hake' model)\n\n### Model summaries\n\nSpecific information for each model can be found in the [information document][info.csv]. Columns with todo in the name should be filled out with your initials once completed. All other columns pertain to information specific the parameterization of each model.\n\nEventually more summary data and descriptive plots will be available on the `README.md` files within each species folder.\n\n### Paramerization\n\n- Selectivity: parameterized using a double normal to mimic logistic selectivity\n  * age-based\n  * length-based\n\n- Maturity:\n  * age-based logistic maturity\n  * length-based logistic maturity\n\n### TODO\n\n- [ ] lbin type = 2\n- [ ] population bin width must be divisible by the data bin width\n- [ ] years = 1:100\n- [ ] Standardize parameter bounds using [standardize_bounds](https://github.com/ss3sim/ss3sim/blob/master/R/standardize_bounds.R): approach used in [Johnson *et al*. (2015)][johnsonetal] of lower bounds = 0.5% of init values and upper bounds = [ ] 500% of init values\n- [ ] Fishing case files: \"F\" case files for each model are based on Fmsy, which can be found with [profile_fmsy](https://github.com/ss3sim/ss3sim/blob/master/R/profile_fmsy.r). Casefiles are automatically generated from the script [create_f.R][fscript]. Please rerun this script any time a new model is added.\n  * F0 = Constant fishing at Fmsy (constant): years 25 - 100 at Fmsy;\n  * F1 = Two way trip (contrast): years 25 - 65 ramp up to 0.9 x Fmsy (right limb), years 66 - 100 ramp down from 0.9 x Fmsy (right limb) to 0.9 x Fmsy (left limb;\n  * F2 = One way trip (increase): years 25 - 100 ramp up to 0.9 x Fmsy (left limb).\n\n[vignette]: https://dl.dropboxusercontent.com/u/254940/ss3sim-vignette.pdf\n[paper]: http://www.plosone.org/article/info%3Adoi%2F10.1371%2Fjournal.pone.0092725\n[SS3]: http://nft.nefsc.noaa.gov/Stock_Synthesis_3.htm\n[r-project]: http://www.r-project.org/\n[SAFS]: http://fish.washington.edu/\n[ss3sim]: https://github.com/ss3sim/ss3sim\n[johnsonetal]: http://icesjms.oxfordjournals.org/content/early/2014/04/09/icesjms.fsu055.full.pdf?keytype=ref\u0026ijkey=NEXmZIkz3289u3z)\n[info.csv]: https://github.com/ss3sim/growth_models/blob/master/extra/modelinfo.csv\n[fscript]: https://github.com/ss3sim/growth_models/blob/master/create_f.R\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fss3sim%2Fss3models","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fss3sim%2Fss3models","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fss3sim%2Fss3models/lists"}