Full Changelog: https://github.com/osmose-model/osmose/compare/4.3.3...v4.4.0
\nThis release introduces major architectural improvements, new biological capabilities, expanded economic modeling, and significant refactoring of internal processes, especially:
\nThese changes modernize the modeling framework and extend its biological, ecological, and economic realism.
\n\n\n| Old Key | New Key |\n|------------------------------|-----------------------------------------|\n| simulation.bioen.enabled | module.bioenergetics.enabled |\n| simulation.genetic.enabled | module.genetics.enabled |\n| fisheries.enabled | module.multispecies.fisheries.enabled |\n| economy.enabled | module.bioeconomics.enabled |
| Old Key | New Key |\n|---------------------------------|---------------------------------------|\n| output.restart.enabled | simulation.restart.enabled |\n| output.restart.recordfrequency.ndt | simulation.restart.recordfrequency.ndt |\n| output.restart.spinup | simulation.restart.spinup.nyear |
| Old Key | New Key |\n|------------------------------------|------------------------------------|\n| predation.ingestion.rate.max.bioen.spX | predation.ingestion.rate.max.spX |\n| predation.coef.ingestion.rate.max.larvae.bioen.sp | predation.larval.ingestion.rate.increase.ratio.spX |\n| species.bioen.maturity.eta.spX | species.maturity.eta.spX |\n| species.bioen.maturity.r.spX | species.maturity.r.spX |\n| species.bioen.maturity.m0.spX | species.bioen.maturity.m0.spX |\n| species.bioen.maturity.m1.spXX | species.maturity.m1.spX |
These renames are mandatory for existing configurations.
\n\n\nspecies.reproduction.strategy.sp# = iteroparous or semelparousspecies.reproduction.postspawning.survivaltime.sp# = post-reproduction survival time (in years). Used only for semelparoussimulation.fixed.seed.enabled: used to control the stochasticity of a simulation and allow replicable runssimulation.nschool.multiplier: Parameter to multiply the number of schools for all species (default one):See here for details
\nspecies.maturity.mode: controls whether stochastic (stochastic) or deterministic (legacy) production is used.species.maturity.l50.sp#: mean of the gaussian - species.maturity.l75.sp#species.egg.density.sp#: density of eggs (in $g.cm^{-3}$) used to compute length from weight.species.multiplier.sp#: multiplier to control background species biomassspecies.multiplier.log.sp#: multiplier to control background species biomass (in log value)movement.randomwalk.range.sp#: allow to specify the range of random walk for background species.movement.netcdf.enabled: allow map distributions from NetCDF for Background speciesThe bioeconomic module is now functional. Parameters are fully described here
\nspecies.stock.elasticity.sp#baseline.costs.t0.sp#price.time.trend.sp#species.consumption.elasticity.sp#species.sizeconsumption.elasticity.sp#species.size.preference.sp#weight.fish.consumptionsubstitution.elasticityelasticity.demand.fishSee details here
\nmovement.random.walk.coef.sp#: Random walk coefficient (between 0 and 1)movement.base.search.radius.sp#: perception (integer, ranging from 1 to 0)simulation.resources.computePercent.legacy: if set to True, the LTL percentage that is eaten by a school is computed based on the original linear relationship. Else, it will use a $\\log$ relationship.Parameters to control whether a simplified bioenergetic implementation should be used (see here for details)
\nspecies.bioenergetics.model.sp: full or simplepredation.efficiency.critical.spXspecies.temperature.tmin.spXspecies.temperature.tmax.spXspecies.temperature.topt.spXpredation.ingestion.rate.max.spXcomputePercent methodMortality is now tracked per output region. Arrays such as nDead and ageDeath are now 2\u2011dimensional: [region][mortality_cause].
Fishing/discard tracking moved from biomass to abundance:
\nfishedBiomass \u2192 fishedAbundancediscardedBiomass \u2192 discardedAbundanceA new full subsystem handles background species:
\nOptional probabilistic (not deterministic) maturity (see here for details):
\nspecies.maturity.l50.sp# & species.maturity.l75.sp#Under the bioenergetics module:
\nspecies.egg.density.sp#This replaces the adult-coefficient-based egg mass\u2013length conversion.
\n\n\nEconomic modelling expanded significantly:
\n[fishery][species][size-class]New parameters include elasticities, cost time trends, size preferences and more.
\n\n\nsimulation.restart.*stepsimulation.fixed.seed.enabled enforces reproducible random number generation for:
Default chunking now uses the standard NetCDF-4 chunking strategy for improved performance.
\nRefactor ensures consistent treatment of background schools in spatial, fisheries, mortality, and predator-prey outputs.
\n\n\nfishedBy() / discardedBy() replaced by fishedNBy() / discardedNBy()incrementNdead() now requires the timestep:
incrementNdead(MortalityCause cause, double nDead, int timeStep)\nnDead, ageDeath, caught fish, discards, mortality outputs and other arrays now include a region dimension.
stepRestart files missing this field will cause the simulation to abort.
\nOld keys will not work without migration.
\nExisting background configurations relying on older semantics may need adjustment.
\n\n\nA very large subsystem rewrite:
\nBackgroundProcess executes each timestepBackgroundMapDistribution controls school movementBackgroundMapSet handles map loading (CSV/NetCDF)This will impact any tool, plugin, or analysis code accessing background species.
\n\n\nNew abstract methods required in AbstractSchool / IAggregation:
isMature()isAlive()getClassIndex()isOut()Plus new utilities:
\nresetAccessiblePreyIndex()addAccessiblePreyIndex()getAccessiblePreyIndex()Internal arrays:
\nnDead and ageDeath become 2D arrays [region][cause].equalsIgnoreCase()getAbsolutePath() instead of getCanonicalPath() (fix for Windows)Developers integrating with the economy module must update:
\nBiomassDietStageOutput.write method. There was a bug in the indexing during the conversion from 2D to 1D.SimulationStep, movementProcess.run() is now called before indicators.initStep(). This in order to make sure that the initial biomass is always less than the total predated biomass.SpatialAbundanceOutput.java and SpatialBiomassOutput.java), only cut-off ages were working, not cut-off length. This has been corrected.isUpToDate variable of the setMPA method was always true, therefore the fishing effort was never modified. Besides, MPA index as defined in the configuration files (.mpaXX) were expected to start from 0 onward. Now any index can work, as for species.Surveys and OutputRegion. When school was out of the domain, the code crashed. Fixed by assuming that outside schools are out of the survey region.NetcdfPopulator.java when genetic is enabled. The genotype was not instanciated.RelativeBiomassPopulator.java when genetic and/or bioenegetic was on. Genotype was not instanciated and maturity and gonadic weight were not initialized| Category | Summary |\n|--------------------|----------------------------------------------------|\n| New Features | Region\u2011specific mortality, stochastic maturity ogive, density-based egg size, background movement maps, expanded bioeconomics |\n| Breaking Changes | New fishing/discard APIs, mortality API requires timestep, config key renames, restart requirements, region dimension added |\n| Behavioral Changes | NetCDF chunking change, background school process rewrite, new maturity logic, numbers-based fishing |\n| Developer Refactors | Background species subsystem, economy engine, school interface changes, initialization/restart logic |\n| Bug Fixes | Improved validation, safer parsing, corrected map logic, more robust biomass and egg handling |
\n\n\nget_var() upgrade: new subsetting, safer behavior, and replicate sampling features make extraction of outputs more flexible and robust.A complete set of calibration utilities was added, centered around:
\nosmose_calibration_setup()\nCreates a calibration directory structure, writes guess/min/max/phase parameter files, installs scripts/templates, runs pre-flight model checks, and creates (or consumes) observed-data templates plus calibration settings.
osmose_calibration_test()\nRuns automated tests (data compatibility + sequential and parallel \"smoke tests\") to validate that the calibration environment is correctly configured.
osmose_calibration_runmodel()\nRuns the calibration-ready model using the calibration directory and parameter sets, with safeguards against mixing calibrated vs non-calibrated parameters.
osmose_calibration_check()\nRe-runs the model with best parameters from results/restart and returns a calibration object combining simulated/observed/settings/cv.
osmose_calibration_outputs()\nProduces a curated list of calibration-ready outputs (surveys, landings, catch-at-length, penalties for growth/mortality/collapse/outburst, etc.).
New helpers make it easier to transform, replicate, and write parameter sets:
\nset_par(), transform_par(), replicate_par()logit(), ilogit() helpersget_par2(), get_par_phase(), get_calibration_parameters(), get_osmose_parameter()write_osmose_parameter() (writes guess/min/max/phase entries for a parameter block).create_calibration_settings() plus type-specific helpers (simple/survey)head()/tail() on OSMOSE outputs)New head.* and tail.* methods preserve OSMOSE output class when slicing:
tail.osmose.biomass, tail.osmose.abundance, tail.osmose.yield, tail.osmose.yieldNhead.osmose.biomass, head.osmose.abundance, head.osmose.yield, head.osmose.yieldNA new internal check warns when egg density appears unrealistic:
\n.check_density() computes density from egg weight and egg size and emits warnings for \"lower than seawater\", \"abnormal\", or \"wrong\" density ranges.readOsmoseFiles() gains survey-aware grouping and safer behaviorbySurvey (in addition to bySpecies) supports more structured output folder parsing.bySpecies + bySurvey) is supported, with logic based on how many \"grouping dimensions\" are requested.NULL when no matching files exist, avoiding downstream failures.New NetCDF-based fishery outputs are supported and integrated:
\nyieldByFisheryBySpecies, yieldNByFisheryBySpecies, accessibleBiomassByFishery.reshapeFishery() (with by="fishery"|"species" and aggregate=TRUE/FALSE).aggregate_catch_bytime(), .aggregate_catch_byclass(), .aggregate_catch_byyear()observed.landings, observed.discards) to feed calibration workflows.bySurvey and include additional survey datasets (e.g., mortality/predator pressure) where available.NULL on read errors instead of erroring..read_osmose_ncdf() was hardened:try(nc_open(...)) and returns NULL if opening failstime, species, fishery, replicates) and handles species_names / fisheries_names attributesget_var() is significantly enhancedget_var.osmose() now supports:
sp, srv, fsh arguments for species / survey / fishery selectionno.error=TRUE returns NULL instead of throwing when variables are missingdrop, size, random, replace for slicing/sampling replicatesget_var.default(), get_var.osmose.calibration(), get_var.list, get_var.NULL\n\n\n\nPotential breaking change: code that relied on
\nget_var()erroring on missing variables may need updates ifno.error=TRUEis used or propagated.
plot.osmose()plot.osmose() now passes derived metadata (initialYear, freq) when plotting extracted variables, improving plot correctness for time axes.osmose objects is more informativeprint.osmose() now prints model name/version from configuration, replicate count, species list, and a compact list of available outputs (excluding empty/system fields).cacheManager, cachePath, flushCache, updateCache were refactored:TRUE/FALSE, clearer assignments, explicit return(invisible(NULL))X.Y.Z.W in addition to X, X.Y, X.Y.Z..trim_matrix() drops trailing all-NA columns more safely when reading some outputs.utils::relist/as.relistable and several calibrar functions).yieldByFishery structures are replaced/extended by new arrays and reshaped derivatives (landingsBy*, discardsBy*, etc.). If you depended on legacy fields, update to the new names.readOsmoseFiles() grouping: introducing bySurvey changes how files can be grouped/parsed; calling code may need to specify bySpecies/bySurvey explicitly.get_var() signature expanded: if you were using ... forwarding into get_var.osmose() you may want to ensure no name collisions with new formal args (sp, srv, fsh, size, etc.).<!--\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n# OSMOSE Release Notes - Version 4.4.0\n\nRelease notes capturing changes from OSMOSE 4.3.3 to 4.4.0\n\n## New Features\n\n### Model Capabilities\n\n- **Single Cell Mode**: Added possibility to run simulations on a single grid cell via `grid.single.cell.enabled` parameter\n- **Simplified Bioenergetics Module**: Support for simplified bioenergetics for data-poor species (e.g., invertebrates)\n- **Gradient-based Spatial Distribution**: New spatial distribution method for fish movements\n- **Marine Ecological Outputs**: Enhanced outputs for Marine project simulations\n- **Background Species Management**: Improved initialization and management of background and school species using biomass and `species.biomass.nsteps.year.spX` parameters\n-\n\n### Genetics and Allele Frequency\n\n- **Size Class in Allele Frequency Outputs**: Allele frequency outputs now include size class information\n- **Observed Heterozygosity (Htz) Output**: Size class tracking in observed heterozygosity outputs\n- **Early Genetic Transmission**: When no coding traits exist, genetic transmission can now occur earlier than seeding date\n- **Mean Genotype Outputs**: Averaged genotype outputs with recording frequency control\n\n### Mortality and Energy Dynamics\n\n- **Mortality Outputs by Region**: Ability to record mortality outputs on different spatial regions\n- **Additional Mortality Rates in Log Format**: Support for `mortality.additional.rate.log.spX` parameter for flexible mortality specification\n- **Imax Correction**: Fixed foraging mortality calculation when traits are not present\n- **Age and Size at Maturity Outputs**: New outputs for tracking maturity dynamics\n- **CPU Performance Outputs**: Added `output.cpu.performance.enabled` for monitoring computational performance\n\n### Fisheries and Economic Module\n\n- **Economic Module**: Fully functional economic module implementation (bioeconomics) with:\n - Fish price variation outputs\n - Harvesting costs computation\n - Profit margin calculations\n - Fisherman's profit equations\n - Net present value (NPV) calculations\n - Social optimum analyses\n- **Fisheries Accessibility Biomass**: Output of fishery accessible biomass and yields in abundance\n- **Catch by Numbers**: Fishing computation now in abundance rather than biomass (catch, landings, and discards)\n- **Fishery Outputs by Class**: New outputs by size/TL class with temporal and spatial disaggregation\n\n### Calibration Improvements\n\n- **New Calibration Functions**:\n - `osmose_calibration_outputs`: Process outputs for calibration\n - `osmose_calibration_runmodel`: Run OSMOSE as part of calibration workflow\n - `osmose_calibration_setup`, `osmose_calibration_test`, `osmose_calibration_demo`\n- **Multi-phase Calibration**: Support for multiple calibration phases with independent parameter sets\n- **Penalty Functions**: New penalties for outburst and collapse detection\n- **Group-based Parameterization**: Parameters can be modeled by species or fishery groups\n- **Cluster Computing Support**: Scripts for PBS/SLURM job schedulers (DATARMOR support)\n- **Template-based Workflow**: Survey calibration templates for streamlined setup\n\n### Reproduction and Growth\n\n- **New Reproduction Modes**: Separate handling of oviparity (SSB-based) and viviparity (SSN-based) modes\n- **Dynamic Maturity Check**: Maturation check now performed within school objects\n- **Stochastic Reproduction**: Enhanced stochastic reproduction processes\n- **Genetic Transmission in Reproduction**: Full integration of genetic transmission during reproduction\n- **Bioen Spawning Seasonality**: New spawning seasonality mechanisms for bioenergetic module\n\n### Configuration and Parameterization\n\n- **Class Definition in Outputs**: Flexible class threshold definitions for output distribution\n- **Species Names with Special Characters**: Support for dashes (`-`) in species names\n- **Simulation Start and Stop Parameters**: `simulation.time.start` and parameters for controlling temporal scope\n- **Nschool Multiplier**: New `simulation.nschool.multiplier` parameter to scale schools across focal species\n- **Dynamic Assignment**: `simulation.nschool` provides default for species not explicitly specified\n\n### NetCDF and Output Processing\n\n- **NetCDF-based Parameterization**: Support for NetCDF files for movement distribution and species forcing\n- **Improved Output Format**: Better organization and processing of NetCDF outputs with independent files by variable\n- **2D Output Support**: Enhanced 2D outputs (by species and size class)\n- **Output by Regions/Surveys**: Support for regional and survey-based filtering in outputs\n\n### Data Input and File Handling\n\n- **Regular Expression File Matching**: Use regex patterns to match input files from directories\n- **Flexible CSV Input Formats**: Better handling of various CSV separators in input files\n- **Absolute Path Handling**: Windows compatibility fix using absolute paths instead of canonical paths\n- **Time Series Management**: New `ByClassTimeSeries` for proportions in background species\n\n### Selectivity and Fishery Modeling\n\n- **Lognormal Distribution for Selectivity**: Support for lognormal selectivity curves\n- **Discrete Selectivity Values**: Ability to define selectivity using discrete values instead of curves\n- **Age Selectivity**: Enhanced support for age-based selectivity (though not for calibration)\n- **Selectivity Type 9**: New selectivity type implementation (non-parametric)\n- **Relaxed Selectivity Thresholds**: More flexible deltaL75 thresholds (up to 100% of selectivity)\n\n### Data Analysis and R Package Features\n\n- **Enhanced Output Reading**: `read_osmose` can handle multi-level disaggregation (surveys and species)\n- **Survey-based Analysis**: `get_var` and other functions accept survey as additional subsetting argument\n- **Predator Pressure by Survey/Region**: Regional predator pressure output capability\n- **Calibration Folder Management**: `read_osmose` handles calibration folders with multiple restart/results files\n- **New Templates**: Function to create R templates for initialization, calibration, and analysis\n\n## Parameter Changes\n\n### Renamed Parameters\n\n- Homogenization of module names:\n - `simulation.bioen.enabled` \u2192 `module.bioenergetics.enabled`\n - `simulation.genetic.enabled` \u2192 `module.genetics.enabled`\n - `economy.enabled` \u2192 `module.bioeconomics.enabled`\n - `fisheries.enabled` \u2192 `module.multispecies.fisheries.enabled`\n- Bioen-Osmose parameters for consistency with classical Osmose:\n - `predation.ingestion.rate.max.bioen.spX` \u2192 `predation.ingestion.rate.max.spX` (consistency)\n - `predation.coef.ingestion.rate.max.larvae.bioen.sp` \u2192 `predation.larval.ingestion.rate.increase.ratio.spX`\n - `species.bioen.maturity.eta.spX` \u2192 `species.maturity.eta.spX`\n - `species.bioen.maturity.r.spX` \u2192 `species.maturity.r.spX`\n- `output.fishery.*` \u2192 `output.fisheries.*` (output parameters)\n- `output.restart.*` \u2192 `simulation.restart.*` (output restart parameters)\n- `fishing.mortality.enabled` \u2192 `simulation.fishing.mortality.enabled` (clarified)\n- `species.file.spX` renamed in `species.biomass.file.spX`\n\n### New Parameters\n\n- `grid.single.cell.enabled`: Enable single-cell mode simulation\n- `output.cpu.performance.enabled`: Output CPU performance metrics\n- Background species:\n - `species.biomass.spX`: Initialize background species biomass by providing a time-series\n - `species.biomass.nsteps.year.spX`: Initialize background species biomass by providing a time-series\n- `mortality.additional.rate.log.spX`: Additional mortality in log format\n- `simulation.nschool.multiplier`: Scale schools across focal species\n- `population.initialization.biomass.log.sp#`: Population initialization biomass in log mode.\n- `reproduction.mode`: Specify reproduction mode (oviparous/viviparous/etc.)\n- `species.weight.at.larvae.growth.threshold.age` (W0): Optional (default 0)\n- `predation.success.disabled.sp`: Disable predation success for specific species\n- `simulation.resource.computePercent.legacy`: Legacy resource computation mode\n- `simulation.fixed.seed.enabled`: fix the seed for all the stochastic process (easy control for replicability)\n- Fisheries grouping parameters for disaggregated analysis\n- Survey selectivity and other survey-specific parameters\n\n### Deprecated Parameters\n\n- Paramters to fix seeds are now deprecated and replaced by `simulation.fixed.seed.enabled`:\n - `population.initialization.randomseed.fixed`\n - `genetics.randomseed.fixed`\n - `movement.randomseed.fixed`\n - `reproduction.randomseed.fixed`\n - `stochastic.mortality.randomseed.fixed`\n\n### Modified Parameter Behavior\n\n- **Annual Larval Mortality**: Now provided in rates/year instead of rates/time-step (multiply original rates by `simulation.time.ndtperyear`)\n- **Output Parameters**: `lastYear` and `lastAge` are now inclusive (previously exclusive upper bounds)\n- **Stochasticity Control**: Simulation output now depends on simulation rank index but is reproducible within replicates\n- **Species Initialization**: All species (focal, background, resource) must have different indexes\n- **Sex Ratio**: Default value of 0.5\n- **Year Max Seeding**: Set to zero when population initialization is true\n\n## Bug Fixes\n\n### Core Simulation\n\n- **Restart Initialization**: Corrected initialization of restarts from NetCDF files\n- **Trait Reinitialization**: Fixed trait reinitialization from restart files\n- **Time Index**: Corrected time index initialization from NetCDF\n- **Time Step Initialization**: Fixed time-step initialization handling\n- **Mortality with Infinity**: Fixed numerical issues with infinite mortality values\n- **Dead School Biomass**: Corrected biomass computation for dead schools, now using initial weight\n- **School Loop**: Simplified and corrected school iteration logic\n\n### Genetics and Traits\n\n- **Genetic Key Definition**: Fixed key definition in restart diversity loading\n- **Genotype Instantiation**: Corrected genotype instantiation in relative biomass populator and NetcdfPopulator\n- **Maturity Check**: Fixed `isMature` vs `isSexuallyMature` inconsistencies\n- **Foraging Mortality**: Corrected imax calculation when traits are not present\n\n### Movement and Distribution\n\n- **Movement Process Ordering**: `movementProcess.run()` now called before `indicators.initStep()` for consistent initial biomass\n- **Spatial Output Index**: Fixed wrong index in write_nc_coords for spatial outputs\n- **Cutoff Application**: Spatial outputs now correctly apply cutoff by length (previously only age worked)\n- **Out-of-Domain Schools**: Fixed crashes when schools moved outside domain (Surveys and OutputRegion)\n- **Map Distribution**: Corrected legacy_fixed map distribution method to avoid indexing bugs\n- **Movement Map Timing**: Fixed first time-step map comparison indexing\n\n### Mortality and Feeding\n\n- **Larval Mortality**: Starvation mortality now only applies if species is older than first feeding age\n- **Foraging Accessibility**: Fixed accessibility matrix reading with non-standard formatting\n- **Natural Mortality**: Corrected incrementNDead for resources and background species\n- **Mortality Outputs**: Numerical stability improved for mortality outputs by stage (EGG, JUVENILE, ADULT)\n- **Mortality Output Indexing**: Fixed `BiomassDietStageOutput.write` method indexing from 2D to 1D conversion\n\n### Fisheries and Catches\n\n- **Fished Biomass**: Corrected `getFishedBiomass` function to avoid null pointer exceptions\n- **Discard Biomass**: Fixed calculation of `discardedBiomass` (no longer exists as separate variable)\n- **Fishing Effort**: Corrected MPA initialization to properly update fishing effort based on restart files\n- **Fishing Normalization**: Flag to disable fisheries map normalization works with old fishery class\n- **Catch by Class**: Fixed temporal and spatial output computation for catch by trophic level\n\n### Background and Resource Species\n\n- **Background Species Position**: Fixed initialization of background species position (was all at 0,0)\n- **Background Schools in Diet**: Added background schools to diet computation\n- **Resource Output**: Fixed bug in resource output where background species were managed with ResourceForcing\n- **Background Species Initialization**: Corrected `getAllSchools` usage, replaced by `getSchools`\n\n### Output and Netcdf\n\n- **NetCDF Output Tests**: Corrected outputs (especially NetCDF) with comprehensive JUnit testing\n- **Spatial Output Consistency**: Removed dead schools from spatial outputs to match aggregated CSV outputs\n- **Relative Biomass Output**: Fixed when genetic and/or bioenergetic modules are enabled\n- **Netcdf Multithread Mode**: Forced NetCDF3 format (NetCDF4 causes errors in multithread mode)\n- **Netcdf Chunking**: Updated chunking strategy with standard as default\n- **Output Distribution**: Fixed `cutOff` parameter not being taken into account in `OutputWholeRegion`\n\n### Configuration and Initialization\n\n- **Maturity and Gonad Weight**: Corrected initialization of gonad weight and maturity in relative biomass initialization\n- **Growth and Mortality Penalties**: Reconfiguration of calibration penalty estimates\n- **Catch-at-Length Validation**: Improved error handling for null or zero catch-at-length data\n- **File Path Reconstruction**: Fixed resource reading with proper file path handling\n- **Array Indexing**: Corrected multiple array indexing issues throughout codebase\n- **Viviparous Initialization**: Corrected initialization logic for viviparous fish species\n\n### R Package Functions\n\n- **Configuration Reading**: Improved configuration validation and reading\n- **Parameter Retrieval**: Fixed `.getPar` to `get_par` with proper species offset handling\n- **Output Reading**: Enhanced robustness when reading calibration results with multiple files\n- **Yield Calculations**: Corrected yield computations for different output formats\n- **Predator Pressure**: Fixed predator pressure calculation by region/survey\n\n## Technical Improvements\n\n- **GitHub Actions**: Automatic testing of R package (build and check) and Java code (Maven build)\n- **Code Organization**: Extensive refactoring for consistency across modules\n- **Documentation**: Improved Quarto documentation with MyST parser migration\n- **Memory Management**: Replaced HashMaps with arrays where possible for performance\n- **Java Compilation**: Full migration to Maven build system\n- **NetCDF Library**: Updated to latest NetCDF Java library with compression features\n- **Error Messages**: Enhanced error reporting and validation messages\n- **Performance**: Reduced computation time for new fisheries implementation and school management\n\n## Version Information\n\n- **Java**: Maven-based compilation with updated NetCDF Java library\n- **R Package**: Enhanced with new calibration functions and analysis capabilities\n- **Configuration**: Automatic incremental updates from Osmose 3 and 4.x versions\n\n------------------------------------------------------------------------\n\n# Manually written release notes for OSMOSE 4.4.0\n\n## Parameter changes\n\n- Renaming of output fisheries parameters (`output.fishery.*` to `output.fisheries.*`).\n- Multispecies fisheries are activated using `process.multispecies.fisheries.enabled` (replaces fisheries.enabled).\n- **Annual larval mortality is now provided in rates/year instead of rates/time-step. So make sure to update your configuration file accordingly (multiply your original rates by** `simulation.time.ndtperyear`)\n- Possiblity to provide additional mortality rates in log format using `"mortality.additional.rate.log.spX` and\n- Parameter `predation.ingestion.rate.max.bioen.spX` has been renamed `predation.ingestion.rate.max.bioen.spX` to be consistent with the classical Osmose parameter names\n- Parameter `predation.coef.ingestion.rate.max.larvae.bioen.sp` has been renamed `predation.larval.ingestion.rate.increase.ratio.spX`\n- Parameter `species.bioen.maturity.eta.spX` has been renamed `species.maturity.eta.spX`\n- Parameter `species.bioen.maturity.r.spX` has been replaced by `species.maturity.r.spX`\n- Parameter `species.bioen.maturity.m0.spX` has been replaced by `species.bioen.maturity.m0.spX`\n- Parameter `species.bioen.maturity.m1.spXX` has been replaced by `species.maturity.m1.spX`\n- Parameter `fisheries.enabled` has been replaced by `module.multispecies.fisheries.enabled`\n- Parameter `simulation.bioen.enabled` has been replaced by `module.bioenergetics.enabled`\n- Parameter `simulation.genetic.enabled` has been replaced by `module.genetics.enabled`\n- Parameter `economy.enabled` has been replaced by `module.bioeconomics.enabled`\n\n## New features\n\n- Outputs:\n - Add the bioenergetic output of size at maturity.\n - Adding computation performance outputs (`output.cpu.performance.enabled`)\n - Adding additional genetic outputs (allele frequency outputs, observed and expected heterotrophy)\n - Output of fishery accessible biomass, yields in abundance and biomass\n - Averaged genotype outputs instead of instantaneous outputs.\n - Mortality outputs can now be recorded on different regions\n- Possibility to have simplified bioenergetics for species with lack of data (invertebrates).\n- Adding some patches to run Osmose on a single cell. This mode is activated by setting `grid.single.cell.enabled` to `True`. **This mode may be much slower than 2d simulations**\n- Adding gradient based spatial distribution\n- New management of background species and schools. Their biomass is now initialized with the `species.biomass.spX` and `species.biomass.nsteps.year.spX` parameters. And their schools are managed in the same way as focal species schools, contrary to having one school per grid cell as in the original implementation.\n- Fishing by fisheries is now computed in abundance rather than biomass (Ricardo Oliveros-Ramos change).\n- **New**: fully functional economic module (Emy Cottrant's post-doct)\n\n## Bug fix\n\n- Correction of the `BiomassDietStageOutput.write` method. There was a bug in the indexing during the conversion from 2D to 1D.\n- In `SimulationStep`, `movementProcess.run()` is now called before `indicators.initStep()`. This in order to make sure that the initial biomass is always less than the total predated biomass.\n- In spatial outputs (`SpatialAbundanceOutput.java` and `SpatialBiomassOutput.java`), only cut-off ages were working, not cut-off length. This has been corrected.\n- Correction in MPA initialization when using restart files. In some cases, the `isUpToDate` variable of the `setMPA` method was always `true`, therefore the fishing effort was never modified. Besides, MPA index as defined in the configuration files (`.mpaXX`) were expected to start from 0 onward. Now any index can work, as for species.\n- Correction in the reading of files from regular expressions. Canonical path was replaced by absolute paths to make it work on Windows\n- Correct a bug in `Surveys` and `OutputRegion`. When school was out of the domain, the code crashed. Fixed by assuming that outside schools are out of the survey region.\n- Added the background schools in the computation of diets.\n- Correct a bug in resource output: background species are no longer managed with `ResourceForcing`.\n\n-->
", "publication_date": "2026-05-21", "publisher": "Zenodo", "related_identifiers": [ { "identifier": "https://github.com/osmose-model/osmose/tree/v4.4.0", "relation_type": { "id": "issupplementto", "title": { "de": "Erg\u00e4nzt", "en": "Is supplement to" } }, "resource_type": { "id": "software", "title": { "de": "Software", "en": "Software" } }, "scheme": "url" } ], "resource_type": { "id": "software", "title": { "de": "Software", "en": "Software" } }, "rights": [ { "description": { "en": "" }, "id": "gpl-3.0-only", "props": { "scheme": "spdx", "url": "https://www.gnu.org/licenses/gpl-3.0-standalone.html" }, "title": { "en": "GNU General Public License v3.0 only" } } ], "title": "Object-oriented Simulator of Marine ecOSystEms (OSMOSE)", "version": "v4.4.0" }, "parent": { "access": { "owned_by": { "user": "104051" }, "settings": { "accept_conditions_text": null, "allow_guest_requests": false, "allow_user_requests": false, "secret_link_expiration": 0 } }, "communities": { "default": "ea7888cb-4a58-43c3-b2ed-a77e2115ad96", "entries": [ { "access": { "member_policy": "open", "members_visibility": "public", "record_submission_policy": "open", "review_policy": "open", "visibility": "public" }, "children": { "allow": false }, "created": "2023-01-20T17:06:54.349018+00:00", "custom_fields": { "subjects": [ { "id": "euroscivoc:317" }, { "id": "euroscivoc:489" }, { "id": "euroscivoc:323" } ] }, "deletion_status": { "is_deleted": false, "status": "P" }, "id": "847d19e5-9891-403c-8120-d5d5f8aa208a", "links": {}, "metadata": { "curation_policy": "New uploads in this community must contain publicly distributable material related to the activities of the UMR MARBEC and its partners
", "organizations": [ { "id": "049dk3691" }, { "id": "05q3vnk25" }, { "id": "00wh4bp03" }, { "id": "edmo:2895" }, { "id": "edmo:1054" } ], "page": "UMR MARBEC (MARine Biodiversity, Exploitation & Conservation) is a joint research unit that brings together staff from four main institutions, IRD, Ifremer, the University of Montpellier and CNRS, and a secondary institution, INRAE.
\n\nUMR MARBEC working on marine biodiversity exploitation and conversion. More details on www.umr-marbec.fr
\n\nThis ZENODO community contains open access material published by the UMR MARBEC members, such as raw data, reports, white papers, presentations, videos, codes, etc.
", "title": "MARBEC - MARine Biodiversity, Exploitation & Conservation", "type": { "id": "organization" }, "website": "https://www.umr-marbec.fr" }, "revision_id": 14, "slug": "umr-marbec", "updated": "2025-02-13T12:29:37.839338+00:00" }, { "access": { "member_policy": "open", "members_visibility": "public", "record_submission_policy": "open", "review_policy": "open", "visibility": "public" }, "children": { "allow": false }, "created": "2020-11-16T09:16:56.552243+00:00", "custom_fields": {}, "deletion_status": { "is_deleted": false, "status": "P" }, "id": "ea7888cb-4a58-43c3-b2ed-a77e2115ad96", "links": {}, "metadata": { "title": "Osmose model" }, "revision_id": 2, "slug": "osmose", "updated": "2026-03-31T09:24:04.628926+00:00" } ], "ids": [ "847d19e5-9891-403c-8120-d5d5f8aa208a", "ea7888cb-4a58-43c3-b2ed-a77e2115ad96" ] }, "id": "7628348", "pids": { "doi": { "client": "datacite", "identifier": "10.5281/zenodo.7628348", "provider": "datacite" } } }, "pids": { "doi": { "client": "datacite", "identifier": "10.5281/zenodo.20322216", "provider": "datacite" }, "oai": { "identifier": "oai:zenodo.org:20322216", "provider": "oai" } }, "revision_id": 4, "stats": { "all_versions": { "data_volume": 10901273313.0, "downloads": 284, "unique_downloads": 272, "unique_views": 1181, "views": 1231 }, "this_version": { "data_volume": 393529059.0, "downloads": 11, "unique_downloads": 11, "unique_views": 56, "views": 56 } }, "status": "published", "swh": {}, "updated": "2026-05-21T07:30:28.288053+00:00", "versions": { "index": 8, "is_latest": false } }