Changelog

Historical release notes for past JAMS versions, newest first. Going forward, release notes for new versions are published directly on the GitHub Releases page.

Version 3.17 (2025-11-26)

Software Improvements and Bug Fixes

  • minor usability improvements to the JAMS GUI / window layout

New / Improved Model Components

  • J2K_iso
    • model components for the simulation of isotope mixing, unmixing and transport
  • jams.components.io.TSDataStoreReader
    • adapted to work with different calendar types as found in some climate models (standard calendar, 360-day calendar, standard calendar w/o leap years)
Version 3.16 (2024-12-02)

Software Improvements and Bug Fixes

  • minor usability improvements to the JAMS GUI / window layout

New / Improved Model Components

  • jams.components.core.TemporalFileInputContext
    • complete rework of the component
    • component allows to iterate over time steps defined in a JAMS timeseries input file
  • jams.components.io.TSDataStoreReader
    • adapted to work with new TemporalFileInputContext
  • jams.components.io.unidata.EntityCollectionFromList (new)
    • extract an entity collection object from a NetCDF file
  • jams.components.io.unidata.NetCDFReader3D
    • various improvements
  • optas.efficiencies.UniversalEfficiencyCalculator
    • added KGE to the efficiencies calculated by the UniversalEfficiencyCalculator, as well as a weighted version, and a version returning its 3 components r, gamma, beta
  • jams.components.calc.DoubleArrayDivide (new)
    • added component for dividing all elements of a DoubleArray
  • jams.components.indices.ClimateIndicesForest
    • added some outputs
  • jams.components.io.DataSerializer (new)
    • combines observed and simulated values for different locations into one large list of obervations and simulations
  • jams.components.datatransfer.DoubleTransfer
    • Added option to copy/overwrite value
  • jams.components.data.EntityDoubleAccess (new)
    • Added component to get double values by name from an entity and store it
Version 3.15 (2023-02-05)

Software Improvements and Bug Fixes

  • improvement to the JAMS GUI / window layout
  • usability improvements to the Data Explorer
  • added option to define standard output data directory via properties file

New / Improved Model Components

  • jams.components.io.unidata.NetCDFReader, jams.components.io.unidata.TimeIntervalFromNetCDF
    • read spatio-temporal data from from a NetCDF file
    • creates a time interval attribute from a NetCDF file, e.g. for iterating over all of its time steps
  • jams.components.io.TimeIntervalFromDataStore
    • creates a time interval attribute from a datastore, e.g. for iterating over all time steps in an input dataset
  • jams.components.aggregate.MinMax
    • calculates min/max of incoming values
  • jams.components.aggregate.SpatioTemporalAggregator
    • improved aggregation options for spatio-temporal data
  • jams.components.statistics.PercentileCalc
    • caculates percentile values from input data
  • jams.components.io.TemporalShapeEntityWriter
    • improved handling of temporary files
  • jams.components.io.TemporalShapeEntityWriter
    • added function to auto-create subdirectories based on name
Version 3.14 (2021-11-06)

New Model Components

  • org.unijena.j2k.inputData.RecalcLanduseStateVars
    • recalculation of landuse state variables during simulation, e.g. for landuse changes
  • org.unijena.j2k.topology.ReachSubbasin, org.unijena.j2k.topology.SubbasinArea, org.unijena.j2k.io.SubbasinLink
    • extraction of all HRUs belonging to a reach subbasin as a list
    • calculation of the area of a reach subbasin
  • jams.components.indices.SnowLine
    • calculation of snow line elevation

Improvements and Bug Fixes

  • minor bug fixes and improvement to the JAMS runtime system and GUI
Version 3.13 (2020-04-22)

New Example Model

A new J2K hydrological model for the Dudh Koshi River Basin with all required data and additional components for glacier processes simulation is available in the data folder. Thanks to Santosh Nepal from ICIMOD/Kathmandu for providing this dataset!

