Skip to contents

PEcAn.uncertainty 1.9.0.9000

  • generate_joint_ensemble_design(sobol = TRUE) now errors when an input is sampled by "looping" or parameters by "halton" or "sobol". These split into dependent X1 and X2 halves and gave wrong Sobol indices (#4134).
  • In run.sensitivity.analysis(), load samples once before the variables loop, avoiding repeated disk reads (#3859).
  • get.ensemble.samples() now again returns a list of dataframes as it did before v1.9.0. The returned list also now has attribute sampled.indices, giving the position of each sampled value in its input set (#4127, @Devansh-56)
  • get.results() reads sensitivity output only for the PFTs that have runs in sa.run.ids, so PFTs not at a site no longer give a warning per trait and quantile.
  • read.sa.output() now reads only the runs in sa.run.ids, so each site of a multisite sensitivity analysis gets its own results. Previously every site read the last site’s runs from the shared runs_manifest.csv.
  • run.sensitivity.analysis() skips traits with no spread in their SA samples, with a warning. Previously one such trait stopped the analysis for every PFT.
  • runs_manifest.csv now has a column ens_num to distinguish ensemble members without reparsing run IDs.
  • run.sensitivity.analysis() no longer converts traits in Celsius (e.g. psnTOpt) to K before evaluating their splines, which are fit in Celsius. Their sensitivity, elasticity and variance were wrong in earlier versions, and so were the partial variances of the other traits in the PFT. CV and elasticity are still computed in K.
  • Multiple bugfixes in input.ens.gen() handling of parent ids (#3783):
    • No longer skips inputs that have a parent but no sampling method.
    • Argument parent_ids now accepts integer vectors even if not wrapped in a list.
    • New argument bad_parent_action chooses how to handle parent ids that do not match an input path: default “error” to stop with an error, “resample” to replace invalid indices from the input paths that do exist.
  • run.ensemble.analysis() now respects settings$modeloutdir rather than assuming an out/ folder inside settings$outdir (@Akash-paluvai, #3722).
  • Added generate_OAT_SA_design() for creating input design matrices for sensitivity analysis. This function ensures non-parameter inputs (met, IC, soil) are held constant, which is required for valid variance decomposition in one-at-a-time (OAT) sensitivity analysis (#3729)
  • get.parameter.samples() now consistently accepts PFTs with no outdir specified. These previously failed when no database connection was available.
  • Improved row alignment and text scaling in plot_variance_decomposition().
  • plot_variance_decomposition() gains argument order_by, sorting highest variance to the top by default. To reproduce old behavior, use order_by = "none".

PEcAn.uncertainty 1.9.0

License change

PEcAn.uncertainty is now distributed under the BSD 3-clause license instead of the NCSA Open Source license.

Added

  • Added the shared input_design matrix, generated via new funtion generate_joint_ensemble_design(), keeps parameter draws and sampled inputs aligned across run.write.configs(), write.ensemble.configs(), and write.sa.configs(). (@blesson-07, #3535, #3677).
  • New function compute_sobol_indices for use in global sensitivity analyses (@blesson-07, #3612).

Changed

  • Breaking: write.ensemble.configs gains new mandatory arguments input_design and ensemble.size, and removes argument samples. Note that input_design and ensemble.size are added to the beginning of the argument list, so calls passing defaults unnamed as the first arg will break (#3612, #3634).
  • Breaking: input.ens.gen gains new mandatory argument ensemble_size, added between the existing settings and input args.
  • Plotting sensitivity now makes less noise in the console and once again produces a one-page PDF as intended (#3560).
  • write.ensemble.configs and write.sa.configs now generate an ensemble id if one is not provided in a DB-free run (#3654). Runs with DB continue to always generate a new id. Note that multi-site runs with no id provided will now get a separate ensemble ID (and thus generate separate analyses) for each site.
  • Documented that runModule.run.sensitivity.analysis does not yet work with multisite settings. This will be fixed in a future release.
  • The default sampling method of get.ensemble.samples has changed from “uniform” to “random” (#3535).

PEcAn.uncertainty 1.8.1

  • write.ensemble.configs now respects argument write.to.db when settingsdatabasedatabasebetywriteisNULL(butifsettingswrite is NULL (but if settingsdatabasebetybetywrite is set, it still overrides write.to.db).
  • Roxygen fixes

PEcAn.uncertainty 1.8.0

  • Added an optional pfts argument to run.sensitivity.analysis() so that sensitivity analysis and variance decomposition can be run on a subset of PFTs defined in settings if desired (#3155).

PEcAn.uncertainty 1.7.2

  • Added a NEWS.md file to track changes to the package.