AGEPRO-GUI version 4.3.7

AGEPRO-GUI version 4.3.7 includes the "Release" version of AGEPRO Version 4.25 Calculation Engine. AGEPRO models using the AGEPRO VERSION 4.25 format should be be using this binary.

• Updated AGEPRO Calucation Engine binary version based on AGEPRO commit a525a7b. This binary is intended as the Release version of AGEPRO VERSION 4.25, which includes bug fixes to the AuxiliaryOutputFlag/OutputSummaryFlag output options.
• Added a check for AGEPRO *.out files, created by the AGEPRO Calculation Engine, to the target output directory, to prevent files not found crashes, if "System Default" or "Notepad" output file viewers was selected.
• Added validation for non-zero Random number seed values for agepro models. This is to prevent AGEPRO calculation engine's unattended behavior with the zero random number seed.
• CoreLib: Added Validations for General Model Options.
• Minor update to AGEPRO-GUI Help manual. Added Legacy note for section Scaling factors with VPA(Virtual Population Analysis)
• Added CITATION to README.

AGEPRO-GUI version 4.3.6

Note

AGEPRO-GUI version 4.3.6 is compatible with AGEPRO VERSION 4.0 and AGEPRO VERSION 4.25 formatted input files. To use the new AuxiliaryOutputFlag Options (No Stock Of Age AND Auxiliary File, Output Stock Of Age, but NO Auxiliary Files, or Output Stock OF Age and Auxiliary Files EXCEPT Stock Numbers Of Age Auxiliary File), Input files must be saved as AGEPRO VERSION 4.25 Input File format to run with the changes to the included AGEPRO calculation engine

AGEPRPO-GUI Version 4.3.6 is a major update that includes the updated version of the AGEPRO Calculation Engine version 4.25, allowing the user to control which of the three following filesets should be outputted: Stock of Age Distributions, Stock Numbers of Age Auxiliary File, and rest of the Auxiliary Files.

• Updated AGEPRO Calculation Engine Binary version based on development snapshot on commit 945c7b2, which includes new changes to the output option OutputSummaryFlag/AuxiliayOutputFlag.
• Support for Current Version Input File Format (AGEPRO VERSION 4.25) and AGEPRO VERSION 4.0
  • Added Version String Resources: GUI Version variable, input file string, and numeric style versioning format identifier for the AGEPRO calculation engine.
  • General Model Options : Added text box in general options to show the current format of the AGEPRO input file.
  • Handling current version input file format (AGEPRO VERSION 4.25) and AGEPRO VERSION 4.0
    • By default, new AGEPRO models will be saved as AGEPRO VERSION 4.25 format.
    • Loading a (valid version format) Input File to AGEPRO-GUI will retain its format. For AGEPRO VERSION 4.0 Input files, these files must be saved as the input file current version format (AGEPRO VERSION 4.25) to run the model with the included AGEPRO calculation engine
    • To toggle between the input file current version format (AGEPRO VERSION 4.25) and AGEPRO VERSION 4.0, goto Misc Options and toggle the check box saying Enable AGEPRO VERSION 4.0 Input File Format
• AGEPRO-GUI Support for changes to the output option OutputSummaryFlag/AuxiliayOutputFlag introduced in the updated AGEPRO Calculation Engine.
  • Misc Options checkbox option Output Summary Report at Stock Numbers at Age is replaced by Stock Of Age Distribution and Auxiliary Files Output group box allows users to fine tune Auxiliary Outputs after completing projections through the AGEPRO calcuation engine. The Options are:
    • No Stock Of Age, but Output Auxilary Files EXCEPT Stock Numbers Of Age Auxiliary File. This option is backwards compatible with AGEPRO VERSION 4.0 Input Files
    • Output Stock Of Age AND ALL Auxiliary Files. This option is backwards compatible with AGEPRO VERSION 4.0 Input Files
    • No Stock Of Age AND Auxiliary File
    • Output Stock Of Age, but NO Auxiliary Files
    • Output Stock OF Age and Auxiliary Files EXCEPT Stock Numbers Of Age Auxiliary File.
  • If AGEPRO VERSION 4.0 Input File format is loaded, only the first two radio buttons are enabled
