v1.0.0

[Schiano-NOAA]

We are excited to announce the release of v1.0 of asar for use in writing stock assessment reports for NOAA Fisheries. We encourage the use of this template to shift the content as well as formatting of our stock assessments reports. This will create a more unified and consistent product from those who use this tool. We are actively still developing this tool and hoping to make improvements and add more features throughout 2025.

Summary

• Major functions fully built allowing for customizations of stock assessment reports
• create_template() produces a modular structure to write a stock assessment report and incorporate pre-built tables and figures from satf
• users have the option to follow the workflow outlined in a tutorial or execute most of the necessary functions through create_template itself through specific arguments.
• convert_output() creates a standardized output file from BAM .rdat or SS3 Report.sso of key quantities and outputs (more functionality for other models planned for later)
• Built pkgdown site providing resources to use the tool to write stock assessment reports including short cuts for markdown notation and increasing accessibility in reports
• Pre-added cover images into the report (we are looking to expand this, so please leave an issue if the a specific species is missing!)
• Built in bibliography file which includes example references from the West Coast of the U.S.; however, a different file can be added.
• Template defaults to a LuaLaTex engine to accommodate greater accessibility features

For more details of this release or other progress of development, please refer to our Releases Page.

Tutorial

For those interested in using this package, we have created a tutorial that will walk you through the interworkings of using asar and how it could be incorporated into the workflow once model results are available for analysis.