Demo 2 Quarto notebook tutorial for PEcAn uncertainty analysis

.gitignore

@@ -115,3 +115,6 @@ contrib/modellauncher/modellauncher
 # Ignore any folder named demo_outdir (Quarto notebook outputs)
 **/demo_outdir/
 dbfiles/
+**/temperate.coniferous/
+*.sensitivity.analysis.*.pdf
+*.variance.decomposition.*.pdf

CHANGELOG.md

@@ -30,6 +30,13 @@ section for the next release.
  - Support for inspecting and plotting NetCDF output variables within the notebook workflow.
 - added support for soil temperature, relative humidity, soil moisture, and PPFD downscaling to `met_temporal_downscale.Gaussian_ensemble`
 
+- New Quarto notebook tutorial for PEcAn uncertainty analysis (`documentation/tutorials/Demo_02_Uncertainty_Analysis/uncertainty.qmd`) (#3570)
+  - Complete workflow demonstration for ensemble and sensitivity analysis using PEcAn's programmatic interface
+  - Parameter customization sections for ensemble size, sampling methods, and sensitivity quantiles
+  - Comprehensive output interpretation guide explaining variance decomposition and parameter prioritization
+  - Model result visualization with run ID identification and ensemble analysis capabilities
+  - Session information for reproducibility and clear documentation of PEcAn's uncertainty analysis outputs
+
 ### Fixed
 
 - Fixed a bugs and BADM now process both single-site and multi-site settings, detecting the input structure and processing each site independently to generate the correct number of ensemble members per site.

CITATION.cff

@@ -122,6 +122,8 @@ authors:
     affiliation: Boston University Software & Application Innovation Lab(SAIL)
   - given-names: Akash BV
     affiliation: CMR Institute of Technology, Bengaluru
+  - given-names: Aritra Dey
+    affiliation: National Institute of Technology, Tiruchirappalli
 
 preferred-citation:
   type: article

documentation/tutorials/Demo_02_Uncertainty_Analysis/pecan.xml

@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<pecan>
+ <info>
+  <notes/>
+  <userid>-1</userid>
+  <username/>
+  <date>2025-06-19-15-34-01</date>
+ </info>
+ <outdir>demo_outdir</outdir>
+ <pfts>
+  <pft>
+   <name>temperate.coniferous</name>
+   <posterior.files>pft/temperate.coniferous/prior.distns.Rdata</posterior.files>
+   <outdir>pft/temperate.coniferous/pft/temperate.coniferous</outdir>
+  </pft>
+ </pfts> 
+ <ensemble>
+   <size>50</size>
+   <variable>NPP</variable>
+   <samplingspace>
+    <parameters>
+     <method>halton</method>
+    </parameters>
+   </samplingspace>
+   <start.year>2004</start.year>
+   <end.year>2004</end.year>
+  </ensemble>
+  <sensitivity.analysis>
+   <quantiles>
+    <sigma>-1</sigma>
+    <sigma>1</sigma>
+   </quantiles>
+   <variable>NPP</variable>
+   <start.year>2004</start.year>
+   <end.year>2004</end.year>
+  </sensitivity.analysis>
+ <model>
+  <type>SIPNET</type>
+  <revision>1.3.0</revision>
+  <delete.raw>FALSE</delete.raw>
+  <binary>demo_outdir/sipnet</binary>
+ </model>
+ <run>
+  <site>
+   <met.start>2004/01/01</met.start>
+   <met.end>2004/12/31</met.end>
+   <name>Niwot Ridge Forest/LTER NWT1 (US-NR1)</name>
+   <lat>40.0329</lat>
+   <lon>-105.546</lon>
+  </site>
+  <inputs>
+   <met>
+    <source>AmerifluxLBL</source>
+    <output>SIPNET</output>
+    <username>Aritra_2004</username>
+    <path>
+     <path1>dbfiles/AMF_US-NR1_BASE_HH_23-5.2004-01-01.2004-12-31.clim</path1>
+    </path>
+   </met>
+  </inputs>
+  <start.date>2004/01/01</start.date>
+  <end.date>2004/12/31</end.date>
+ </run>
+ <host>
+  <name>localhost</name>
+ </host>
+</pecan>