• Rearranged the order where Number of Population Simulations is shown within the general "options" group to reflect the GENERAL parameter order documented in the AGEPRO reference manual.
  • Fixed Tab Order to represent the rearrangement
  • Initial default value for Number of Population Simulations is 1000
• AGEPRO Example Input Files
  • Updated Example 1-3 AGEPRO Input Files to AGEPRO VERSION 4.25 format.
  • Added Example1.rdat to Example 1 to demonstrate export AGEPRO Output to R Data format.
  • exampleDocs.md -> exampleDocs.qmd: Reformatted with Quarto.
    • Updated Example 1 description to include Example1.rdat.
    • Note: Example 4 is still under the AGEPRO VERSION 4.0 AGEPRO Input file format.
• Updated December 2025 Revision of AGEPRO Reference Manual for AGEPRO VERSION 4.25
  • Updated "Reference Manual (pdf)" menu option to Dec 2025 revsion of AGEPRO Reference Manual
• Updated AGEPRO-GUI Help manual
  • Quarto backend to develop AGEPRO-GUI HTML file
    • Replaced Screenshots with the Windows 11 Workspace
  • Updated "Stock of Age Distribution and Auxiliary Files Output" Documentation
  • Added documentation for (AGEPRO VERSION 4.25) Auxiliary Files Flags
  • Added Screenshots for AGEPRO Calculation Engine, Bootstrap panel, and Misc. Options Panel
  • Readably Tweaks to "New Case" Section, and Validation section of Saving AGEPRO Input Data to File
  • Clarify and make distinct references to "AGEPRO-GUI", "AGEPRO Input File" format, and the "AGEPRO Calculation Engine" when "AGEPRO" was mentioned in the HTML manual previously. Make it distinct that "AGEPRO Calculation Engine" is the primary "AGEPRO" program. GUI references point to "AGEPRO-GUI".
  • Replaced redundant "AGEPRO Projection Samples" Section to "include" exampleDocs.qmd
