EEMS 13.0 Release Notes
Release Date: 2026-11-20 This is a beta release. Please report any issues to support.
Highlights
- New JSON model format — Every setting is saved to one
efdcplus.jnpmodel file. Oldefdc.inpmodels still open. EE13 doesn’t useefdc.inp, however EE will writeefdc.inpfor reference if you turn on Write Legacy Files in the Save dialog. - Flexible MPI domain decomposition — Full implementation of the MPI graph topology allows very flexible sub-domains that better balance work and optimize computational efficiency. Edit them by drawing cut lines on the Cell Map, or let the automatic planner place them. A work-based structured method is also available.
- New rendering engine — Runs 2DH, 3D, the Cell Map and Grid+, with a new Layer Manager panel, vector legends and faster 3D volumes.
- Keygen licensing — Online and offline activation, machine binding, check-ins and clock-rollback detection.
- Custom Tracers — Dye is renamed Custom Tracers and is far more robust: multiple classes, breakdown products, linkage to the water quality model, and taste and odor simulation.
- ChemFate — The Toxics module is renamed ChemFate.
- Water quality additions — Taste & Odor, daughter products, actinobacteria and N2 fixation.
- Point source boundary conditions — Flow boundary conditions are now point sources with much more flexibility, including mass loading for any constituent.
- New analysis tools — Model Statistics, mass balance from
EE_BC.OUT, and time-series extraction across several models. - Ship and AIS tools — Vessel-group fill and online ship update for propwash work.
EFDC+
New Features
JSON Model Input
- EFDC+ reads its model configuration from the JSON control file
efdcplus.jnp. Once a legacy model has been saved by EFDC+ Explorer 13,efdc.inpis no longer needed. - Point sources, withdrawal/return, open boundaries, hydraulic structures, propwash, MHK devices, vegetation classes, particle tracking, restart options and residual-transport contour controls are all read from the control file. The legacy
WQPSL.INP,MODDXDY.INPandsubset.inpinputs are no longer used.
MPI Graph Topology Domain Decomposition
- Full implementation of the MPI graph topology allows very flexible sub-domains of any shape, to better optimize computational efficiency and balance work across ranks. A new decomposition method in
decomp.jnp(cut_lines) reads the sub-domains defined with cut lines and seed cells in EFDC+ Explorer, and EFDC+ checks each sub-domain’s cell count against the file. The structured block decomposition remains the default. - Ghost-cell exchanges now use per-neighbour lists and non-blocking communication, so any sub-domain layout, including diagonal neighbours, exchanges directly.
EE_BC.OUTis now written for MPI runs, andEE_ARRAYS.OUTis gathered across sub-domains.
Custom Tracers
- The Dye module is renamed Custom Tracers, with multiple classes, each with its own decay, settling and rising, and volatilization.
- Benthic tracer classes linked to water-column classes, with benthic tracers held in the bed.
- Breakdown products — transformation between classes using stoichiometric ratios.
- Water quality linkage — custom tracers are linked to the water quality model, including daughter products of algae and zooplankton groups.
- Taste and odor — custom tracers can simulate taste and odor components.
ChemFate
- The Toxics module is renamed ChemFate, with its settings in the JSON control file and one consistent approach to initial conditions and restarts.
Water Quality and Biota
- Taste & Odor and daughter-product variables for algae and zooplankton groups.
- Actinobacteria, including benthic actinobacteria kinetics, POM limitation, and full diagenesis with benthic POC initial conditions.
- Water-column algae settle onto linked benthic algae (periphyton) groups. Adds benthic algae burial and a minimum depth for biota vertical migration.
- Zooplankton settling velocity, ingestion efficiency, and a minimum prey concentration for feeding that keeps the mass balance closed.
- Nitrogen fixation — a per-group
nitrogen_fixation_relative_growthinput lets cyanobacteria groups substitute N2 fixation for DIN uptake when nitrogen limits growth. Fixation follows light and temperature limits, the DO photosynthetic quotient accounts for the fixed share, andEE_ARRAYS.OUTreports fixation rates and cumulative totals per group. Groups without the input are unaffected. - Food chain model linkage, with a separate bed linkage frequency.
- Zero nitrogen and phosphorus half-saturation constants are now handled.
Mass-Loading Point Sources
- Flow boundary conditions are now point sources, which accept any combination of constant and time-varying concentrations. Any constituent time series can be given as a mass-loading series, including in multi-layer models. This replaces the legacy water quality point source loads (
WQPSL).
Withdrawal/Return
- Pumping rules for withdrawal/return pairs.
- Discharge modifier: a time series that increases (> 0) or reduces (< 0) the return flow, with a matching concentration modifier and a mass-balance or pass-through option for each constituent class group. The discharge modifier can now model desalination plant discharges.
Navigation Lock Fill/Drain Controller
- With dynamic lock flows on, EFDC+ computes each lock’s fill and drain flows so the water bodies on either side of a gate are level by the gate’s scheduled opening. Chambers are found from the gate layout, so parallel and branched locks work. Gate state comes from the control series, and the fill rate adapts to the time left before the gate opens.
- In testing, the mean head across a gate at opening fell from 0.108 m to 0.029 m, and runs were faster because gentler fills no longer collapse the dynamic time step. The rate-law constants can be tuned per run with
EFDC_LOCK_NTAU,EFDC_LOCK_RAMPFRACandEFDC_LOCK_TAUFLOOR, andEFDC_LOCK_TRACE=1writesLOCK_TRACE.CSV. - Lock setup, gate events and configuration errors are written to the run log. Lock parameters moved to the hydraulic structure groups.
3TL Dynamic Time Stepping
- 3TL dynamic time stepping now uses stability criteria, with a start-up ramp. Every step is a whole multiple of the minimum time step, and the current step is written out during the run.
No-Slip Walls
- New no-slip wall option for horizontal momentum diffusion, applied the same way at all four walls in both 2TL and 3TL, and on every MPI rank.
Bed Heat: Solar to Water
bed_heat_exchange.solar_to_waterputs the solar radiation that reaches the bed into the bottom water layer, so the bed exchanges heat with the water by conduction only. Requires surface heat exchange option 1 or 2. On by default for new models and off by default for legacy models.
Exact Restart Continuation
- Restart file version 1310 writes every value at full precision and adds a continuation section carrying the time-loop state, so a run restarted from its own restart file continues exactly. Continued runs keep the original run’s snapshot times and
EE_BC.OUTrecord layout. Restart files from earlier still work as before.
Water Balance Terms in EE_BC.OUT
EE_BC.OUTnow records the water removed by the wetting and drying scheme, the water exchanged with ice, and the rainfall and evaporation actually applied to the water (after ice cover, dry cells and available water are taken into account). With these terms, a water balance built from the file can close. The new records are written after the existing ones, so older readers are unaffected.
Keyboard Pause and Exit for MPI Runs
- MPI runs can now be paused, resumed and ended from the keyboard, as single-process runs could. A paused run sits idle.
Enhancements
- Partial face masks — enabled with
grid.partial_masks_enabled, with the mask count read fromlayermask.inp. The pressure gradient, turbulence and face metrics at a blocked face are now built on the open gap. The previous buoyancy force there was 2–3× too weak. North faces now match east faces, and 3TL blocked faces no longer go unstable. Results for masked models will change. - Open boundaries — a new open boundary structure with one cell list for pressure and concentration, reworked harmonic series, and open boundary groups. The running-average residual option now works, and open boundary flows in
EE_BC.OUTand SHOWVAL now match the volume actually moved. 3TL outflows were previously under-reported. - 2TL dynamic time stepping — the time step now reaches its maximum instead of settling one or two increments short. A safety factor outside (0, 1] stops the run at input, and step selection is consistent across MPI ranks.
- Horizontal momentum diffusion — 2TL and 3TL are now consistent, and the corner and cross terms no longer depend on how the grid is oriented. Near-wall results shift slightly in existing models.
- QUICKEST — turbulence advection uses the ULTIMATE limiter, transport uses the total outgoing Courant number, and parallelization switches between constituents and sub-domains depending on which is faster.
- Performance — buffered output, no auto-parallelization overhead, a properly multithreaded wave loop, faster model setup for MPI runs, and less frequent keyboard polling.
- Output timing — EE snapshots now land on their exact time step instead of drifting a step late through round-off. A high-frequency period no longer writes duplicate records, and the regular snapshot after a high-frequency period is kept. The regular snapshot interval is set in days.
- Run timing report — reports elapsed time and simulated days per hour of run time, with a new output-time line. The CPU-time lines were inaccurate with the current compiler and are removed. Time spent waiting on MPI is now reported under MPI communication.
- Input error reporting — error messages are no longer cut short, and a spatial input file that ends early now stops with a read error instead of crashing or silently assigning wrong values.
- Restarts — a restart can now be used after constituents have been turned off, or after sediment has been turned off. Bathymetry overwrite is now an on/off option.
- Sediment — spatially varying sediment bed initial conditions, settling velocities matched to the new settling functions, sediment organic fractions without diagenesis, and sediment diagenesis under MPI.
- Propwash —
pw_meshfiles can be disabled globally and are generated without sediment transport. Adds an MMSI check for ships, and missing data is checked only for active ships. - Light extinction — the heat and eutrophication models use the same background light extinction.
Bug Fixes
- Silica kinetics — settling from the layer above was counted once per silica algae group, and a stale term added spurious silica in every layer above the bed. In one test, domain-mean available silica rose from 2.34 to 5.65 mg/L over two days without the fix.
- Bottom stress with constant eddy viscosity — under OpenMP, bottom stress used an undefined value in constant-AV runs using the EFDC+ bottom drag. Results for these runs will change.
- Wave turbulence — the wave branch of the bottom and surface turbulence used the wrong cell’s velocity, wave turbulence was double counted in sediment transport, and other wave calculation errors were corrected.
- SGZ internal waves — buoyancy shears on sigma-zed grids used the previous step’s buoyancy, which could grow internal oscillations once the dynamic time step became large.
- QUICKEST on SGZ grids — the horizontal stencil could read layers below the bed as zero concentration, which led to spurious anti-diffusive corrections. The same fix applies to turbulence advection.
- Navigation lock gates — a gate closed at the start of the run never passed flow after it opened. Gates now also carry density-driven exchange.
- Evaporation — with computed evaporation (
IEVAP > 1),EE_WC.OUT, NetCDF and SHOWVAL reported the input evaporation instead of the computed one. Computed evaporation was also silently switched off whenever rainfall was on. - Bed temperature — a varying bed that started at 0 °C misaligned
EE_WC.OUT. The 3TL time advance in bed heat exchange is also fixed. - Ice — ice thickness no longer depends on the time step.
- Residual transport and WASP linkage — memory corruption when a model had more withdrawal/return cells than series, and 3TL runs averaging residuals one and a half times per step.
- NetCDF output — a file handle leaked on every snapshot, which crashed the run at exit and left daily files empty.
- MPI — open boundary results differed between single- and multi-domain runs,
EE_ARRAYS.OUTwas scrambled, a forced exit with drifters hung, and several inputs were not broadcast to all ranks. - EE_BC.OUT — a cell carrying several point sources wrote duplicate records, and an inflow moved to a deeper cell while its own cell was too shallow dropped out of the record.
- EE_ARRAYS.OUT — the latent and sensible heat flux labels were swapped.
- Wetting and drying under 3TL dynamic stepping — periodic checks could stop firing once the time step settled, leaving cells stuck dry.
- Open boundary concentrations — corrected for outgoing flows.
- SEDZLJ — out-of-range grain size and shear interpolation,
NSEDFLUME >= 2, maximum erosion rate, allocations, the top bed layer, and hot starts and restarts. SEDZLJ hot starts now also work on Linux. - Uninitialized variables — more global and local variables are now initialized.
Removed
- ICM linkage (
ISICM). - Water quality option
ISWQLVL = 0, which was untested. - The 3TL inflow-forecast dynamic stepping method, and the 3TL growth factor and increment inputs.
- Horizontal momentum diffusion options
ISHDMF5 and 6. Use the no-slip wall option instead. - Legacy two-layer momentum curvature corrections and the legacy
ISDRY < 0option.
Infrastructure
- Version bump from 12.5.1 to 13.0 across project files and version strings.
EFDC+ Explorer
New Features
JSON Model Format
- New JSON model format,
efdcplus.jnp. Every module, boundary and grid setting is saved in one JSON model file. Legacyefdc.inpmodels still open, and a model can open without anefdc.inpat all. - By default, EE13 no longer writes
efdc.inp,show.inp,bed.sdf,erate.sdf,WQPSLor the other legacy files, and the 8.5 and 13 save-format choices are gone. For comparison, the Save dialog has a Write Legacy Files option, off by default, that also writesefdc.inp.
Hydrodynamics and Numerical Options
- Coriolis effect in 2DH, plus a UI for spatially varying Coriolis (
ISCORV). - Turbulence Transport option.
- Non-slip wall option. Legacy HMD decks are migrated.
- Dynamic time stepping:
- 2TL dynamic step with a minimum time step
- 3TL reworked: only ramp-up iterations and the minimum and maximum time step remain. The max growth factor and time increment are removed
- Fixed step greyed out while dynamic stepping is on
- Run dialog shows a read-only timing summary
- Navigation lock Use Dynamic Flows option, with high-frequency snapshots at gate openings.
- Food Chain linkage, and very small linkage frequencies are allowed.
- Restart Flags UI and a reworked Restart form. Restarts are more flexible when modules are turned off.
Water Quality and Biota
- Taste & Odor variables for algae and zooplankton groups.
- Daughter products for algae and zooplankton, linked to dissolved or particulate tracers.
- Actinobacteria biota group, benthic linkage for vertical migration, and a Macrophyte or Benthic Algae group type.
- N2 fixation relative growth for biota groups.
- Mass-loading WQ point sources: concentration and mass-loading series per group, and temperature loading in J/day. This replaces legacy
WQPSL.
Custom Tracers
- Custom Tracers replace Dye:
- Multiple classes, with add, remove and rename
- Per-class types
- Volatilization and settling
- Linked benthic and water-column classes
- Initial-conditions form
- ng/L and g/m² units
- Interpolation-class form
SEDZLJ
- SEDZLJ maximum bed layer thickness. Effective diameter is in microns, with Core ID and a shear-stress header.
Boundary Conditions
- Combine Series dialog, driven by the selection, replaces Add/Subtract Series.
Grid+
- Grid+ accepts fractional (decimal) refinement factors.
- Grid+ imports
efdcplus.jnpgrids, exports an EFDC+ v13 model, and updates an existing v13 model’s grid in place.
MPI Domain Decomposition
- Cut-line decomposition editor on the Cell Map:
- Draw segmented cut lines, drag them, and snap them to banks
- Merge, detach and split sub-domains
- Seeds and island handling
- Live cell counts
- Saved to
decomp.jnp - Launch from the Run dialog
- Automatic decomposition planner. It balances work, uses a communication-boundary criterion, runs a levelling pass, and adds a Balance group to the dialog.
- Work-based structured decomposition with draggable dividers, and a picker to choose the method.
2DH, 2DV and 3D Views
- Link View syncs pan, zoom and cell selection across 2DH windows.
- Time Series at Cell and Vertical Profile at Cell in the 2DH right-click menu.
- Run-wide color range for 2DH surface layers.
- GeoTIFF export of 2DH surface layers.
- Text comments in 2DH and 3D views, and draggable boundary labels.
- Streamlets: animated streaming arrows on 2DH velocity vectors. Arrows can be colored by a field, and density and fade are adjustable. They have a legend entry.
- Boundary-condition flux layer in 2DH, with per-group control.
- Smooth interpolation contouring in 2DV, with despeckle, that honors thin barriers.
- Drag layers onto the 2DH map: point scatter, label files, Grid+ and maps.
Layer Manager
- New Layer Manager panel for 2DH, 3D and the Cell Map, with inline visibility and label toggles. It replaces the old layer control.
Analysis Tools
- Model Statistics: wet area, wet cell count, volume and average depth over time, with CSV export.
- Mass balance from
EE_BC.OUT, with progress and a Stop button. - Multi-model time-series extraction. Each plot entry reads its own model, there is a base-model dropdown, and the plot title names the models.
Change Log
- The Change Log shows every setting changed since the previous run, including changes saved with Save and Save As. Tracking starts from the model’s first run.
Propwash, Ships and AIS
- Fill Missing Fields by Vessel Group, using the White Paper estimators and an AIS vessel-type table.
- Online ship update from vesseltracker, including tug propeller particulars and an identity check.
- Propwash reporting.
pw_meshfiles are generated even without sediment transport, and high-frequency output comes from track output.
Licensing
- New licensing on Keygen
Notifications
- In-app notifications, with a Notification Center to search, filter and sort them.
Model Format and Project Files
- The full projection is saved in the model, including WKT for user-defined projections.
- New Project no longer copies files from the current folder. Restart files are copied instead of regenerated.
- New defaults:
- Restart version 1300
HMINfixed at the EFDC+ value, and its UI removedbathymetry_overwriteoffin_core1- High-frequency output off
Hydrodynamics and Numerical Options
- New and updated physics options:
- Evaporative losses
- Solar-radiation shading
- COARE surface heat exchange
- Groundwater
- QUICKEST
- External density gradient
- Density effects
- Horizontal turbulence defaults
- Wall-proximity functions
- Hydraulic structures reworked: groups, rating lookup table, equation number, name and mode, flow split, and time control at group level.
- Temperature and bed heat: new options,
solar_to_water, ice, and GOTM turbulence customization. - Opt-in merging of thin sigma-Z bottom layers.
- Constant or spatially varying initial conditions for salinity and temperature. Background light extinction comes from atmospheric
BACKE.
Water Quality and Biota
- Zooplankton gains settling velocity, ingestion efficiency and maximum ingestion rate.
- Benthic POC initial conditions, biota defaults from
biota_defaults.jnp, and growth-factor updates for POC and DO, crowding half-saturation, silica limitation and light at the bed. - Weight column for eutrophication time series. Zero- and first-order decay rates are no longer converted from per-day to per-second.
- Constant initial conditions now show in 2DH, reports and exports.
- QC on WQ series:
ICSERvalues can’t be negative, andASERandWSERtimes must increase.
ChemFate
- ChemFate (the renamed Toxics module):
- Atmospheric deposition
- Organic-carbon options (foc, POC flags)
- Volatilization settings
- Per-class bed and water initial conditions
- Partitioning aligned with EFDC+
- Particle-mixing options
- New tooltips
Sediment
- Sediment modules rebuilt: cohesive and non-cohesive, SEDZLJ, SedORG and fluid mud. They get new sediment-water initial conditions and a spatial POC fraction, and BedLoad moved under Sediment.
- Settling and diagenesis forms reworked. Specific volume honors each class’s specific gravity.
Boundary Conditions and Time Series
- Flow boundary conditions are renamed Point Source.
- Open-boundary harmonics reworked: amplitudes and phases per series, tidal constituents by forcing type, and face numbering that matches EFDC+.
- Withdrawal/Return form overhauled:
- Pump rules
- Controlling time series
- Discharge modifiers
- Mass-balance toggle
- Cells renamed pairs
- BC groups: unique default names, Duplicate Group, and a filter to show or hide BC types, with counts.
- Series editing: by-class and single-class series forms, a vegetation class grid, calendar and Julian conversion in Model Times, hardened date input, and forcing-tree plot menus with class submenus.
- A duplicate BC cell gives a warning, not an error. Rainfall minus evaporation shows in the Boundary Inflow/Outflow layer.
Grid, Grid+ and Coordinates
- Grid+ improvements:
- Cell map
- Full display-options dialog
- Selection highlight
- Titles, north arrow and scale bar styles saved in the project
- Its own window icon
- Version number that matches EE
- Multi-point path measurement in 2DH and Grid+.
- Conversion Utility converts cell I/J to X/Y, converts live, and is modeless. Import Grids honors the file’s projection.
- Coordinate systems reworked:
- Cartesian, UTM and hemisphere handling
- User-defined projections
- Conversions validated, and reverted on failure
- ESRI codes in the download dialog
- Station coordinates stay consistent through a projection conversion
- Grid dimension labels count active cells only, and Total Area displays better.
MPI Decomposition and Model Run
- Sub-domain display:
- Labels, legend, palettes and hover call-outs
- MPI Subdomain Boundaries layer in 2DH
- Decomposition kept on save and through grid transforms
- Run Options MPI group is read-only, and editing happens on the Cell Map
- Run settings:
- Core count computed dynamically
KMP_BLOCKTIME200OMP_PLACESorKMP_HW_SUBSET- MPI batch-file tuning
- stdin from
NUL, so pause works
- More pre-run checks, covering waves, wetting and drying, ice and other inputs. On load, EE warns when the control file and series files disagree, and when cells have no input record.
- The Run ID is tied to the run folder.
2D Views (2DH / 2DV)
- Contours and legends overhauled:
- Color bar settings moved into the Color Filling tab
- 2DV legends and gridlines
- Shift+[ and Shift+] font sizing
- Horizontal or vertical layout
- Grey backing box for low-contrast symbols
- Per-parameter display units and user-defined unit legends
- Animation: stop and pause, animate to file, output dates in the title, and timing across multiple models.
- Vectors and roses: a Show Color Ramp option, 2DV uses the 2DH vector dialog, rose borders, and direction towards as the default.
- Photo layer editing, a clearer Add New menu, graticule label placement, and Zoom and Pan cursors.
- Selection, measure and polyline tools: Clear Selection and point editing.
- 2DH layouts use the active model, missing models are reported, and Load Layout is hardened.
- Cell info shows L, I and J and syncs the selection. Sliver cells are ignored in most views and analyses. Show Text is separate from symbol visibility.
3D View and Rendering
- New OpenGL/Skia rendering engine behind 2DH, 3D, the Cell Map and Grid+. Legends and color bars are vector graphics that stay sharp at any resolution, and overlays draw on one shared stack.
- 3D improvements:
- Orbit camera that keeps the model framed when exaggeration changes
- Smooth-field volumes build 4–6× faster
- Face culling and transparency
- Sediment bed in the volume
- Arrow heads proportional to the arrow
- Identify reports velocity
- The Cell Map legend is a draggable overlay.
Analysis, Charts and Calibration
- Chart axes get round tick snapping, a shared settings panel, date pickers and a thousands separator. Charts draw faster, lines break at data gaps, and dense series are thinned.
- Calibration:
- One built-in style per role
- Relative layout paths
- Station dialog with I/J entry and a filter dropdown
- Vertical-profile time tolerance and date offset
- FFT plots show only the low-pass series
- Auto Generate layout settings
- High-frequency snapshots: Delete All, options kept for the session, and an improved high-frequency domain form.
- Tecplot export, Extract TS, L-Profile and View Options use the same parameter options panel.
- Reports reworked:
- Initial conditions by layer and class
- BC and series reports, including harmonics
- Propwash and restart
- Model Analysis report with EFDC+ version, density effects, masks and turbulence coefficients
Propwash, Ships and AIS
- Ships and tracks:
- Lat/long tracks converted to UTM automatically
- Track parameter fill and assign
- AIS Length, Width and Hull Depth columns
- Propeller spacing derived from count and diameter
- Duplicate-MMSI warning
- Update Selected Ship(s)
Layouts and User Interface
- App-wide SVG/Fluent icon system, a new app icon, and crisp disabled icons.
- Work logs: search, error and warning filters, and clickable URLs.
- Versioned F1 help catalog. Links open in the default browser.
- High-DPI scaling, accessibility objects on custom controls, and high-visibility scrollbars.
- Edit Input Files follows the active model. Ctrl-G and F2 shortcuts work more consistently.
Removed
- The GVC form and the External Divergence option.
- Station conversion in Project Settings › Convert.
- 3D flight-path animation.
- Generate DEM tool.
- VesselFinder as a ship-search source.
Other
- EE version bumped from 12.5.1 to 13.0.