Icepack1.4.1

Icepack version 1.4.1 is being released with CICE6.5.1. This is a minor release update from the Icepack1.4.0 release from October, 2023. The only significant changes are two bug fixes in the ks units in the dEdd code and in the enthalpy calculation when temperature is adjusted. These could change answers for BL99 thermodynamics.

Major Changes

Bug fixes

• BL99 thermodyanics fixes. Correct ks units in dEdd code. Update enthalpy calculation when temperature is adjusted, Could change answers for BL99 thermodynamics. #476

Enhancements

• Update usage of optional argument wlat in lateral_melt in icepack_therm_itd.F90. #477
• Update conda macos debug flags to avoid compiler issue with -ffpe-trap=invalid. #484
• Add gnuplot to the conda environment #483

Documentation

• Update Pull Request template to ask for additional information about PR. #484
• Add tutorial to User Guide as an Appendix. #485
• Update version and copyright. #486, #487

Icepack1.4.0

Icepack version 1.4.0 is being released with CICE6.5.0. This is a major release update from the Icepack1.3.4 release from September, 2023. This update includes the first of a series of updates to Icepack as a result of coupling into E3SM. Some of the interfaces have changed, some new parameters were added, the 5-band snicar shortwave feature was added, the frazil ice coupling was updated, and a bug was fixed lateral bottom melting term that doesn't impact science.

Major Changes

• Merge E3SM initial integration branch #460, #468, #469
  • update dEdd shortwave and snicar including new hardcoded lookup tables, 3-band and 5-band options, and support for 'dEdd_snicar_ad' as a shortwave option. Add NO_SNICARHC to turn off large hardcoded 5-band data table during compilation to save compilation time. That table is only needed with shortwave='dEdd_snicar_ad' when snw_ssp_table='snicar' but is included in compilation by default.
  • Update modal aerosols (Changes modal aerosol results in Icepack)
  • Update public interfaces (Impacts backward compatibility)
    • remove nspint public parameters
    • add icepack_init_radiation, icepack_salinity_profile, icepack_enthalpy_mush, icepack_warnings_getall
    • modify icepack_prep_radiation, remove scalar parameters (ncat, nilyr, nslyr)
    • modify icepack_step_radiation, remove scalar parameters (ncat, nblyr, nilyr, nslyr, dEdd_algae, calendar_type, days_per_year, nextsw_cday, modal_aero), remove snicar table data arguments
    • add Tf argument to icepack_compute_tracers, icepack_aggregate, icepack_step_ridge,
  • Update icepack parameters, add hi_min, Tliquidus_max, snw_ssp_table, 'dEdd_snicar_ad' option to shortwave, 'constant' to tfrz_option
  • Update the Tf implementation to make values internally consistent. Remove hardcoded Tocnfrz in a couple places, add tfrz_option='constant' which sets Tf to Tocnfrz. (Changes answers in some cases, can also change the value of temp in restart at non-ice gridcells even though the ice state is identical)
  • Modify iDin computation in subroutine compute_microS_mushy
  • Fix fhtan computation in compute_albedos
  • Refactor internal subroutine arguments to leverage module data more
  • Rename orbital interfaces from shr_orb to icepack_orb to more clearly differentiate internal and external versions
  • Update some optional argument handling
  • Clean up Icepack driver namelist logging

Bug fixes

• Fix bug in frzmlt_bottom_lateral to limit the amount of heat available for melting #474

Enhancements

• Generalize the logic for coupling frazil ice. Add namelist cpl_frazil and add update_ocn_f to icepack_parameters. #458
• Update the implementation of the rsnw interpolation in dEdd shortwave code, add new methods shortwave_search, add support for 5-band test data, and update the 5-band interpolation to be linear (Non-climate answer changing for shortwave='dEdd_snicar_ad', passes QC) #472
• Add icepack parameter tscale_pnd_drain, sets the timescale (in days) for macroscopic drainage when using mushy thermodynamics. #462
• Update picard_nonconvergence diagnostics #464
• Add readthedocs yaml for documentation building #466
• Remove unncessary call to icepack_recompute_constants in icepack_query_parameters #465
• Port to Perlmutter #467
• Update Derecho inputdata path #471
• Fix script bug in icepack.launch.csh #475

Documentation

• Update version #473
• Update documentation #460, #466, #470, #473

Icepack1.3.4

Icepack version 1.3.4 is being released with CICE6.4.2. This is a minor release update from the Icepack1.3.3 release from December, 2022. This update includes several bug fixes including in snow physics, FSD lateral melt, and treatment of thin ice/snow enthalpy. It also includes improvements to the treatment of optional arguments in the public interfaces, capability for netcdf restart files, and other enhancements.

Bug fixes

