{"id":27198701,"url":"https://github.com/nmfs-ost/asar","last_synced_at":"2026-01-20T18:47:00.461Z","repository":{"id":226452575,"uuid":"760565656","full_name":"nmfs-ost/asar","owner":"nmfs-ost","description":"Partially automate a U.S. stock assessment report.","archived":false,"fork":false,"pushed_at":"2026-01-14T20:46:40.000Z","size":61229,"stargazers_count":32,"open_issues_count":15,"forks_count":10,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-01-15T00:53:21.516Z","etag":null,"topics":["latex","noaa-nsap","quarto","r-package","stock-assessment","stock-assessment-reports"],"latest_commit_sha":null,"homepage":"https://nmfs-ost.github.io/asar/","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nmfs-ost.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-20T15:58:15.000Z","updated_at":"2026-01-05T16:11:28.000Z","dependencies_parsed_at":"2024-05-13T21:27:43.724Z","dependency_job_id":"824e1945-2dbd-42f8-8bc6-2194d80d4c63","html_url":"https://github.com/nmfs-ost/asar","commit_stats":null,"previous_names":["schiano-noaa/asar","nmfs-ost/asar"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/nmfs-ost/asar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2Fasar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2Fasar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2Fasar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2Fasar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nmfs-ost","download_url":"https://codeload.github.com/nmfs-ost/asar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2Fasar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28609195,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"last_error":"SSL_read: 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":["latex","noaa-nsap","quarto","r-package","stock-assessment","stock-assessment-reports"],"created_at":"2025-04-09T20:54:53.925Z","updated_at":"2026-01-20T18:47:00.445Z","avatar_url":"https://github.com/nmfs-ost.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# asar (Automated Stock Assessment Reporting) \u003cimg src=\"man/figures/asar-hex.png\" align=\"right\" height=\"200\" style=\"float:right; height:200px;\" /\u003e\n\n\u003c!-- badges: start --\u003e\n[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental) [![R-CMD-check](https://github.com/nmfs-ost/asar/actions/workflows/call-r-cmd-check.yml/badge.svg)](https://github.com/nmfs-ost/asar/actions/workflows/call-r-cmd-check.yml) [![coverage](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/nmfs-ost/asar/refs/heads/badges/coverage-badge.json)](https://github.com/nmfs-ost/asar/tree/badges)\n\u003c!-- badges: end --\u003e\n\nDownload using the directions below and fill in `create_template.R` function with \nthe desired parameters (follow example below) to create a template Quarto document \nto be rendered to create a stock assessment report.\n\nThe goal of ASAR is to automate stock assessment reports for NOAA science centers\nso they are reproducible and cohesive across the agency. This project intends \nto create a streamlined workflow that allows the analyst to create a customized \nreport tailored to their needs and requirements by the SSC, council, or other \nregional management organizations. \n\nFor users interested in testing, please see [Testing](#-testing-section) section below. \nIn its current form, this package builds a  template to create a stock assessment report \nincluding NOAA Fisheries formatting and included tables and figures.\n\n## Installation\n\nFirst please check to make sure `tinytex` package is installed on your machine. If not, please install using the following lines:\n\n```r\ninstall.packages(\"pak\")\npak::pkg_install(\"rstudio/tinytex\")\n```\n\nThen install the package using one of the three following ways:\n\n(1) Using `pak`\n\n```r\ninstall.packages(\"pak\")\npak::pak(\"nmfs-ost/asar\")\n```\n\n(2) Using `remotes`\n\n```r\ninstall.packages(\"remotes\")\nremotes::install_github(\"nmfs-ost/asar\")\n```\n\n(3) From the noaa-fisheries-integrated-toolbox r-universe:\n\n```r\ninstall.packages('asar', repos = c('https://noaa-fisheries-integrated-toolbox.r-universe.dev', 'https://cloud.r-project.org'))\n```\n\nWe also recommend to download the [`stockplotr` package](https://github.com/nmfs-ost/stockplotr). Use one of the previous download instructions to also install `stockplotr` by replacing 'asar' with 'stockplotr'.\n\n## Example\n\nThe following code will allow the user to replicate the [2023 petrale sole stock assessment](https://www.pcouncil.org/documents/2024/02/status-of-petrale-sole-eopsetta-jordanialong-the-u-s-west-coast-in-2023.pdf/) \nproduced by the NWFSC and made available by the Pacific Fisheries Management Council. \nThe assessment model files are also available on the PFMC's website. A tutorial \nfor using `asar` can be found [here](https://connect.fisheries.noaa.gov/asar_tutorial/).\n\nThe SS3 Report.sso file was converted using the following code:\n\n```r\noutput \u003c- stockplotr::convert_output(\n  file = system.file(\"extdata\", \"Report.sso\", package = \"asar\"),\n  model = \"ss3\",\n  save_dir = here::here(\"readme_output.rda\"))\n```\n\nIn this function, the users have the option to convert output files to a standardized \nframework from either SS3 (Report.sso) or BAM (.rdat) output files. `asar` uses this \nconverted output from the environment to calculate quantities in the preamble and \nit is also used for creating plots and tables from [`stockplotr`](https://github.com/nmfs-ost/stockplotr).\n\nTo proceed, the user should then run the following:\n\n```r\nasar::create_template(\n  format = \"pdf\",\n  office = \"NWFSC\",\n  region = \"U.S. West Coast\",\n  species = \"Petrale sole\",\n  spp_latin = \"Eopsetta jordani\",\n  year = 2023,\n  author = c(\"Ian G. Taylor\"=\"NWFSC\", \"Vladlena Gertseva\"=\"NWFSC\", \"Nick Tolimieri\"=\"NWFSC\"),\n  include_affiliation = TRUE,\n  simple_affiliation = FALSE,\n  param_names = c(\"nf\",\"sf\"),\n  param_values = c(\"North fleet\", \"South fleet\"),\n  model_results = here::here(\"readme_output.rda\")\n)\n```\n\nNote: The output of this report is an example based on a real stock assessment. Please refer to the link in the beginning of this section for the full assessment report. \n\n## Testing\n\nWe encourage users to test `asar` throughout its development. Please use the above example to get a basic understanding on how to create a stock assessment template. **Currently, `asar` is only setup to render to a pdf or html.** Once the user successfully executes `create_template()`, all files are created and the user can render the document from the skeleton file:\n\n![](man/figures/example_pop-up.PNG){alt=\"A basic skeleton produced by asar displaying the beginning of the quarto document called the yaml. The image shows the title, author, and other important formatting arguments to render a quarto document.\"}\n\nAll associated files will be created in a folder called `report` within the `file_dir` argument path (default working directory).\n\n![](man/figures/example_file_system.PNG){alt=\"A screenshot of a file explorer showing the outline of quarto documents produced when running create template function from a.s.a.r. There are 15 quarto documents, a bib file, a glossary latex file, and a folder containing support files that dictate report format.\"}\n\nThis is a modularized template, there is no need to make any edits to the skeleton file. To write the report, user should navigate and open each supporting section Quarto document labeled:\n\n-   Executive Summary\n-   Introduction\n-   Data\n-   Assessment\n-   Discussion\n-   Acknowledgments\n-   References\n-   Tables\n-   Figures \n-   Appendix\n\n## Accessibility\n\nDid you know that `asar` reports contain several accessibility features, many of which are required as per Section 508 compliance standards?\n\nWe strongly encourage all users to check out the [Increasing Report Accessibility vignette](https://nmfs-ost.github.io/asar/articles/accessibility_guide.html) to learn:\n\n1. Which accessibility features are 100% built-in, and [which features require input from *you* to complete them](https://nmfs-ost.github.io/asar/articles/accessibility_guide.html#your-to-do-list)\n2. How to add the features requiring your effort (e.g., [alternative text](https://nmfs-ost.github.io/asar/articles/accessibility_guide.html#alternative-text))\n3. [The development status of the features](https://nmfs-ost.github.io/asar/articles/accessibility_guide.html#status-of-accessibility-features) that are required for submission as per two relevant NOAA checklists\n\n## Contributions\n\nHave you identified any suggestions for improvement, bugs, or questions? Please see our [Contributing page](https://github.com/nmfs-ost/asar/blob/main/CONTRIBUTING.md) for more information on how to make effective contributions to `asar`.\n\nThank you for helping us improve this package!\n\n## Tips\n\nIf you have additional questions, there is a helpful Q\u0026A guide available in the \narticles section of our GitHub Page located [here](https://nmfs-ost.github.io/asar/articles/faqs.html).\n\n## User Community\n\nThis package is intended for use by stock assessment analysts across NOAA Fisheries, but the modularized process and workflow can be used in other applications such as developing other reports for managing organizations or for rendering stock assessment reports in other regions of the world.\n\nFeel free to report any issues with the package to the [GitHub Issues Page](https://github.com/nmfs-ost/asar/issues) and any questions regarding the package on the [GitHub discussion board](https://github.com/nmfs-ost/asar/discussions). Before you create an issue, please see the status at the beginning of this page to check if the package is operational or still in early stages of development.\n\n## Code of Conduct\n\nWe as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation. We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.\n\nAll contributors participating and contributing to the asar project are expected to adhere to the [Code of Conduct](https://github.com/nmfs-ost/asar/blob/main/CODE_OF_CONDUCT.md).\n\n## Disclaimer\n\nThis 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 laws. 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnmfs-ost%2Fasar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnmfs-ost%2Fasar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnmfs-ost%2Fasar/lists"}