New Model Components

  • org.unijena.j2k.regionalisation.Regionalisation_IDW is a component that implements interpolation based on Inverse Distance Weighting (IDW) with the following improvements:
    • Intergrating all required functionality in one component without an additional initialization component, it allows to streamline and simplify model structure.
    • In addition to data interpolation, it allows to calculate and output information about average station distance and station elevation difference at each time step, provoding improved insight into the spatial and temporal distribution of station information density.
  • jams.components.data.DateComponents allows to extract single components from a date object
  • jams.components.data.ScalarToArray allows to collect double scalar(s) into double array(s)
  • jams.components.indices.SPICalc, jams.components.indices.DataColllector and jams.components.indices.DateCollector are components for calculation of Standardized Precipitation Index (SPI) and for collecting respective precip and calendar values
  • jams.components.calc.DoubleArrayMultiply allow to multiply elements in a double array with one or many double values
  • jams.components.data.CalendarComponentChanged allows to detect changes in a component of a date object and thus to perform actions at certain time periods (e.g. monthly, yearly in a daily model)

Improvements and Bug Fixes

  • added support for Datastore outputs of TemporalNestedContext
  • minor bug fixes and improvement to the JAMS runtime system and GUI

Revision 01

  • minor fixes in the Dudh Koshi example model
Version 3.12 (2019-10-11)

New J2K Components

  • org.unijena.j2k.regionalisation.LapseRateRegionalization is a lapse rate component, taking into account distance to stations, missing data and yearly or monthly lapse rates
  • org.unijena.j2k.regionalisation.LapseRateAdaptation can be used in combination with the IDW regionalization to apply a lapse rate approach in the interpolated climatic variable. For this purose, IDW can now output the average (weighted) elevation of the source stations. This elevation can then be used in LapseRateAdaptation to adapt the IDW result according to the elevation difference between the HRU and the source station elevations
Revision 01:
  • added lower/upper  boundary options to org.unijena.j2k.regionalisation.LapseRateRegionalization and org.unijena.j2k.regionalisation.LapseRateAdaptation
Revision 02:
  • fixed bug in org.unijena.j2k.regionalisation.LapseRateRegionalization and org.unijena.j2k.regionalisation.LapseRateAdaptation
Version 3.11_00 (2019-07-10)

Improvements to JAMS

  • added dependencies to run under Java 9 and above

New JAMS Components

  • added support for R integration
  • added components for calculation of indicators (package jams.components.indices), e.g.
    • Indicators of Hydrological Alteration (IHA)
    • Various precipitation indicators including Standardized Precipitation Index (SPI)

 

Version 3.9_03 (2018-07-14)

Improvements to JAMS Components

  • added/fixed components for simple artithmetics in jams.components.calc: DoubleAdd, DoubleSubstract, DoubleMultiply, DoubleDivide

Improvements to JAMS Worldwind

  • fixed a bug in Worldwind classifier
Version 3.9_00/01/02 (2018-06-11)