• Correct thin ice/snow treatment of enthalpy and other tracers. #454. This changes answers in CICE (QC passes) but not Icepack
• Fix ice area inconsistency under convergence in single column mode #433. This changes answers in standalone Icepack but not in CICE.
• Fix bug in snow sublimation in icepack_therm_vertical #428. Fix bug in smicen and smliqn calculation in thermo_vertical #449. This changes answers for snwgrain configurations.
• Update the FSD lateral heat flux computation and fix bug in the welding scheme. #424 #435 This changes answers for FSD configurations.
• Fix bug in history file output related to FSD. #421. This does not change model results.
• Fix bug in start time for netCDF history output #426. This does not change model results.
• Update hsn_new(1) computation in snow_redist. This does not change model results.

Enhancements

• Update snow physics logic control #449
• Refactor implementation of optional arguments for isotopes, snwgrain, therm1 and therm2 as well as some optional outputs in Icepack public interfaces #423, #429. Update FSD arguments, convert them to optional #440. Clean up optional argument attributes and update optional argument documentation #443.
• Add icepack_chkoptargflag function #423, #434
• Add support for netCDF restart files, update history and restart format control #427
• Deprecate zsalinity #448
• Remove ridging iteration log output #445, #446
• Check allocation of snow aging tables better #428
• Clean up some intent statements, clean up public interface declarations #429
• Shift a few left-over print statements to use the icepack warning infrastructure #424
• Add support for netCDF with conda_linux #425
• Update icepack_write_parameters and add call in Icepack #436
• Update ports to Onyx, Derecho, Cheyenne, Chicoma #442, #449, #456

Documentation

• Update version, License, Copyright date #457
• Explicitly turn on pdf generation in readthedocs #438
• Updates needed for compatibility with changes in readthedocs #432
• Update documentation #427, #429, #433, #435, #437, #440, #443, #448, #457

Icepack1.3.3

Icepack version 1.3.3 is being released with CICE6.4.1. This is a minor release update from the Icepack1.3.2 release in August, 2022. This update includes several bug fixes including to the dEdd implementation for modal aerosols and the snow grain implementation. It adds some new features including the saltflux_option. It also deprecates the zsalinity feature using preprocessor flags to enable the changes to be more easily reversed. Please contact the CICE Consortium with any concerns regarding deprecated code. We will consider keeping it.

Bug fixes

• Fix bugs in dEdd implementation including missing g/w0/tau calculation after "aerosol in snow" and bug in computation of modal aerosol taer/waer/gaer by fixing multiply of nilyr and nslyr. THIS CHANGES ANSWERS for tr_aero and modal aerosols #400
• Fix bugs in snow grain radius, corrects the magnitude of a parameter controlling wet metamorphosis of snow THIS CHANGES ANSWERS for snwgrain cases #415
• Fix brine volume conservation check #415

Enhancements

• Refactor computation of g/w0/tau, get rid of use of puny THIS CHANGES ANSWERS but preserves climate #400
• Change some constants in dEdd to double precision THIS COULD CHANGE ANSWER but preserves climate #400
• Add saltflux_options constant and prognostic #418
• Add argcheck parameter, not yet used #397
• Rename configuration options so all lower case for improved scripts robustness #397
• Clean up unused variables and remove trailing blanks from several files #397
• Port to NCCS machine discover #398
• Add modal tests #400
• Update fsd test length #414
• Force IO unit closing on exit of Icepack to address a bug in MacOSX to ensure output is written fully #403
• Add checker in source code to Github Actions CI, we don't want tabs in the code #417
• Add warning for wave_spec_type='none' with FSD #409
• Final deprecation of 0-layer thermo and cesm meltponds #411
• Initial deprecation of zsalinity #413
• Remove trailing blank spaces #419

Documentation

• Correct Tair documentation in source code #399
• Update FSD documentation #405 #409
• Update documentation in general #406 #411
• Update interface documentation #419
• Update version to 1.3.4 #419

Icepack1.3.2

Icepack version 1.3.2 is being released with CICE6.4.0. This is a minor release update from the Icepack1.3.1 release in February, 2022. This update includes deprecation of both the 0-layer thermodynamics and the CESM melt ponds. In this version, the code is deprecated using preprocessor flags to enable the changes to be more easily reversed, if necessary. Please contact the CICE Consortium with any concerns regarding deprecated code. We will consider keeping it.

Major Changes

• Deprecate 0-layer thermodynamics #394
• Deprecate CESM melt ponds #393

Bug fixes

Enhancements

• Update machine files for cori #395

Documentation

• Update version #396
• Update documentation #396

Icepack1.3.1

Icepack version 1.3.1 is being released with CICE6.3.1. This is a minor release update from the Icepack1.3.0 release in September, 2021. This is a relatively minor update that addresses a few technical issues, fixes an issue in the computation of CDN_ocn, and updates the bulk formula options.

Major Changes

• None

Bug fixes

• Switch relative call location of frzmlt_bottom_lateral and neutral_drag_coeffs to compute valid CDN_ocn before being used, #381

Enhancements