• Bugfixes
  • Store path of Loaded AGEPRO Input File (#22)
  • Add blank string delimiters to fix an issue AGEPRO GUI/CoreLib was writing invalid Parameter Curve data into input files.(#18)
  • Fixup ObsYears( validation causing an false "Invalid Rebuild and P-Star Year Specification" validation (#27)
    Improve handling BootstrapFile prior to AGEPRO model launch to calcuation engine:
  • Fixed method to check if bootstrap file is in the same path as the input file.
    • Clarified dialog text for this validation check.
    • Added Conformation Dialog prior to validation
  • Rebuilder and PStar Values can now be saved to Input Files
  • GitHub Bug Report Templates (#23)
  • Clarify an ambiguous and unreadable error prompt that an Agepro Output file doesn't exist on the target calculation run path.
• README updates
• Code Documentation and Refactoring
  • Clarified References to AGEPRO-GUI and AGEPRO Calculation Engine
    • Renamed menu item: "About AGEPRO" -> "About AGEPRO-GUI"
  • Refactor for RetroAdjustment Consistency
  • NftTextBox Code Documentation
  • Removed enum class StockSummaryFlag
  • Rename:
    • Rename Strings.resx -> AgeproStrings.resx
    • Rename SummaryAuxFileOutput -> SummaryAuxFileOutputFlag
    • rename miscOptionsNAges -> miscOptionsNumAges
    • Rename SetupRetroAdjustmentFactorsControlFromUserInput -> SetupRetroAdjustmentsFactorControl
    • Rename SetRetroAdjustmentFactorRowHeaders -> SetupRetroAdjustmentsFactorRowHeaders
    • Rename BindMiscOptionsControlValuesToCoreLib -> ControlMiscOptionsDataBindings
    • Rename SetMiscOptionsFromInputFile -> SetupControlFromFile
    • Rename SetControlDataBindings -> SetupTextBoxDataBindings
    • Rename SetupSummaryStockSummaryStockFlagRadioButtons -> SetupGroupSummaryStockFlag
    • Rename StockSummaryFlag -> AuxiliaryOutputFlag
  • Update to Target .NET Framework 4.8

AGEPRO-GUI version 4.3.5

AGEPRO-GUI version 4.3.5 is a minor release. The release includes revisions to the AGEPRO Reference Manual (@JonBrodziak).

AGEPRO Version 4.3.4

AGEPRO version 4.3.4 focuses on refactoring AGEPRO-GUI and AGPEPRO-CoreLib code base with modern C# code styles, reduce redundancies, and improve code readability

In addition, the version introduces a new example projection; Uku Projection Base (2019-2026). This is a fishing mortality and stock biomass projection for the Uku snapper from a 2020 stock assessment in Hawaii.

[2020 Uku Assesment]
https://github.com/PIFSCstockassessments/MHI-Uku-2020-Final

4.3.4 (2021-06-15)

Changes

• AGEPRO GUI and CoreLib code refactor (Overall changes)
  • Format public class members to Pascal Casing. (Private class members will have Underscore-Prefix Pascal Casing)
  • Removed Unused Imports
  • Simplify (reduced) usage of the this keyword
  • Replace var to explict types
  • Simplify Array Implementation
  • Refactored conditionals (if-else, null checks) to be more readable.
  • Applied standalone discards for existing methods that returns a value.
  • Enums refactored to own file
• Added fourth AGEPRO example model: Uku snapper Projection Base (2019-2026)
• AGEPRO user help manual
  • Inculded missing images to binary
  • Reverted stylesheet back to basic html style
  • Added AGEPRO Projection Samples section
  • Minor updates to the Weights of Age Section
• CoreLib: Bootstrap, (Misc)Options, Recruitment, Harvest Scenario (HarvestCalcuation) uses generalized AgeproCoreLibProperty class for data binding.
• User Interface
  • Added Base class FormAgepro to handle ui startup, validation, load, save, create new Agepro model from user input.
  • Minor menu item size adjustment for Windows 10
• Pstar/Rebuider
  • Use CoreLib to create PStar and Rebulider objects; Remove AGPERO GUI data object redundancy.
  • PStar/Rebuilder control defaults will now instantiate from its own classes rather from the ControlHarvestScenario constructor.
• Recruitment
  • CoreLib: Extract RecruitDictionary as class RecruitModelDictionary.
  • Removed AGEPRO GUI reduancy and reference usages to CoreLib object.
  • CoreLib: Invaild recruitment row coount error message claification.
• AgeproMiscOptions
  • Removed Util.GetAgeproInputDataTable; ControlMiscOptions.LoadRetroAdjustmentsFactorTable is the replacement method
  • CoreLib: Refactor Misc Option classes as indvidual "AgeproOptionProperty" subclass files
• Biological
  • Created ControlTSpawnPanel to encapsulate embeded 'Fraction Mortality' methods in ControlBiological;
• Stochastic/Weights Of Age
  • Fixed Null Input Data Stochastic Weight of Age Import Fix
• CoreLib: Moved code files into categorized src subdirectories. No changes to namespaces, Namespaces for new CoreLib *.cs files are set to Nmfs.Agepro.CoreLib.
• Renames to AGEPRO GUI objects:
  • (src/ui/formAgepro subdirectory) home -> general-startup
  • ControlStochasticAge.EnableTimeVaryingCheckBox -> ControlStochasticAge.EnableFromFilePanel
  • FormAgepro.CreateAgeproModel -> FormAgeproBase.SetAgeproModelFromUserInput
  • FormAgepro.LoadAgeproInputParameters -> LoadAgeproBase.LoadAgeproModelFromInputFile
  • ControlStochasticAge.EnableVaryingCheckBox -> ControlStochasticAge.EnableFromFilePanel
• Renames to AGEPRO CoreLib objects:
  • MiscOptionsParameter -> AgeproOptionsProperty
  • jan1Weight -> Jan1StockWeight
  • biological -> BiologicalTSpawn
  • maturity -> BiologicalMaturity
  • retroAdjustOption -> RetroAdjustments
  • RecruitmentModel -> RecruitmeentModelProperty
  • FixedEmpiricalRecruitment -> EmpriricalFixedRecruitment
  • TwoStageEmpiricalRecruitment -> EmpriricalTwoStageRecruitment

AGEPRO Version 4.3.3 Release

4.3.3 (2021-03-22)

AGEPRO version 4.3.3 is a minor bugfix update. The help manual is updated for Windows 10.

AGEPRO version 4.3.3 is using a new installer based on Inno Setup. AGEPRO is installed per user basis. Administrator privileges is required for uninstallation.

Changes

• Removed Redundant F-MULT validation check preventing rebuilder projections to launch the AGEPRO Calculation Engine (#13)
• AGEPRO user help manual
  • Updated screenshots to Windows 10
  • Formatted with the Pandoc default html styleseet
  • Converted example Combined Catch Distrbution & Requested Percentile Report output as tables
  • Fixup help manual section links
• About: Updated NOAA Branding
• Minor refactoring
  • GUI & CoreLib: categorized code in src subdirectories (no changes to namespaces)

AGEPRO Version 4.3.2 Release

AGEPRO version 4.3.2 fixes an issue that prevented AGEPRO Input files with various white-space delimiters (e.g. tabs) to be loaded to the GUI. This version also resolves an issue with handling Multi-Fleet Stochastic Weight Of Ages and Pstar/Rebuilder data binding.

4.3.2 (2019-07-24)

Changes

• Fixed an issue preventing AGEPRO Input Files with tabular whitespace delimiters to be loaded to GUI.
  • AGEPRO-CoreLib: Replaced space character to default (whitespace character delimitation) to split input fileline values. (#7)
• Loading StochasticWeightAge Input Data is more consistent to how StochasticAgeTable handles AGEPRO Input Files from file (or user generated new cases).
  • A fallback table will be created if the StochasticWeightAge is Multi-Fleet: Call CreateStochasticAgeFallBackTable to handle StochasticWeightAge fleet Dependency and to remove redundancy. (#9)
  • Renamed LoadWeightAgeInputData -> LoadStochasticWeightAgeInputData.
  • Cleaned up null checks
  • Set access to helper method CreateFallbackAgeTable to private.
• CreateStochasticParameterFallbackDataTable: Replaced genOpt class from AGEPRO-GUI ControlGeneral Class object to AGEPRO-CoreLib General Options Object to match consistency with Stochastic Data Tables.
• Fixed data binding issues for PStar and Rebuilder values.
  • Fixed an issue where new/modified PStar or Rebuilder GUI input didn't save to input data file.
• General Options input from is the first AGEPRO parameter binded with its AGEPRO-CoreLib counterpart, when setting user generated new cases.
• Simplified input file loading error dialogs to error messages only.
• Fixed Rebuilder option's Harvest Specification validation to begin on the 3rd projection year row.
• Minor help manual updates and format tweaks.

AGEPRO Version 4.3.2 Pre-Release 2

This is the second pre-release of AGEPRO version 4.3.2. This pre-release resolves a number of Pstar and Rebuilder related issues found with the previous pre-release. Changes listed here for Pre-release 2 may be included in the release version of AGEPRO version 4.3.2 which will come soon.

AGEPRO version 4.3.2 fixes an issue that prevented AGEPRO Input files with various white-space delimiters (e.g. tabs) to be loaded to the GUI

Changes

• Fixed data binding issues for PStar and Rebuilder values.
  • Set Rebuider/Pstar default values. Important for new user generated AGEPRO cases.
  • Fixed an issue where new/modified PStar or Rebuilder GUI input didn't save to input data file.
  • CoreLib: Inheritance with Harvest Scenario Calcuation Classes
• Rebuider Harvest Spec validation now begins at correct year row.(#11)
  • Fixed Rebuilder option's Harvest Specification validation to begin on the 3rd projection year row.

AGEPRO Version 4.3.2 Pre-Release 1

This is pre-release 1 of AGEPRO version 4.3.2. The release of AGEPRO version 4.3.2 will come soon.

AGEPRO version 4.3.2 fixes an issue that prevented AGEPRO Input files with various white-space delimiters (e.g. tabs) to be loaded to the GUI.

Changes

• Fixed an issue preventing AGEPRO Input Files with tabular white-space delimiters to be loaded to GUI.
  • CoreLib: Replace space character to default string.split (white-space characters) to split input filelines. (#7)
• Refactored StochasticWeightAge Input Data file loading code to be consistent with StochasticAgeTable, in Loading AGEPRO Input Files and setting user generated new cases.
  • CreateStochasticParameterFallbackDataTable: Replace AGEPRO-GUI ControlGeneral class with AGEPRO-CoreLib AgeproGeneral for its General Options parameter to match consistency with Stochastic Data Tables.
  • Call CreateStochasticAgeFallBackTable to handle Fleet Dependency and to remove redundancy. (#9)
  • Clean up null check code
• Prioritize binding CoreLib General Options Data before setting other AGEPRO parameters when user generated new cases are SET.
• Simplify Input File Loading Exception Dialog to error messages only. (#8)
• Minor tweaks to user help manual.

AGEPRO Version 4.3.1 Release

4.3.1 (2019-03-29)

AGEPRO Version 4.3.1 fixes major issues in handling input from initialized user-generated AGEPRO option sets.

Changes

• Ensure GUI input modifications, and GUI input from User generated new cases (initialized by submitting General Option values via 'SET' button) are written to AGEPRO input data files. (#1)
  • GUI input fixes to General Options, Stochastic Weights of Age, Stochastic Ages (Natural Mortality, Maturity, Fishery Selectivity), and Case ID. (#4, #5)
  • Fixed missing Natural Mortality data bindings.
  • Fixed a data binding issue if the user submits (General options 'SET' button) a new case over a new case.
  • CoreLib: Added AgeproCoreLibProperty for generic AGEPRO Parameter Data Binding
• Implicitly set new case default values during initialization. (#1)
  • Case ID defaults to untitled (#3)
• Include AGEPRO [PARMETER] to NULL error message to indicate parameter found with blank/NULL stochastic age/weight or CV datatables. (#1, #4)
• Misc Options, P-Star, Rebulider, Parametric Recruitment: Tweaked binded values updates to OnPropertyChanged. (#1)
• Helpfile: Clarifications on the P-Star and Rebulider sections.
• Recuitment: increased default maxRecuitObs to 500

AGEPRO 4.3.0 Release

Significant User Changes from AGEPRO 4.2.2

• New user interface. Replaced tabs with the a navigation Tree Node to navigate through AGEPRO parameters.
• AGEPRO option parameters are scalable.
• No output plot functionality for the calcuation engine output.
• Launching AGEPRO Calcuation Engine saves a copy of current GUI input, bootstrap data, and calculation engine output in a new folder located AGEPRO user's HOME or documents directory instead of overwriting input file.
• Consolidate recruitment model actions in single panel: Recruitment.
  • Contains general "Recruitment" options and "Recruit Model" Type ("Emprical-R", "Parametric-R", "Predictor-R", "Markov Matrix-R" in ver 4.2.2).
  • "Recruit Model" handles multiple selections of varying model types. (Enforces the single Markov Matrix Recuitment Model rule.)
• Version 3.x Input File Formats are incompatible.
• AGEPRO Help Manual ('Using AGEPRO' in ver 4.2.2) is now in web page format.

Other Changes

• Including 2018 revisions to Jon Brodizak's AGEPRO Reference Manual
• In the Biological panel, "Fraction Mortality Prior to Spawing" and "Maturity at Age" are seperated into their own tabs.
• Streamlined Menu options
  • Output File Viewer option in Misc options.
• Toolbar not included in this interface.
• "Discard Weights" and "Discard Fraction" are accessible if the discards is not enabled, however GUI controls are disabled.
• Moved Time Varying Checkboxes.
• 'Fill Down' and 'Fill Right' functionality are replaced with 'Fill Blank Cells'
• README and LICENCE compliant with DOC Policy.

Known Issues

• Misc Options Panel is not Scaleable.