Improvements to JAMS Components

  • added new component jams.components.aggregate.LongTermAggregation for calculating long-term sums or averages
  • added new component jams.components.gui.CategoryPlot that creates a graphical plot of category data, e.g. to compare attributes of different model entities
  • added various components for SMDI/ETDI calculation (https://doi.org/10.1016/j.agrformet.2005.07.012)
  • added component jams.components.calc.EventCounter that allows counting the occurrence of certain states in a model (e.g. SMDI < -3.5)
  • fixed minor bug in jams.components.gui.CategoryPlot

Updated J2K example model

  • added components for long-term temporal aggregation and output
  • added components for Shapefile output of results
  • replaced efficiency calculation component by more versatile version
  • added category plots for efficiencies and water balance

Improvements to JAMS Optas

  • addeed optas.sampler.FileListSampler that allows sampling over a list of given parameter values read from a file
  • fixed minor bug in Efficiency Configurator

Improvements to JAMS Main

  • added option to use minutely time steps

 

Version 3.8_00 (2017-06-24)

Improvements to JAMS OPTAS

fixed functionality for assisted configuration of model efficiency calculation. For a detailed description, have a look at the new Efficiency Calculation article.

Efficiency configuration dialog
Version 3.7_00 (2017-05-05)

New and updated components

added components to calculate Soil Moisture Deficit Index (SMDI) and Evapotranspiration Deficit Index (ETDI) (see jams.components.indices in jams-components library)

added function to output the impact of indivudual stations within the Inverse Distance Weighting (IDW) regionalization approach, e.g. as XY-plot or as map

Minor bug fixes

  • fixed GUI errrors in WorldWind
  • fixed GUI error in Data Explorer (JADE)
Version 3.6_00 (2017-03-27)

Improvements in the WorldWind data viewer:

  • auto-play function to visualize time-series with given time delay
JAMS WorldWind
Version 3.5_00 (2017-03-06)

Improvements in the JAMS data I/O & Data Explorer (JADE):

  • functions to define decimal places in table views (see JAMS preferences)
  • J2K input datastores can use english date/time formats

Improvements in the JAMS Cloud client:

  • display of job progress
Version 3.4_00 (2016-11-14)

Improvements in the JAMS Model Builder (JUICE):

  • functions for remote simulation including
    • running models on remote servers
    • browsing remote workspaces/jobs
    • synchronizing remote and local workspaces

Improvements in the JAMS Data Explorer (JADE):

  • functions for easily transferring parameter optimization results to models
Version 3.2_00 (2016-08-19)

Improvements in the JAMS Model Builder (JUICE):

  • display of component attribute default values, units and descriptions

Added components to the jams-components repository:

  • component for performing Empirical Mode Decomposition (EMD) on time series data (jams.components.analysis.EMD)
  • component that applies Local Kriging for spatial data interpolation using JGrassGears library (jams.components.interpolation.RegionalisationLocalKriging)
Version 3.1_00 (2016-06-03)

This version brings some new features for the JAMS Data Explorer (JADE):

  • new filter function for time step selection
  • improved aggregator options
  • area weighting also for cross-product calculation
  • better copy/paste support for spreadsheet data

For the WorldWind viewer, the following functions were added:

  • area weighting / unit conversion for data to be visualized
  • improved opacity control for polygon outlines (including complete removal of outlines)
  • detailed information for individual entities with time-series plotting function
Version 3.0_03 (2016-05-17)

Minor updates:

  • updated WorldWind libraries for better performance
  • fixed minor bug in aggregation functions for spatio-temporal output datastores
  • fixed bug in TemporalSumAggregator (month filters)
  • Added MODIS ET reader components that allow to use MODIS global terrestrial evapotranspiration data for hydrological modelling
  • updated Netbeans projects, build scripts and starter scripts
  • improved installer with Java version check
Version 3.0_02 (2016-02-10)

Minor bug fix

  • fixed incompatibility problem with older output datastores
Version 3.0_01 (2016-02-08)

Minor changes in component package structure

  • moved core components Context, TemporalContext and SpatialContext to jams-components.jar library (package jams.components.core)
  • added function to automatically adapt existing models to reflect these changes
  • fixed minor issues in documentation generator
  • minor improvements in JAMS Builder GUI
Version 3.0b26 (2015-11-13)

JAMS file association

When using the automatic Windows installer, JAMS model files (*.jam) are automatically associated to the JAMS Launcher, allowing to quickly load a model by double-clicking the file.

Separation of JAMS platform libraries and component libraries

JAMS platform libraries are now strictly separated from component libraries. This is reflected by a new sub-directory named components within your JAMS installation which by default includes all your component libraries. Of course, it is still possible to include component libraries from every directory on your computer by defining individual library locations in your JAMS settings.