• Update namelist reading to allow namelist groups to be read in any order #379, #382
• Fix output formatting to avoid conversion errors #378
• Add logical statement to avoid use of undefined values in meltsliq #376
• Update sensible and latent heat bulk formula options set by atmbndy_in. Valid values are similarity (aka default), mixed, and constant. Update documentation #371

Documentation

• Update documentation #374
• Update version and copyright #386, #387
• Update README.md to reflect change of default branch name from master to main in Github repository #374
• Update Roberts et al 2019 reference #372

Icepack1.3.0

Icepack version 1.3.0 is being released with CICE6.3.0. This is a major release update from the Icepack1.2.5 release in April, 2021. This release upgrades the snow physics significantly. It also adds primitive netcdf history files, supports staggered atmospheric levels, and allows ice/ocean drag to be computed from under-ice roughness.

Major Changes

• advanced snow physics #360

Bug fixes

Enhancements

• add primitive netcdf history capability #368
• support for staggered atmospheric levels #364
• update namelist reading to allow arbitrary order of namelist groups #369
• optionally compute dragio from under-ice roughness #366
• update .gitattributes #362
• machine ports #363, #367
• clean up continuation lines #365

Documentation

• update version number to 1.3.0 #370
• update documentation for conda package updates #369

Icepack1.2.5

Icepack version 1.2.5 is being released with CICE6.2.0. This is a minor release update from the Icepack1.2.4 release in December, 2020. This release fixes a minor bug in the zsaliniity implementation and updates some other features in small ways. The most significant update is a change in the default emissivity value to 0.985.

Bug fixes:

• Initialization of salinity in zsalinity parameterization #346

Enhancements:

• Move shortwave absorbed in negligible snow layers to surface. #355
• Add abort in ITD for rare case where (hicen_init(n+1) - hicen_init(n)) <= 0) #337
• Modify error tolerance for rare mush thermo failure. #352
• Adjust emissivity to 0.985, set default NBGCLYR=1. #348
• Add test for zsalinity parameterization #344
• Add automated Github Actions testing on Pull Requests and Pushes to master and releases #347, Update Github Actions script #359
• Update color references in test results script #359
• Update conda macos implementation #359
• Port to Compy #353, #356

Documentation:

• Update revision number and fix error in one reference #358
• Update documentation on addition diagnostic output. #331
• Update readthedocs requirements for bibtex #345
• Update copyright year #349 #350

Icepack1.2.4

Icepack version 1.2.4 is being released with CICE6.1.4. This is a minor release update from the Icepack1.2.3 release in August, 2020. This release fixes a couple of minor bugs in the floeshape setting and in the convergence criteria in the atmo_boundary_layer method. In addition, some namelist variables were added and moved between namelist groups.

Major changes:

Bug fixes:

• Remove duplicate definition of floeshape and set it to 0.66. Prior versions had it set to 0.666 in fsd and 0.66 outside fsd. This changes answers but only affect the results of the fsd cases. #342
• Fix bug in atmo_boundary_layer in the iteration of Z/L, ustar, tstar, and qstar. This may change results slightly and does so in some of the test cases. This fixes the convergence check. #341

Enhancements:

• Move sw_redist, sw_frac, sw_dtemp from the thermo namelist to the shortwave namelist in the icepack driver. Prior namelist files may not be backwards compatible. #343
• Add hfrazilmin and floediam variables to icepack_parameter settings and to the icepack driver. #342

Documentation:

• Fix ice strength documentation #336
• Fix journal reference #339
• Update sphinx requirements to fix a recent change (pushed directly to the release branch)

Icepack1.2.3

Icepack version 1.2.3 is being released with CICE6.1.3. This is a minor release update from the Icepack1.2.2 release in June, 2020. This release fixes a couple of minor bugs in the old aerosol scheme and in the snow melt term. It also revises the shortwave redistribution option and adds a few other features. Documentation was updated as well.

Major changes:

Bug fixes:

• Fix aerosol tracer bug #330. This fixes a bug in the old aerosol scheme (tr_aero). Some quantities were divided by aice and should not have been. This will changes answers for some configurations with tr_aero=.true.
• Fix snow melt bug #328. This fixes a bug in the thermodynamics. When the sea ice completely melts away, the final little bit of snow melt was not added to the melts array. This will probably change answers for most cases, but not science.

Enhancements:

• Update and Document C Preprocessor (CPP) flags. #329
• Add shortwave redistribution option including sw_redist, sw_frac, and sw_dtemp namelist. This could change answers, but proper namelist settings should recover bit-for-bit results. Users should review the new settings. Prior to this update, sw_redist was turned on automatically for (bl99) thermodynamics and turned off for mushy thermodynamics. By default, sw_redist is false (off) for all thermodynamics settings now. #326, #332
• Add fswthru as four components #320
• Add MACHINFO and ENVINFO #323
• Add lcov code coverage tool #324

Documentation:

• Update version number and interface documentation #335
• Update citation information #327
• Correct Pstar units #325
• General documentation updates