SNOWPACK 20250312.08994956
DataClasses.h
Go to the documentation of this file.
1/*
2 * SNOWPACK stand-alone
3 *
4 * Copyright WSL Institute for Snow and Avalanche Research SLF, DAVOS, SWITZERLAND
5*/
6/* This file is part of Snowpack.
7 Snowpack is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
11
12 Snowpack is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with Snowpack. If not, see <http://www.gnu.org/licenses/>.
19*/
26#ifndef DATACLASSES_H
27#define DATACLASSES_H
28
32
33#include <snowpack/Constants.h>
34#include <meteoio/MeteoIO.h>
35
36#include <string>
37#include <vector>
38
40enum {
45};
46
48struct SNOW_OPTIC {
49 double ggg;
50 double exteff;
51 double ssa;
52};
53
55struct WL_STRUCT {
56 double nm;
57 double perc;
58};
59
66 public:
67 ZwischenData(): hoar24(48, 0.0), drift24(48, 0.0), hn3(144, 0.0), hn24(144, 0.0) {}
68 void reset();
69
70 friend std::ostream& operator<<(std::ostream& os, const ZwischenData& data);
71 friend std::istream& operator>>(std::istream& is, ZwischenData& data);
72
73 std::vector<double> hoar24;
74 std::vector<double> drift24;
75 std::vector<double> hn3;
76 std::vector<double> hn24;
77};
78
84 public:
86 CurrentMeteo(const SnowpackConfig& i_cfg);
87
88 void reset(const SnowpackConfig& i_cfg);
89 void setMeasTempParameters(const mio::MeteoData& md);
90 size_t getNumberMeasTemperatures() const;
91 size_t getNumberFixedRates() const;
92 size_t getMaxNumberMeasTemperatures() const;
93 void getFixedPositions(std::vector<double>& positions) const;
94 size_t getNumberFixedPositions() const;
95 void copySnowTemperatures(const mio::MeteoData& md, const unsigned int& current_slope);
96 void copySolutes(const mio::MeteoData& md, const size_t& i_number_of_solutes);
97
98 const std::string toString() const;
99 friend std::ostream& operator<<(std::ostream& os, const CurrentMeteo& data);
100 friend std::istream& operator>>(std::istream& is, CurrentMeteo& data);
101
102 mio::Date date;
103 double ta;
104 double rh;
105 double rh_avg;
106 double vw;
107 double vw_avg;
108 double vw_max;
109 double dw;
110 double vw_drift;
111 double dw_drift;
112 double ustar;
113 double z0;
114 double psi_s;
115 double iswr;
116 double rswr;
117 double mAlbedo;
118 double diff;
119 double dir_h;
120 double elev;
121 double ea;
122 double lw_net;
123 double tss;
124 double tss_a12h;
125 double tss_a24h;
126 double ts0;
127 double psum;
128 double psum_ph;
129 double psum_tech;
130 double hs;
131 double hs_a3h;
132 double hs_rate;
133 double geo_heat;
134 double adv_heat;
135
136 std::vector<double> ts;
137 std::vector<double> zv_ts;
138 std::vector<double> conc;
139 double rho_hn;
140 double rime_hn;
141 double lwc_hn;
142
143 bool poor_ea;
144
145 private:
146 size_t getNumberMeasTemperatures(const mio::MeteoData& md);
147
148 std::vector<double> fixedPositions;
149 double minDepthSubsurf;
150 size_t maxNumberMeasTemperatures;
151 size_t numberMeasTemperatures;
152 size_t numberFixedRates;
153};
154
162
164enum {
172
180
187 public:
188 LayerData();
189
190 const std::string toString() const;
191 friend std::ostream& operator<<(std::ostream& os, const LayerData& data);
192 friend std::istream& operator>>(std::istream& is, LayerData& data);
193
194 mio::Date depositionDate;
195 double hl;
196 size_t ne;
197 double tl;
198 double phiSoil;
199 double phiIce;
202 double phiWater;
204 double phiVoids;
205 std::vector<double> cSoil;
206 std::vector<double> cIce;
207 std::vector<double> cWater;
208 std::vector<double> cVoids;
209 double SoilRho;
210 double SoilK;
211 double SoilC;
212 double rg;
213 double sp;
214 double dd;
215 double rb;
216 unsigned short int mk;
217 double hr;
218 double CDot;
219 double metamo;
220 double salinity;
221 double h;
222 double dsm;
223};
224
231 public:
233 nLayers(0), Ldata(), HS_last(0.), Albedo(mio::IOUtils::nodata),
234 SoilAlb(mio::IOUtils::nodata), BareSoil_z0(mio::IOUtils::nodata),
235 Canopy_Height(mio::IOUtils::nodata), Canopy_LAI(mio::IOUtils::nodata),
236 Canopy_Direct_Throughfall(mio::IOUtils::nodata),
237 ErosionLevel(static_cast<int>(mio::IOUtils::nodata)), TimeCountDeltaHS(mio::IOUtils::nodata),
238 Canopy_BasalArea(mio::IOUtils::nodata), Canopy_diameter(mio::IOUtils::nodata),
239 Canopy_lai_frac_top_default(mio::IOUtils::nodata),Canopy_int_cap_snow(mio::IOUtils::nodata),
240 Canopy_alb_dry(mio::IOUtils::nodata),Canopy_alb_wet(mio::IOUtils::nodata),
241 Canopy_alb_snow(mio::IOUtils::nodata),Emissivity_soil(mio::IOUtils::nodata)
242 {}
243
244 const std::string toString() const;
245 friend std::ostream& operator<<(std::ostream& os, const SN_SNOWSOIL_DATA& data);
246 friend std::istream& operator>>(std::istream& is, SN_SNOWSOIL_DATA& data);
247
248 mio::StationData meta;
249 mio::Date profileDate;
250 size_t nN;
251 double Height;
252 size_t nLayers;
253 std::vector<LayerData> Ldata;
254 double HS_last;
256 double Albedo;
257 double SoilAlb;
258 double BareSoil_z0;
260 double Canopy_LAI;
269 double Canopy_alb_dry; // Albedo of dry canopy (calibr: 0.09, Alptal)
270 double Canopy_alb_wet; // Albedo of wet canopy (calibr: 0.09, Alptal)
271 double Canopy_alb_snow; // Albedo of snow covered albedo (calibr: 0.35, Alptal)
274
275
276};
277
285 public:
287 typedef enum YOUNG_MODULUS {
290 Exp
292
293 ElementData(const unsigned short int& in_ID);
294 ElementData(const ElementData& cc); //required to get the correct back-reference in vanGenuchten object
295 ElementData& operator=(const ElementData&) = default;
296
297 bool checkVolContent();
298 void heatCapacity();
299 double coldContent() const;
300 void updDensity();
301 double extinction() const;
304 static double snowResidualWaterContent(const double& theta_i);
305 double soilFieldCapacity() const;
306 double soilRelativeHumidity() const;
307
308 double snowElasticity() const;
309 double neckStressEnhancement() const;
310 double concaveNeckRadius() const;
311 double neckLength() const;
312 double neck2VolumetricStrain() const;
313
314 void snowType();
315 unsigned short int getSnowType() const;
316 static unsigned short int snowType(const double& dendricity, const double& sphericity, const double& grain_dia, const unsigned short int& marker,
317 const double& theta_w, const double& res_wat_cont_loc);
318 static double getYoungModule(const double& rho_slab, const Young_Modulus& model);
319
320 const std::string toString() const;
321 friend std::ostream& operator<<(std::ostream& os, const ElementData& data);
322 friend std::istream& operator>>(std::istream& is, ElementData& data);
323
324 mio::Date depositionDate;
325 double L0, L;
326 double Te;
327 double gradT;
329 std::vector<double> theta;
330 double h;
331 mio::Array2D<double> conc;
332 std::vector<double> k;
333 // Stored in order to visualize constitutive laws
334 // Will be used for creep field hydraulic conductivity in m3 s kg-1
335 std::vector<double> c;
336 // Will also be used for creep specific snow water capacity in m3 J-1
337 std::vector<double> soil;
338 double Rho;
339 double M;
340 double sw_abs;
341 // Snow Metamorphism Data
342 double rg;
343 double dd;
344 double sp;
345 double ogs;
346 double rb;
347 double N3;
348 size_t mk;
349 unsigned short int type;
350 double metamo;
351 double salinity;
352 double dth_w;
354 double Qmf;
355 double QIntmf;
356 double dEps, Eps, Eps_e, Eps_v;
358 double E;
359 double S;
360 double C;
361 double CDot;
362 double ps2rb;
363 double s_strength;
364 double hard;
365 double S_dr;
368 double lwc_source;
374 double Qph_up;
375 double Qph_down;
376 //NIED (H. Hirashima)
377 double dsm;
378 double rime;
379
380 unsigned short int ID;
381 static const unsigned short int noID;
382
383 double rhov;
384 double Qmm;
389};
390
392class NodeData {
393 public:
394 NodeData() : z(0.), u(0.), f(0.), udot(0.), T(0.), S_n(0.), S_s(0.), ssi(6.), hoar(0.),
395 dsm(0.), S_dsm(0.), Sigdsm(0.), rime(0.), water_flux(0.), rhov(0.) {} //HACK: set ssi to max_stability!
396
397 const std::string toString() const;
398 friend std::ostream& operator<<(std::ostream& os, const NodeData& data);
399 friend std::istream& operator>>(std::istream& is, NodeData& data);
400
401 double z;
402 double u;
403 double f;
404 double udot;
405 double T;
406 double S_n;
407 double S_s;
408 double ssi;
409 double hoar;
410
411 //NIED (H. Hirashima)
412 double dsm;
413 double S_dsm;
414 double Sigdsm;
415 double rime;
416
417 double water_flux;
418
419 double rhov;
420};
421
437 public:
443 can_ch0(0.), can_rs_mult(0.), rsmin(0.), f3_gd(0.), rootdepth(0.), wp_fraction(0.),
444 h_wilt(0.), storage(0.), temp(0.), sigf(0.), ec(0.), lai(0.), z0m(0.), z0h(0.), zdispl(0.),
445 height(0.), direct_throughfall(0.), ra(0.), rc(0.), rs(0.), rstransp(0.), canopyalb(0.),
446 totalalb(0.), wetfraction(0.), intcapacity(0.), rswrac(0.), iswrac(0.), rswrbc(0.), iswrbc(0.),
447 ilwrac(0.), rlwrac(0.), ilwrbc(0.), rlwrbc(0.), rsnet(0.), rlnet(0.), sensible(0.), latent(0.),
448 latentcorr(0.), transp(0.), intevap(0.), interception(0.), throughfall(0.), snowunload(0.),
449 snowfac(0.), rainfac(0.), liquidfraction(0.), sigftrunk(0.), Ttrunk(0.), CondFluxCanop(0.),
451 BasalArea(0.), HMLeaves(0.), HMTrunks(0.) {}
452
453 void initialize(const SN_SNOWSOIL_DATA& SSdata, const bool useCanopyModel, const bool isAlpine3D);
454 void reset(const bool& cumsum_mass);
456 void multiplyFluxes(const double& factor);
457
458 const std::string toString() const;
459 friend std::ostream& operator<<(std::ostream& os, const CanopyData& data);
460 friend std::istream& operator>>(std::istream& is, CanopyData& data);
461
471 double int_cap_snow; //iMax in Gouttevin,2015
479
481 double can_alb_dry; // Albedo of dry canopy (calibr: 0.09, Alptal)
482 double can_alb_wet; // Albedo of wet canopy (calibr: 0.09, Alptal)
483 double can_alb_snow; // Albedo of snow covered albedo (calibr: 0.35, Alptal)
484 double krnt_lai; // Radiation transmissivity parameter, in the range 0.4-0.8 if the true LAI is used; higher if optical LAI is used.
485 // (calibrated on Alptal)
486 double can_diameter; // average canopy (tree) diameter [m], parameter in the new radiation transfer model
489 double biomass_heat_capacity; // from Linroth et al., 2013 (J Kg-1 K-1)
490 double biomass_density; // from Linroth et al., 2013 (Kg m-3)
491 double lai_frac_top_default; // fraction of total LAI that is attributed to the uppermost layer. Here calibrated for Alptal.
492 double trunk_frac_height; // (optional) fraction of total tree height occupied by trunks,
493 // used to calculate direct solar insolation of trunks.
494 double trunkalb; // trunk albedo
495 double et; // trunk emissivity
509
515 double can_ch0;
520 double rsmin;
526 double f3_gd;
528 double rootdepth;
532 double h_wilt;
534
535 // State variable
536 double storage;
537 double temp;
538 double sigf;
539 double ec;
540 // parameters
541 double lai;
542 double z0m;
543 double z0h;
544 double zdispl;
545 double height;
547 // aerodynamic resistances
548 double ra;
549 double rc;
550 double rs;
551 double rstransp;
552 // Averaged variables
553 double canopyalb;
554 double totalalb;
555 double wetfraction;
556 double intcapacity;
557 // Radiations
558 double rswrac;
559 double iswrac;
560 double rswrbc;
561 double iswrbc;
562 double ilwrac;
563 double rlwrac;
564 double ilwrbc;
565 double rlwrbc;
566 double rsnet;
567 double rlnet;
568 // Turbulent fluxes
569 double sensible;
570 double latent;
572 // Evap fluxes
573 double transp;
574 double intevap;
575 // Mass fluxes
579
580 double snowfac;
581 double rainfac;
583 double sigftrunk;
584 double Ttrunk;
589 double QStrunks;
591 double BasalArea;
592 double HMLeaves;
593 double HMTrunks;
594};
595
602class SeaIce; // Foreward-declare sea ice class
604 public:
605 explicit SnowStation(const bool i_useCanopyModel=true, const bool i_useSoilLayers=true,
606 const bool i_isAlpine3D=false, const bool i_useSeaIceModule=false);
607 SnowStation(const SnowStation& c);
608
609 ~SnowStation();
611
612 void initialize(const SN_SNOWSOIL_DATA& SSdata, const size_t& i_sector);
613 void resize(const size_t& number_of_elements);
614
615 void reduceNumberOfElements(const size_t& rnE);
616 void combineElements(const size_t& number_top_elements, const bool& reduce_n_elements, const size_t& cond, const double& comb_thresh_l);
617 static bool combineCondition(const ElementData& Edata0, const ElementData& Edata1, const double& depth, const bool& reduce_n_elements, const double& comb_thresh_l);
618 static void mergeElements(ElementData& Edata0, const ElementData& Edata1, const bool& merge, const bool& topElement);
619 void splitElement(const size_t& e); //Split an element
620 void splitElements(const double& max_element_length, const double& comb_thresh_l); //Check for splitting, calls splitElement(...) for actual splitting
621
622 void compSnowpackMasses();
623 void compSnowpackInternalEnergyChange(const double& sn_dt);
624 void compSoilInternalEnergyChange(const double& sn_dt);
625 double getLiquidWaterIndex() const;
626 double getModelledTemperature(const double& z) const;
627 double getTotalLateralFlowSnow() const;
628 double getTotalLateralFlowSoil() const;
629 void resetSlopeParFlux();
630
631 size_t getNumberOfElements() const;
632 size_t getNumberOfNodes() const;
633 bool isGlacier(const bool& hydro=false) const;
634 bool hasSoilLayers() const;
635 double findMarkedReferenceLayer() const;
636
637 size_t find_tag(const size_t& tag) const;
638
639 void reset_water_fluxes();
640
641 const std::string toString() const;
642 friend std::ostream& operator<<(std::ostream& os, const SnowStation& data);
643 friend std::istream& operator>>(std::istream& is, SnowStation& data);
644
645 mio::StationData meta;
646 double cos_sl;
647 size_t sector;
648
651 double pAlbedo;
652 double Albedo;
653 double SoilAlb;
655 double BareSoil_z0;
656 size_t SoilNode;
657 double Ground;
658 double cH;
659 double mH;
660 double mass_sum;
661 double swe;
662 double lwc_sum;
665 double hn;
666 double rho_hn;
667 double rime_hn;
669 double ErosionMass;
670 char S_class1;
671 char S_class2;
672 double S_d;
673 double z_S_d;
674 double S_n;
675 double z_S_n;
676 double S_s;
677 double z_S_s;
678 double S_4;
679 double z_S_4;
680 double S_5;
681 double z_S_5;
682 std::vector<NodeData> Ndata;
683 std::vector<ElementData> Edata;
684 void *Kt;
685 double ColdContent;
687 double dIntEnergy;
691 double ReSolver_dt;
692 bool windward;
697 static const size_t number_top_elements;
698 static unsigned short number_of_solutes;
699
700 private:
701 size_t nNodes;
702 size_t nElems;
703 unsigned short int maxElementID;
704 bool useCanopyModel, useSoilLayers, isAlpine3D;
705 static double flexibleMaxElemLength(const double& depth, const double& comb_thresh_l);
706};
707
712
713 public:
714 BoundCond() : lw_out(0.), lw_net(0.), qs(0.), ql(0.), qr(0.), qg(Constants::undefined) {}
715 const std::string toString() const;
716 void reset();
717
718 double lw_out;
719 double lw_net;
720 double qs;
721 double ql;
722 double qr;
723 double qg;
724};
725
732 public:
755 };
756
757 const std::string toString() const;
758 friend std::ostream& operator<<(std::ostream& os, const SurfaceFluxes& data);
759 friend std::istream& operator>>(std::istream& is, SurfaceFluxes& data);
760
762
763 void reset(const bool& cumsum_mass);
764 void compSnowSoilHeatFlux(const SnowStation& Xdata);
765 void collectSurfaceFluxes(const BoundCond& Bdata, SnowStation& Xdata, const CurrentMeteo& Mdata);
766 void multiplyFluxes(const double& factor);
767
773 double lw_in;
774 double lw_out;
775 double lw_net;
776 double qs;
777 double ql;
778 double hoar;
779 double qr;
780 double qg;
781 double qg0;
782 double sw_hor;
783 double sw_in;
784 double sw_out;
785 double qw;
786 double sw_dir;
787 double sw_diff;
788 double pAlbedo;
789 double mAlbedo;
790 double dIntEnergy;
794
796 double drift;
797 std::vector<double> mass;
798 std::vector<double> load;
799 double dhs_corr;
800 double cRho_hn;
801 double mRho_hn;
802
803};
805
807//HACK: could it be moved to plugins? (as well as Aggregate)
809 public:
811
812 void average(const double& w1, const double& w2, const SnowProfileLayer& Pdata);
813 static std::vector<SnowProfileLayer> generateProfile(const mio::Date& dateOfProfile, const SnowStation& Xdata, const double hoar_density_surf, const double hoar_min_size_surf);
814
815 // Profile meta data
816 mio::Date profileDate;
817 std::string stationname;
818 unsigned char loc_for_snow;
819 unsigned char loc_for_wind;
820
821 mio::Date depositionDate;
822 double height;
823 double rho;
824 double T;
825 double gradT;
827 double theta_i;
828 double theta_w;
829 double theta_a;
830 double grain_size;
831 double bond_size;
832 double dendricity;
833 double sphericity;
834 double ogs;
835 double coordin_num;
836 unsigned short int marker;
837 short unsigned int type;
838 double hard;
839
840 private:
841 void generateLayer(const ElementData& Edata, const NodeData& Ndata);
842 void generateLayer(const ElementData& Edata, const NodeData& Ndata,
843 const mio::Date& dateOfProfile, const double hoar_density_surf);
844};
845
847class RunInfo {
848 public:
849 RunInfo();
850 RunInfo(const RunInfo& orig);
851 RunInfo& operator=(const RunInfo&) {return *this;} //everything is static, so we can not change anything
852
853 const std::string version;
854 const double version_num;
855 const mio::Date computation_date;
856 const std::string compilation_date;
857 const std::string user;
858 const std::string hostname;
859
860 private:
861 static double getNumericVersion(std::string version_str);
862 static mio::Date getRunDate();
863 static std::string getCompilationDate();
864};
865
866#endif
@ SOLID
Solid.
Definition: DataClasses.h:41
@ GAS
Gas.
Definition: DataClasses.h:43
@ LIQUID
Liquid.
Definition: DataClasses.h:42
@ NUMBER_OF_PHASES
Definition: DataClasses.h:44
SN_SOIL_DATA
The different soil fields (PERMAFROST)
Definition: DataClasses.h:174
@ SOIL_RHO
Bulk density of dry soil component (without accounting for porosity)
Definition: DataClasses.h:175
@ SOIL_C
Specific heat of dry soil component.
Definition: DataClasses.h:177
@ SOIL_K
Bulk conductivity of dry soil component.
Definition: DataClasses.h:176
@ N_SOIL_FIELDS
Definition: DataClasses.h:178
SN_FIELD
The 3 mathematical fields that can be solved.
Definition: DataClasses.h:156
@ SEEPAGE
Water transport.
Definition: DataClasses.h:158
@ N_SN_FIELDS
Definition: DataClasses.h:160
@ TEMPERATURE
Temperature (phase change and metamorphism)
Definition: DataClasses.h:157
@ SETTLEMENT
Creep displacements.
Definition: DataClasses.h:159
@ AIR
Air.
Definition: DataClasses.h:169
@ WATER_PREF
Water in preferential flow.
Definition: DataClasses.h:168
@ SOIL
Soil.
Definition: DataClasses.h:165
@ ICE
Ice.
Definition: DataClasses.h:166
@ N_COMPONENTS
Definition: DataClasses.h:170
@ WATER
Water.
Definition: DataClasses.h:167
BoundCond is used to set Neumann boundary conditions.
Definition: DataClasses.h:711
double qs
sensible heat
Definition: DataClasses.h:720
double qg
geothermal heat flux or heat flux at lower boundary
Definition: DataClasses.h:723
double ql
latent heat
Definition: DataClasses.h:721
BoundCond()
Definition: DataClasses.h:714
double lw_out
outgoing longwave radiation
Definition: DataClasses.h:718
const std::string toString() const
Definition: DataClasses.cc:272
double qr
rain energy
Definition: DataClasses.h:722
double lw_net
net longwave radiation
Definition: DataClasses.h:719
void reset()
Definition: DataClasses.cc:282
Canopy data used as a pointer in the SnowStation structure.
Definition: DataClasses.h:436
double wp_fraction
Wilting point, defined as a fraction of water content at field capacity (-)
Definition: DataClasses.h:530
CanopyData()
Definition: DataClasses.h:438
double wetfraction
fraction of canopy covered by interception [-]
Definition: DataClasses.h:555
double intcapacity
maximum interception storage [mm]
Definition: DataClasses.h:556
double rc
from canopy to canopy air
Definition: DataClasses.h:549
double f3_gd
gd (Pa-1) parameter for canopy surface resistance response to vapour pressure:
Definition: DataClasses.h:526
double sigftrunk
radiation interception cross section for trunk layer ()
Definition: DataClasses.h:583
double latentcorr
Definition: DataClasses.h:571
double LWnet_Trunks
net LW to trunks (>0 towards trunks)
Definition: DataClasses.h:587
double rswrac
upward shortwave above canopy
Definition: DataClasses.h:558
double rlnet
net longwave radiation
Definition: DataClasses.h:567
double snowfac
snowfall above canopy
Definition: DataClasses.h:580
double CondFluxTrunks
biomass heat storage flux towards Trunks (if 2L)
Definition: DataClasses.h:586
friend std::istream & operator>>(std::istream &is, CanopyData &data)
Definition: DataClasses.cc:920
double height
Definition: DataClasses.h:545
double CondFluxCanop
biomass heat storage flux towards Canopy (if 1L) towards Leaves (if 2L). (>0 towards canopy)
Definition: DataClasses.h:585
double can_alb_snow
Definition: DataClasses.h:483
bool canopy_stabilitycorrection
Definition: DataClasses.h:498
double krnt_lai
Definition: DataClasses.h:484
double zdispl
Definition: DataClasses.h:544
double totalalb
total albedo above canopy and snow/soil surface [-]
Definition: DataClasses.h:554
double iswrbc
downward shortwave radiation below canopy
Definition: DataClasses.h:561
double transp
Definition: DataClasses.h:573
double can_rs_mult
1+CAN_RS_MULT = maximum factor to increase Cdata->rs below canopy
Definition: DataClasses.h:517
double rswrbc
upward shortwave below canopy
Definition: DataClasses.h:560
const std::string toString() const
Definition: DataClasses.cc:1010
double rs
from subsurface to canpopy air
Definition: DataClasses.h:550
double rlwrbc
upward longwave radiation BELOW canopy
Definition: DataClasses.h:565
void multiplyFluxes(const double &factor)
If multiple fluxes have been summed over multiple time steps, the fluxes then need to be averaged by ...
Definition: DataClasses.cc:801
double trunkalb
Definition: DataClasses.h:494
double rsmin
TRANSPIRATION.
Definition: DataClasses.h:520
double ra
from canopy air to reference height
Definition: DataClasses.h:548
double SWnet_Trunks
net SW to trunks (>0 towards trunks)
Definition: DataClasses.h:588
double rstransp
stomatal surface resistance for transpiration
Definition: DataClasses.h:551
void reset(const bool &cumsum_mass)
Definition: DataClasses.cc:761
double biomass_heat_capacity
Definition: DataClasses.h:489
double HMTrunks
Trunks heat mass (J K-1 /m2 ground surface)
Definition: DataClasses.h:593
double interception_timecoef
Definition: DataClasses.h:478
double z0m
Definition: DataClasses.h:542
double rsnet
net shortwave radiation
Definition: DataClasses.h:566
double interception
Definition: DataClasses.h:576
double lai
Definition: DataClasses.h:541
double can_alb_dry
RADIATION BALANCE.
Definition: DataClasses.h:481
double can_ch0
minimum heat exchange (Wm-2K-1) at zero wind
Definition: DataClasses.h:515
double ilwrbc
downward longwave radiation BELOW canopy
Definition: DataClasses.h:564
double BasalArea
basal area of trees on the stand
Definition: DataClasses.h:591
double direct_throughfall
Definition: DataClasses.h:546
double lai_frac_top_default
Definition: DataClasses.h:491
double biomass_density
Definition: DataClasses.h:490
double latent
Definition: DataClasses.h:570
void initializeSurfaceExchangeData()
Function called to initialize the canopy "Surface" exchange data (to enable accumulated mass and ener...
Definition: DataClasses.cc:1107
double HMLeaves
Leaves heat mass (J K-1 /m2 ground surface)
Definition: DataClasses.h:592
double can_alb_wet
Definition: DataClasses.h:482
void initialize(const SN_SNOWSOIL_DATA &SSdata, const bool useCanopyModel, const bool isAlpine3D)
Initialize all the CData elements value with values by default or with values read from the SNO file....
Definition: DataClasses.cc:548
double int_cap_rain
Specific interception capacity for rain (I_LAI) (mm/LAI)
Definition: DataClasses.h:473
double intevap
Definition: DataClasses.h:574
double iswrac
downward shortwave radiation above canopy
Definition: DataClasses.h:559
double roughmom_to_canopyheight_ratio
Ratio between canopy height and roughness length.
Definition: DataClasses.h:500
double rainfac
rainfall above canopy
Definition: DataClasses.h:581
double int_cap_snow
Definition: DataClasses.h:471
double temp
temperature (K)
Definition: DataClasses.h:537
double displ_to_canopyheight_ratio
As above for displacement height.
Definition: DataClasses.h:502
double storage
intercepted water (mm or kg m-2)
Definition: DataClasses.h:536
double h_wilt
Wilting point pressure head, when using Richards equation for soil.
Definition: DataClasses.h:532
double rootdepth
Root depth, determining the soil layers influenced by root water uptake.
Definition: DataClasses.h:528
double sigf
radiation transmissivity (1)
Definition: DataClasses.h:538
double rlwrac
upward longwave radiation ABOVE canopy
Definition: DataClasses.h:563
double liquidfraction
Definition: DataClasses.h:582
double snowunload
Definition: DataClasses.h:578
double roughheat_to_roughmom_ratio
(~=1, but Not allowed to be exactly 1)
Definition: DataClasses.h:513
double sensible
Definition: DataClasses.h:569
friend std::ostream & operator<<(std::ostream &os, const CanopyData &data)
Definition: DataClasses.cc:830
double trunk_frac_height
Definition: DataClasses.h:492
double ilwrac
downward longwave radiation ABOVE canopy
Definition: DataClasses.h:562
double Ttrunk
trunk temperature (K)
Definition: DataClasses.h:584
double forestfloor_alb
albedo of the forest floor
Definition: DataClasses.h:590
double QStrunks
sensible heat flux from trunks (>0 if heat lost from trunk)
Definition: DataClasses.h:589
double z0h
Definition: DataClasses.h:543
double canopytemp_maxchange_perhour
Maximum allowed canopy temperature change (K hr-1)
Definition: DataClasses.h:511
double ec
longwave emissivity (1)
Definition: DataClasses.h:539
double raincrease_snow
Definition: DataClasses.h:508
double can_diameter
Definition: DataClasses.h:486
double canopyalb
canopy albedo [-]
Definition: DataClasses.h:553
double throughfall
Definition: DataClasses.h:577
double et
Definition: DataClasses.h:495
CurrentMeteo is the class of interpolated meteo data for the current calculation time step It contai...
Definition: DataClasses.h:83
std::vector< double > conc
Solute concentrations in precipitation.
Definition: DataClasses.h:138
mio::Date date
Date of current meteo data.
Definition: DataClasses.h:102
double adv_heat
Advective heat to inject in the soil (if ADVECTIVE_HEAT and related parameters set to true)
Definition: DataClasses.h:134
void getFixedPositions(std::vector< double > &positions) const
Definition: DataClasses.cc:3169
void reset(const SnowpackConfig &i_cfg)
Definition: DataClasses.cc:3091
double vw
Wind velocity at snow station (m s-1)
Definition: DataClasses.h:106
size_t getNumberMeasTemperatures() const
Returns the number of measured snow/soil temperatures stored in MeteoData.
Definition: DataClasses.cc:3150
CurrentMeteo()
Definition: DataClasses.cc:3065
double rime_hn
riming index of new snow
Definition: DataClasses.h:140
const std::string toString() const
Definition: DataClasses.cc:3352
double lwc_hn
liquid water content of new snow
Definition: DataClasses.h:141
bool poor_ea
when ilwr has not been measured nor parametrized in good conditions, it could be redone later on
Definition: DataClasses.h:143
double z0
The roughness length computed in SnowDrift and also used later for the MeteoHeat fluxes (m)
Definition: DataClasses.h:113
double psum_ph
precipitation phase for the current timestep (between 0 and 1, 0 is fully solid while 1 is fully liqu...
Definition: DataClasses.h:128
double hs_rate
The rate of change in snow depth (m h-1)
Definition: DataClasses.h:132
double vw_max
Maximum wind velocity at snow station (m s-1)
Definition: DataClasses.h:108
double iswr
Incoming SHORTWAVE radiation (W m-2)
Definition: DataClasses.h:115
size_t getNumberFixedPositions() const
Definition: DataClasses.cc:3174
void setMeasTempParameters(const mio::MeteoData &md)
Definition: DataClasses.cc:3112
double rho_hn
Measured new snow density (kg m-3)
Definition: DataClasses.h:139
friend std::ostream & operator<<(std::ostream &os, const CurrentMeteo &data)
Definition: DataClasses.cc:3220
double ta
Air temperature (K)
Definition: DataClasses.h:103
double vw_avg
Running mean of wind velocity at snow station (m s-1)
Definition: DataClasses.h:107
double lw_net
Net longwave radiation (W m-2)
Definition: DataClasses.h:122
double dw
Wind direction at snow station (deg)
Definition: DataClasses.h:109
double tss_a24h
Snow surface temperature averaged over past 24 hours (K)
Definition: DataClasses.h:125
friend std::istream & operator>>(std::istream &is, CurrentMeteo &data)
Definition: DataClasses.cc:3284
double dw_drift
Wind direction of blowing and drifting snow (operational: wind ridge station)
Definition: DataClasses.h:111
double vw_drift
Wind velocity for blowing and drifting snow (operational: wind ridge station)
Definition: DataClasses.h:110
double psum
precipitation sum over the current timestep (mm)
Definition: DataClasses.h:127
double rswr
Reflected SHORTWAVE radiation (W m-2) divide this value by the ALBEDO to get iswr.
Definition: DataClasses.h:116
double diff
Diffuse radiation from the sky (W m-2)
Definition: DataClasses.h:118
double ustar
The friction velocity (m s-1) computed in mt_MicroMet() and also used later for the MeteoHeat fluxes.
Definition: DataClasses.h:112
std::vector< double > zv_ts
Positions of all measured snow or/and soil temperatures (m)
Definition: DataClasses.h:137
void copySnowTemperatures(const mio::MeteoData &md, const unsigned int &current_slope)
Definition: DataClasses.cc:3189
double psi_s
Stability correction for scalar heat fluxes.
Definition: DataClasses.h:114
double psum_tech
Equivalent precipitation water sum for technical snow over the current timestep (mm)
Definition: DataClasses.h:129
double hs_a3h
Snow depth averaged over 3 past hours.
Definition: DataClasses.h:131
double rh_avg
Running mean of relative humidity (1)
Definition: DataClasses.h:105
double tss_a12h
Snow surface temperature averaged over past 12 hours (K)
Definition: DataClasses.h:124
size_t getMaxNumberMeasTemperatures() const
Definition: DataClasses.cc:3184
double tss
Snow surface temperature (K)
Definition: DataClasses.h:123
double ea
Atmospheric emissivity (1)
Definition: DataClasses.h:121
double hs
The measured height of snow (m)
Definition: DataClasses.h:130
void copySolutes(const mio::MeteoData &md, const size_t &i_number_of_solutes)
Definition: DataClasses.cc:3206
double ts0
Bottom temperatures of snow/soil pack (K)
Definition: DataClasses.h:126
std::vector< double > ts
Measured snow or/and soil temperatures (K)
Definition: DataClasses.h:136
double rh
Relative humidity (% or 1)
Definition: DataClasses.h:104
double geo_heat
Geo heat flux (W/m^2), for the neumann lower boundary condition in the heat equation.
Definition: DataClasses.h:133
size_t getNumberFixedRates() const
Definition: DataClasses.cc:3179
double elev
Solar elevation to be used in Canopy.c (rad) => see also.
Definition: DataClasses.h:120
double mAlbedo
Measured snow albedo.
Definition: DataClasses.h:117
double dir_h
Horizontal direct radiation from the sky (W m-2)
Definition: DataClasses.h:119
ELEMENT DATA used as a pointer in the SnowStation structure NOTE on M below: this is the mass of an e...
Definition: DataClasses.h:284
double L
Original and present element thickness (m)
Definition: DataClasses.h:325
std::vector< double > c
For example, specific heat of TEMPERATURE field (J kg-1 K-1)
Definition: DataClasses.h:335
double salinity
bulk salinity (PSU, which is g/kg)
Definition: DataClasses.h:351
double Qph_down
Heat source/sink due to phase changes for the heat equation (W/m^3), at the lower node of the element...
Definition: DataClasses.h:375
double QIntmf
Apparent change in internal energy due to phase change (caused by difference in heat capacity of wate...
Definition: DataClasses.h:355
double neck2VolumetricStrain() const
Relates the neck strain to the global volumetric strain.
Definition: DataClasses.cc:1655
vanGenuchten VG
Van Genuchten Model for water retention.
Definition: DataClasses.h:367
double soilFieldCapacity() const
Field Capacity Soil is dependent on grain properties. This nice formulation is based on some tedious ...
Definition: DataClasses.cc:1541
double Te
mean element temperature (K)
Definition: DataClasses.h:326
double Qmf
Subsurface Melting & Freezing Data: change of energy due to phase changes (melt-freeze)
Definition: DataClasses.h:354
double CDot
Stress rate (Pa s-1), that is the overload change rate.
Definition: DataClasses.h:361
double Eps_e
Definition: DataClasses.h:356
unsigned short int getSnowType() const
Determine the type of snow First revisited by Fierz and Bellaire 2006 and 2007 TODO needs to be adap...
Definition: DataClasses.cc:1673
double S_dr
Stability Index based on deformation rate (Direct Action Avalanching)
Definition: DataClasses.h:365
double soilRelativeHumidity() const
soilRelativeHumidity
Definition: DataClasses.cc:1580
double coldContent() const
Computes cold content of an element, taking meltfreeze_tk as reference.
Definition: DataClasses.cc:1443
ElementData & operator=(const ElementData &)=default
Assignement operator.
double PrefFlowArea
Preferential flow path relative area (-)
Definition: DataClasses.h:369
double Eps_v
Total element strain (GREEN'S strains – TOTAL LAGRANGIAN FORMULATION): Eps_e is elastic and Eps_v is ...
Definition: DataClasses.h:356
double res_wat_cont
Residual water content.
Definition: DataClasses.h:353
double extinction() const
Density dependent extinction coefficient -> Michi's magic trick... out of his magic hat.
Definition: DataClasses.cc:1482
unsigned short int type
grain class
Definition: DataClasses.h:349
Young_Modulus
This enum provides names for possible Young's modulus calculations.
Definition: DataClasses.h:287
@ Pow
another power law
Definition: DataClasses.h:289
@ Exp
exponential law
Definition: DataClasses.h:290
@ Sigrist
Sigrist, 2006.
Definition: DataClasses.h:288
ElementData(const unsigned short int &in_ID)
Definition: DataClasses.cc:1147
double sw_abs
total absorbed shortwave radiation by the element (W m-2)
Definition: DataClasses.h:340
double theta_i_reservoir_cumul
Volumetric ice content in cumulated ice reservoir (1)
Definition: DataClasses.h:372
double M
the total mass of the element (kg m-2)
Definition: DataClasses.h:339
double vapTrans_fluxDiff
vapor dissusion flux in the case of vapor transport (W/m^2/s)
Definition: DataClasses.h:385
double vapTrans_underSaturationDegree
the degree of undersaturation, (rhov-rohv_sat)/rhov_sat (-)
Definition: DataClasses.h:388
double E
Young's modulus of elasticity (Pa)
Definition: DataClasses.h:358
double vapTrans_snowDenChangeRate
snow density change rate in the case of vapor transport (kg/m^3/s)
Definition: DataClasses.h:386
double metamo
keep track of metamorphism
Definition: DataClasses.h:350
double lwc_source
Source/sink term for Richards equation (m^3/m^3 / timestep)
Definition: DataClasses.h:368
double rb
grain bond radius (mm)
Definition: DataClasses.h:346
friend std::ostream & operator<<(std::ostream &os, const ElementData &data)
Definition: DataClasses.cc:1172
size_t mk
grain marker (history dependent)
Definition: DataClasses.h:348
unsigned short int ID
Element ID used to track elements.
Definition: DataClasses.h:380
double h
capillary pressure head (m)
Definition: DataClasses.h:330
std::vector< double > k
For example, heat conductivity of TEMPERATURE field (W m-1 K-1)
Definition: DataClasses.h:332
void snowType()
Definition: DataClasses.cc:1661
double rg
grain radius (mm)
Definition: DataClasses.h:342
double rhov
vapor density...(kg/m^3)
Definition: DataClasses.h:383
mio::Array2D< double > conc
Concentration for chemical constituents in (kg m-3)
Definition: DataClasses.h:331
double dsm
Dry snow metamorphism factor.
Definition: DataClasses.h:377
void heatCapacity()
Computes heat capacity of an element based on volumetric contents.
Definition: DataClasses.cc:1426
double hard
Parameterized hand hardness (1)
Definition: DataClasses.h:364
double gradT
temperature gradient over element (K m-1)
Definition: DataClasses.h:327
double meltfreeze_tk
melt/freeze temperature of layer (principally initialized as 0 degC, but enables possibility for free...
Definition: DataClasses.h:328
static double getYoungModule(const double &rho_slab, const Young_Modulus &model)
Definition: DataClasses.cc:1341
double theta_w_transfer
Volumetric content of water transferred from preferential flow to matrix domain (1)
Definition: DataClasses.h:370
double theta_i_reservoir
Volumetric ice content in ice reservoir (1)
Definition: DataClasses.h:371
std::vector< double > theta
volumetric contents: SOIL, ICE, WATER, WATER_PREF, AIR (1)
Definition: DataClasses.h:329
mio::Date depositionDate
Date of deposition.
Definition: DataClasses.h:324
friend std::istream & operator>>(std::istream &is, ElementData &data)
Definition: DataClasses.cc:1254
double s_strength
Parameterized snow shear strength (kPa)
Definition: DataClasses.h:363
double Qph_up
Heat source/sink due to phase changes for the heat equation (W/m^3), at the upper node of the element...
Definition: DataClasses.h:374
double S
Total Element Stress (Pa), S being the energy conjugate stress.
Definition: DataClasses.h:359
double ps2rb
proportion of grain bond growth due to pressure sintering (1)
Definition: DataClasses.h:362
double C
Total Element Stress (Pa), C being the real or the Cauchy stress, which is output.
Definition: DataClasses.h:360
double Eps_vDot
Total Strain Rate, elastic and viscous, respectively (s-1) (Simply, Eps/sn_dt)
Definition: DataClasses.h:357
double Eps_Dot
Definition: DataClasses.h:357
double N3
grain Coordination number (1)
Definition: DataClasses.h:347
double vapTrans_cumulativeDenChange
cumulative density change in the case of vapor transport (kg/m^3)
Definition: DataClasses.h:387
double Eps
Definition: DataClasses.h:356
double neckStressEnhancement() const
Computes the enhancement of hydrostatically applied stress (overburden) in the necks (or bonds)
Definition: DataClasses.cc:1615
double dth_w
Subsurface Melting & Freezing Data: change of water content.
Definition: DataClasses.h:352
double Rho
mean element density (or BULK density; kg m-3), that is, rho=M/V=sum( theta(i)*rho(i) )
Definition: DataClasses.h:338
double SlopeParFlux
Slope parallel flux (m^3/m^3 * m / timestep)
Definition: DataClasses.h:373
double neckLength() const
Computes the neck (or bond) length (mm)
Definition: DataClasses.cc:1644
void updDensity()
Updates element density.
Definition: DataClasses.cc:1452
double rime
Rime index.
Definition: DataClasses.h:378
double L0
Definition: DataClasses.h:325
double ogs
optical equivalent grain size (mm)
Definition: DataClasses.h:345
bool checkVolContent()
Check volumetric content.
Definition: DataClasses.cc:1369
void opticalEquivalentGrainSize()
Opical equivalent grain size CROCUS implementation as described in Vionnet et al.,...
Definition: DataClasses.cc:1468
static const unsigned short int noID
Definition: DataClasses.h:381
void snowResidualWaterContent()
Definition: DataClasses.cc:1490
std::vector< double > soil
Contains the heat conductivity, capacity and dry density of the soil (solid, non-ice) component phase...
Definition: DataClasses.h:337
double dd
snow dendricity: 0 = none, 1 = newsnow
Definition: DataClasses.h:343
double snowElasticity() const
SNOW ELASTICITY : This important routine was programmed by Marc Christen, who took it directly from M...
Definition: DataClasses.cc:1600
double crit_cut_length
Critical cut length (m)
Definition: DataClasses.h:366
const std::string toString() const
Definition: DataClasses.cc:1827
double sp
sphericity: 1 = round, 0 = angular
Definition: DataClasses.h:344
double concaveNeckRadius() const
A non-generic function to compute the concave neck radius (mm). It is assumed that the neck is bound...
Definition: DataClasses.cc:1629
double Qmm
Heat source/sink due to phase changes in the case of vapor transport (W/m^3)
Definition: DataClasses.h:384
double dEps
Definition: DataClasses.h:356
Parameters of the different layers of the snowpack.
Definition: DataClasses.h:186
double sp
Micro-structure : Sphericity.
Definition: DataClasses.h:213
double rg
Micro-structure : Grainsize in mm.
Definition: DataClasses.h:212
double phiIceReservoir
Volumetric ice reservoir content in %.
Definition: DataClasses.h:200
double salinity
bulk salinity (g/kg)
Definition: DataClasses.h:220
double phiVoids
Volumetric void content in %.
Definition: DataClasses.h:204
double phiSoil
Volumetric soil content in %.
Definition: DataClasses.h:198
double phiIce
Volumetric ice content in %.
Definition: DataClasses.h:199
double dsm
dry snow metamorphism factor
Definition: DataClasses.h:222
double h
capillary pressure head (m)
Definition: DataClasses.h:221
std::vector< double > cVoids
Solute concentrations in Air.
Definition: DataClasses.h:208
double CDot
Stress rate (Pa s-1), that is the LAST overload change rate.
Definition: DataClasses.h:218
mio::Date depositionDate
Date of deposition (mainly used for snow layers)
Definition: DataClasses.h:194
std::vector< double > cWater
Solute concentrations in Water.
Definition: DataClasses.h:207
double phiIceReservoirCumul
Volumetric cumulated ice reservoir content in %.
Definition: DataClasses.h:201
std::vector< double > cIce
Solute concentrations in Ice.
Definition: DataClasses.h:206
std::vector< double > cSoil
Solute concentrations in Soil.
Definition: DataClasses.h:205
double phiWaterPref
Volumetric preferential water content in %.
Definition: DataClasses.h:203
double metamo
keep track of metamorphism
Definition: DataClasses.h:219
const std::string toString() const
Definition: DataClasses.cc:3621
friend std::istream & operator>>(std::istream &is, LayerData &data)
Definition: DataClasses.cc:3569
double rb
Micro-structure : Bond Radius in mm.
Definition: DataClasses.h:215
double tl
Temperature at the top of the layer in K.
Definition: DataClasses.h:197
double hl
The thickness of the layer in m.
Definition: DataClasses.h:195
double hr
Surface hoar Mass in kg m-2.
Definition: DataClasses.h:217
double SoilC
Heat Capacity of soil.
Definition: DataClasses.h:211
double SoilK
Conductivity of soil.
Definition: DataClasses.h:210
friend std::ostream & operator<<(std::ostream &os, const LayerData &data)
Definition: DataClasses.cc:3521
double SoilRho
Density of soil in kg m-3.
Definition: DataClasses.h:209
LayerData()
Definition: DataClasses.cc:3513
double phiWater
Volumetric water content in %.
Definition: DataClasses.h:202
double dd
Micro-structure : Dendricity.
Definition: DataClasses.h:214
unsigned short int mk
Micro-structure : Marker.
Definition: DataClasses.h:216
size_t ne
Number of finite elements in the the layer (hl/ne defines elm. size)
Definition: DataClasses.h:196
NODAL DATA used as a pointer in the SnowStation structure.
Definition: DataClasses.h:392
double udot
downward creep velocity in m s-1
Definition: DataClasses.h:404
double rhov
nodal vapor density in kg/m^3
Definition: DataClasses.h:419
double Sigdsm
Definition: DataClasses.h:414
double S_n
Stability Index for natural avalanches.
Definition: DataClasses.h:406
double dsm
Dry snow metamorphism factor.
Definition: DataClasses.h:412
double S_s
Stability Index for skier triggered avalanches.
Definition: DataClasses.h:407
double hoar
Mass of surface hoar collected while node was exposed to surface.
Definition: DataClasses.h:409
friend std::ostream & operator<<(std::ostream &os, const NodeData &data)
Definition: DataClasses.cc:1850
NodeData()
Definition: DataClasses.h:394
double f
reaction or unbalanced forces (CREEP)
Definition: DataClasses.h:403
double u
creep displacements in m
Definition: DataClasses.h:402
double ssi
Structural Stability Index.
Definition: DataClasses.h:408
double T
nodal temperature in K
Definition: DataClasses.h:405
const std::string toString() const
Definition: DataClasses.cc:1890
friend std::istream & operator>>(std::istream &is, NodeData &data)
Definition: DataClasses.cc:1870
double water_flux
Water flowing through the node (kg/m2). Positive values denote downward fluxes.
Definition: DataClasses.h:417
double S_dsm
Definition: DataClasses.h:413
double rime
Definition: DataClasses.h:415
double z
nodal height from ground in m
Definition: DataClasses.h:401
class to collect the information about the current simulation (version, date)
Definition: DataClasses.h:847
const mio::Date computation_date
Date of computation.
Definition: DataClasses.h:855
const double version_num
SNOWPACK version formatted as a number.
Definition: DataClasses.h:854
const std::string version
SNOWPACK version.
Definition: DataClasses.h:853
const std::string hostname
hostname of the computer running the simulation
Definition: DataClasses.h:858
RunInfo()
Definition: DataClasses.cc:60
const std::string compilation_date
Date of compilation.
Definition: DataClasses.h:856
const std::string user
logname of the user running the simulation
Definition: DataClasses.h:857
RunInfo & operator=(const RunInfo &)
Definition: DataClasses.h:851
SN_SNOWSOIL_DATA includes all important station parameters as well as LayerData.
Definition: DataClasses.h:230
const std::string toString() const
Definition: DataClasses.cc:3450
double TimeCountDeltaHS
Definition: DataClasses.h:263
double Canopy_alb_dry
Definition: DataClasses.h:269
mio::Date profileDate
Date of profile.
Definition: DataClasses.h:249
double Height
Total height of soil-snow column in m (sum of the layer heights)
Definition: DataClasses.h:251
size_t nN
Total number of FE nodes after loading.
Definition: DataClasses.h:250
int ErosionLevel
Erosion Level in operational mode (flat field virtual erosion)
Definition: DataClasses.h:262
double Canopy_Direct_Throughfall
Direct throughfall [fraction of precipitation].
Definition: DataClasses.h:261
mio::StationData meta
Station meta data.
Definition: DataClasses.h:248
friend std::ostream & operator<<(std::ostream &os, const SN_SNOWSOIL_DATA &data)
Definition: DataClasses.cc:3384
double Canopy_alb_wet
Definition: DataClasses.h:270
double Canopy_BasalArea
OPTIONAL PARAMETERS, a warning will be thrown in CANOPY::Initialize if no value is provided.
Definition: DataClasses.h:265
double Emissivity_soil
OPTIONAL PARAMETERS, if not provided Constants::emissivity_soil will be used.
Definition: DataClasses.h:273
size_t nLayers
Total number of soil and snow layers at loading.
Definition: DataClasses.h:252
double Canopy_LAI
Canopy Leaf Area Index in m2 m-2.
Definition: DataClasses.h:260
double Canopy_diameter
Average canopy (tree) diameter [m], parameter in the new radiation transfer model.
Definition: DataClasses.h:266
double SoilAlb
Soil albedo, default 0.2.
Definition: DataClasses.h:257
double Canopy_Height
Canopy Height in m.
Definition: DataClasses.h:259
SN_SNOWSOIL_DATA()
Definition: DataClasses.h:232
std::vector< LayerData > Ldata
contains all the information required to construct the Xdata
Definition: DataClasses.h:253
double Canopy_int_cap_snow
Specific interception capacity for rain (I_LAI) (mm/LAI)
Definition: DataClasses.h:268
double BareSoil_z0
Bare soil roughness in m, default 0.02 m.
Definition: DataClasses.h:258
double Canopy_lai_frac_top_default
fraction of total LAI that is attributed to the uppermost layer. Here calibrated for Alptal.
Definition: DataClasses.h:267
double Canopy_alb_snow
Definition: DataClasses.h:271
friend std::istream & operator>>(std::istream &is, SN_SNOWSOIL_DATA &data)
Definition: DataClasses.cc:3416
double Albedo
REQUIRED PARAMETERS, an error will be thrown at reading (SnowpackIO) if no parameter are provided.
Definition: DataClasses.h:256
double HS_last
Definition: DataClasses.h:254
Definition: SeaIce.h:42
Defines structure for snow profile layers.
Definition: DataClasses.h:808
double theta_w
0 to 1, volume fraction of water (-)
Definition: DataClasses.h:828
double height
Height of snow or snow depth; 0 to 1000 (cm)
Definition: DataClasses.h:822
double theta_a
0 to 1, volume fraction of air (-)
Definition: DataClasses.h:829
void average(const double &w1, const double &w2, const SnowProfileLayer &Pdata)
Determines the averaged quantities of the current layer with another layer.
Definition: DataClasses.cc:248
double T
-50 to 50, snow temperature at top of layer (degC)
Definition: DataClasses.h:824
double hard
0. to 5. (1)
Definition: DataClasses.h:838
mio::Date profileDate
Date of profile.
Definition: DataClasses.h:816
mio::Date depositionDate
Date of deposition (mainly used for snow layers)
Definition: DataClasses.h:821
unsigned short int marker
0 to 999 (1)
Definition: DataClasses.h:836
SnowProfileLayer()
Definition: DataClasses.cc:131
static std::vector< SnowProfileLayer > generateProfile(const mio::Date &dateOfProfile, const SnowStation &Xdata, const double hoar_density_surf, const double hoar_min_size_surf)
Generates a snow profile from snow station data (1 element = 1 layer)
Definition: DataClasses.cc:203
double v_strain_rate
0 to 1.0e-5, viscous strain rate (s-1)
Definition: DataClasses.h:826
std::string stationname
Definition: DataClasses.h:817
unsigned char loc_for_wind
Definition: DataClasses.h:819
double coordin_num
0 to 10 (1)
Definition: DataClasses.h:835
unsigned char loc_for_snow
Definition: DataClasses.h:818
double ogs
0 to 100, optical equivalent grain size (mm)
Definition: DataClasses.h:834
double rho
0 to 1000 (kg m-3)
Definition: DataClasses.h:823
short unsigned int type
0 to 999 (1)
Definition: DataClasses.h:837
double sphericity
0 to 1 (1)
Definition: DataClasses.h:833
double grain_size
0 to 100 (mm)
Definition: DataClasses.h:830
double gradT
-1000 to 1000, temperature gradient across layer (K m-1)
Definition: DataClasses.h:825
double dendricity
0 to 1 (1)
Definition: DataClasses.h:832
double bond_size
0 to 100 (mm)
Definition: DataClasses.h:831
double theta_i
0 to 1, volume fraction of ice (-)
Definition: DataClasses.h:827
Definition: DataClasses.h:603
void combineElements(const size_t &number_top_elements, const bool &reduce_n_elements, const size_t &cond, const double &comb_thresh_l)
If more than NUMBER_TOP_ELEMENTS snow elements exist, attempt to reduce their number in the FEM mesh,...
Definition: DataClasses.cc:2238
double findMarkedReferenceLayer() const
returns the height of a marked reference layer inside the model domain Searches for the layer that is...
Definition: DataClasses.cc:2844
static const double comb_thresh_sp
Sphericity (1)
Definition: DataClasses.h:695
size_t SoilNode
The top soil node, 0 in case of SNP_SOIL == 0.
Definition: DataClasses.h:656
size_t getNumberOfNodes() const
Definition: DataClasses.cc:2190
bool hasSoilLayers() const
Definition: DataClasses.cc:2211
double z_S_n
Depth of Minimum S_n.
Definition: DataClasses.h:675
void initialize(const SN_SNOWSOIL_DATA &SSdata, const size_t &i_sector)
This routine initializes the snow cover structure which contains all information about a station incl...
Definition: DataClasses.cc:2349
size_t getNumberOfElements() const
Definition: DataClasses.cc:2185
char S_class1
Stability class based on hand hardness, grain class ...
Definition: DataClasses.h:670
static const double thresh_moist_soil
Definition: DataClasses.h:696
friend std::istream & operator>>(std::istream &is, SnowStation &data)
Definition: DataClasses.cc:2937
double S_n
Minimum natural stability index.
Definition: DataClasses.h:674
double S_s
Minimum skier stability index sk38 (Sk38)
Definition: DataClasses.h:676
double hn
Depth of new snow to be used on slopes.
Definition: DataClasses.h:665
mio::StationData meta
Station meta data.
Definition: DataClasses.h:645
size_t find_tag(const size_t &tag) const
Find element with corresponding tag or return IOUtils::npos if not found.
Definition: DataClasses.cc:2200
double SoilAlb
Soil albedo.
Definition: DataClasses.h:653
double rime_hn
rime of new snow to be used on slopes
Definition: DataClasses.h:667
double ErosionMass
Eroded mass either real or virtually (storage if less than one element)
Definition: DataClasses.h:669
static const size_t number_top_elements
Number of top elements left untouched by the join functions.
Definition: DataClasses.h:697
SeaIce * Seaice
Pointer to sea ice class.
Definition: DataClasses.h:650
double S_d
Minimum deformation rate stability index.
Definition: DataClasses.h:672
double swc_sum_soil
Total solid water in soil.
Definition: DataClasses.h:664
double dIntEnergy
Internal energy change of snowpack (J m-2)
Definition: DataClasses.h:687
void * Kt
Pointer to pseudo-conductivity and stiffnes matrix.
Definition: DataClasses.h:684
double cos_sl
Cosinus of slope angle, initialized once!
Definition: DataClasses.h:646
void resize(const size_t &number_of_elements)
Reallocate element and node data Edata and Ndata as well as nElems and nNodes are reallocated or res...
Definition: DataClasses.cc:2165
double z_S_4
Depth of Minimum S_4.
Definition: DataClasses.h:679
double rho_hn
Density of new snow to be used on slopes.
Definition: DataClasses.h:666
~SnowStation()
Definition: DataClasses.cc:2003
double z_S_s
Depth of Minimum S_s.
Definition: DataClasses.h:677
double meltFreezeEnergy
Melt freeze part of internal energy change of snowpack (J m-2)
Definition: DataClasses.h:689
double getTotalLateralFlowSoil() const
Computes the total lateral flow in soil (kg / m2)
Definition: DataClasses.cc:2137
double lwc_sum_soil
Total liquid water in soil.
Definition: DataClasses.h:663
double ColdContent
Cold content of snowpack (J m-2)
Definition: DataClasses.h:685
double S_4
placeholder - currently Minimum structural stability index (SSI)
Definition: DataClasses.h:678
bool windward
True for windward (luv) slope.
Definition: DataClasses.h:692
double S_5
placeholder
Definition: DataClasses.h:680
void splitElement(const size_t &e)
Split the element provided as first argument.
Definition: DataClasses.cc:2628
double ColdContentSoil
Cold content of soil (J m-2)
Definition: DataClasses.h:686
double getModelledTemperature(const double &z) const
Returns modelled internal snow or/and soil temperature (instantaneous value; degC),...
Definition: DataClasses.cc:2104
double mass_sum
Total mass summing mass of snow elements.
Definition: DataClasses.h:660
double swe
Total mass summing snow water equivalent of elements.
Definition: DataClasses.h:661
static const double comb_thresh_rg
Grain radius (mm)
Definition: DataClasses.h:695
void compSnowpackMasses()
Computes the actual total masses of the snowpack (kg m-2)
Definition: DataClasses.cc:2026
void reduceNumberOfElements(const size_t &rnE)
Remove the upper "marked" element of two (snow only) .
Definition: DataClasses.cc:2284
double z_S_d
Depth of Minimum S_d.
Definition: DataClasses.h:673
std::vector< NodeData > Ndata
pointer to nodal data array (e.g. T, z, u, etc..)
Definition: DataClasses.h:682
static void mergeElements(ElementData &Edata0, const ElementData &Edata1, const bool &merge, const bool &topElement)
Merging two elements.
Definition: DataClasses.cc:2709
double ReSolver_dt
Last used RE time step in the previous SNOWPACK time step.
Definition: DataClasses.h:691
static unsigned short number_of_solutes
The model treats that number of solutes.
Definition: DataClasses.h:698
double BareSoil_z0
Bare soil roughness in m.
Definition: DataClasses.h:655
static const double comb_thresh_dd
Dendricity (1)
Definition: DataClasses.h:695
void reset_water_fluxes()
Definition: DataClasses.cc:2216
double mH
The MEASURED height, including soil depth if SNP_SOIL == 1.
Definition: DataClasses.h:659
SnowStation & operator=(const SnowStation &)
Assignement operator.
Definition: DataClasses.cc:1938
std::vector< ElementData > Edata
pointer to element data array (e.g. Te, L, Rho, etc..)
Definition: DataClasses.h:683
double Albedo
Snow albedo used by the model.
Definition: DataClasses.h:652
double dIntEnergySoil
Internal energy change of soil (J m-2)
Definition: DataClasses.h:688
double z_S_5
Depth of Minimum S_5.
Definition: DataClasses.h:681
friend std::ostream & operator<<(std::ostream &os, const SnowStation &data)
Definition: DataClasses.cc:2857
double getTotalLateralFlowSnow() const
Computes the total lateral flow in snow (kg / m2)
Definition: DataClasses.cc:2122
static const double comb_thresh_water
Water content (1)
Definition: DataClasses.h:694
size_t sector
current slope sector of width 360./max(1, nSlopes-1)
Definition: DataClasses.h:647
double Ground
The ground height – meaning the height of the top soil node.
Definition: DataClasses.h:657
const std::string toString() const
Definition: DataClasses.cc:3022
void resetSlopeParFlux()
Reset lateral flow.
Definition: DataClasses.cc:2152
static const double comb_thresh_ice
Volumetric ice content (1), i.e., about 46 kg m-3.
Definition: DataClasses.h:694
SnowStation(const bool i_useCanopyModel=true, const bool i_useSoilLayers=true, const bool i_isAlpine3D=false, const bool i_useSeaIceModule=false)
Definition: DataClasses.cc:1904
char S_class2
Stability class based on hand hardness, grain class ...
Definition: DataClasses.h:671
double getLiquidWaterIndex() const
Computes the liquid water index defined as the ratio of total liquid water content (in mm w....
Definition: DataClasses.cc:2092
void compSoilInternalEnergyChange(const double &sn_dt)
Computes the internal energy change of the soil during one computation time step (J m-2)
Definition: DataClasses.cc:2067
bool isGlacier(const bool &hydro=false) const
returns if a snow profile can be considered as a glacier. Practically, the hydrological criteria is t...
Definition: DataClasses.cc:2803
double SoilEmissivity
Soil emissivity.
Definition: DataClasses.h:654
double TimeCountDeltaHS
Time counter tracking erroneous settlement in operational mode.
Definition: DataClasses.h:693
double lwc_sum
Total liquid water in snowpack.
Definition: DataClasses.h:662
static const double comb_thresh_l_ratio
The default ratio between height_new_elem and comb_thresh_l, in case comb_thresh_l is not explicitly ...
Definition: DataClasses.h:694
double cH
The CALCULATED height, including soil depth if SNP_SOIL == 1.
Definition: DataClasses.h:658
double meltFreezeEnergySoil
Melt freeze part of internal energy change of soil (J m-2)
Definition: DataClasses.h:690
double pAlbedo
Parameterized snow albedo.
Definition: DataClasses.h:651
void splitElements(const double &max_element_length, const double &comb_thresh_l)
Split elements when they are near the top of the snowpack, when REDUCE_N_ELEMENTS is used.
Definition: DataClasses.cc:2674
size_t ErosionLevel
Element where snow erosion stopped previously for the drift index.
Definition: DataClasses.h:668
static bool combineCondition(const ElementData &Edata0, const ElementData &Edata1, const double &depth, const bool &reduce_n_elements, const double &comb_thresh_l)
Boolean routine to check whether two snow elements can be combined.
Definition: DataClasses.cc:2578
void compSnowpackInternalEnergyChange(const double &sn_dt)
Computes the internal energy change of the snowpack during one computation time step (J m-2)
Definition: DataClasses.cc:2045
CanopyData Cdata
Pointer to canopy data.
Definition: DataClasses.h:649
static const double thresh_moist_snow
Snow elements with a LWC above this threshold are considered at least to be moist.
Definition: DataClasses.h:696
Definition: SnowpackConfig.h:28
Definition: DataClasses.h:731
SN_MASS_CHANGES
The different types of mass fluxes: Mass fluxes in kg m-2 Rates in kg m-2 h-1 (MS_HNW,...
Definition: DataClasses.h:738
@ MS_WATER
The total amount of water in the snowpack at the present time.
Definition: DataClasses.h:741
@ MS_SUBLIMATION
The mass loss or gain of the top element due to snow (ice) sublimating.
Definition: DataClasses.h:748
@ MS_TOTALMASS
This of course is the total mass of the snowpack at the present time.
Definition: DataClasses.h:739
@ MS_HNW
Solid precipitation rate.
Definition: DataClasses.h:744
@ MS_WIND
Mass loss rate due to wind erosion.
Definition: DataClasses.h:746
@ MS_FLOODING
The mass gain due to adding ocean water to snow- seaice by flodding process.
Definition: DataClasses.h:752
@ MS_ICE_SOIL
The total amount of ice in the soil at the present time.
Definition: DataClasses.h:743
@ MS_SWE
This too, of course, but summing rho*L.
Definition: DataClasses.h:740
@ MS_SOIL_RUNOFF
Equivalent to MS_SNOWPACK_RUNOFF but at bottom soil node.
Definition: DataClasses.h:751
@ MS_SNOWPACK_RUNOFF
The mass loss of snowpack from snow melt due to water transport (virtual lysimeter)
Definition: DataClasses.h:749
@ MS_WATER_SOIL
The total amount of water in the soil at the present time.
Definition: DataClasses.h:742
@ MS_EVAPORATION
The mass loss or gain of the top element due to water evaporating.
Definition: DataClasses.h:747
@ N_MASS_CHANGES
Total number of different mass change types.
Definition: DataClasses.h:754
@ MS_RAIN
Rain rate.
Definition: DataClasses.h:745
@ MS_SURFACE_MASS_FLUX
The total mass loss of snowpack due to water transport (virtual lysimeter)
Definition: DataClasses.h:750
@ MS_ICEBASE_MELTING_FREEZING
The mass gain/loss of the ice base due to melting-freezing.
Definition: DataClasses.h:753
std::vector< double > load
Total load (kg m-2) in water runoff from solutes like nitrate.
Definition: DataClasses.h:798
friend std::ostream & operator<<(std::ostream &os, const SurfaceFluxes &data)
Definition: DataClasses.cc:454
double lw_in
Energy fluxes: Energy change of snowpack in kJ m-2 (dIntEnergy) Fluxes in W m-2.
Definition: DataClasses.h:773
double sw_dir
incoming direct shortwave radiation; on slopes: projected
Definition: DataClasses.h:786
double sw_hor
incoming global shortwave radiation on horizontal surface
Definition: DataClasses.h:782
double sw_diff
incoming diffuse shortwave radiation
Definition: DataClasses.h:787
double mAlbedo
measured Albedo (used for OUTPUT only)
Definition: DataClasses.h:789
double cRho_hn
Computed new snow density (kg m-3)
Definition: DataClasses.h:800
SurfaceFluxes()
Definition: DataClasses.cc:292
friend std::istream & operator>>(std::istream &is, SurfaceFluxes &data)
Definition: DataClasses.cc:494
void collectSurfaceFluxes(const BoundCond &Bdata, SnowStation &Xdata, const CurrentMeteo &Mdata)
Assign surface data from SnowStation and BoundCond to SurfaceFluxes.
Definition: DataClasses.cc:361
double qr
rain energy
Definition: DataClasses.h:779
std::vector< double > mass
Total mass of snowpack PLUS different amounts of total mass change, sublimation, runoff,...
Definition: DataClasses.h:797
double lw_net
net longwave radiation
Definition: DataClasses.h:775
double qg
geothermal heat flux or heat flux at lower boundary
Definition: DataClasses.h:780
double sw_in
incoming global shortwave radiation; on slopes: projected
Definition: DataClasses.h:783
void reset(const bool &cumsum_mass)
Definition: DataClasses.cc:297
double drift
Other surface data:
Definition: DataClasses.h:796
double pAlbedo
parameterized Albedo (used for OUTPUT only)
Definition: DataClasses.h:788
double lw_out
outgoing longwave radiation
Definition: DataClasses.h:774
double meltFreezeEnergySoil
Melt freeze part of internal energy change in J m-2 in soil (used for OUTPUT only)
Definition: DataClasses.h:793
double hoar
mass of surface hoar formed or sublimated
Definition: DataClasses.h:778
double dIntEnergySoil
Internal energy change in J m-2 in soil (used for OUTPUT only)
Definition: DataClasses.h:791
double dIntEnergy
Internal energy change in J m-2 in snowpack (used for OUTPUT only)
Definition: DataClasses.h:790
double sw_out
reflected shortwave radiation
Definition: DataClasses.h:784
double qw
net shortwave radiation at the surface (absorbed within the snowpack)
Definition: DataClasses.h:785
const std::string toString() const
Definition: DataClasses.cc:3484
void multiplyFluxes(const double &factor)
If multiple surface fluxes have been summed over multiple time steps, the fluxes then need to be aver...
Definition: DataClasses.cc:432
void compSnowSoilHeatFlux(const SnowStation &Xdata)
Compute ground heat flux at soil/snow boundary.
Definition: DataClasses.cc:331
double dhs_corr
operational mode only: snow depth correction in case of squeezing or blow-up (m)
Definition: DataClasses.h:799
double qg0
ground heat flux at soil-snow interface
Definition: DataClasses.h:781
double qs
sensible heat
Definition: DataClasses.h:776
double mRho_hn
Measured new snow density (kg m-3)
Definition: DataClasses.h:801
double meltFreezeEnergy
Melt freeze part of internal energy change in J m-2 in snowpack (used for OUTPUT only)
Definition: DataClasses.h:792
double ql
latent heat
Definition: DataClasses.h:777
ZwischenData contains "memory" information mainly for operational use It is used to prepare some para...
Definition: DataClasses.h:65
ZwischenData()
Definition: DataClasses.h:67
void reset()
Sets all the values in the vectors to 0.0.
Definition: DataClasses.cc:92
std::vector< double > hn24
Twenty-four hour snow heights every half-hour over three days 144.
Definition: DataClasses.h:76
std::vector< double > hn3
Three hour new snow heights every half-hour over three days 144.
Definition: DataClasses.h:75
std::vector< double > drift24
Twenty-four hour hoar index every half-hour over one day 48.
Definition: DataClasses.h:74
friend std::ostream & operator<<(std::ostream &os, const ZwischenData &data)
Definition: DataClasses.cc:100
std::vector< double > hoar24
Twenty-four hour hoar index every half-hour over one day 48.
Definition: DataClasses.h:73
friend std::istream & operator>>(std::istream &is, ZwischenData &data)
Definition: DataClasses.cc:114
This module contains the van Genuchten model for the water retention curve.
Definition: vanGenuchten.h:36
Definition: Constants.h:43
const double undefined
This is the snowpack undefined value.
Definition: Constants.h:44
Optical Properties of snow.
Definition: DataClasses.h:48
double ssa
Single Scattering Albedo.
Definition: DataClasses.h:51
double exteff
Extinction Efficiency.
Definition: DataClasses.h:50
double ggg
Asymmetry Parameter.
Definition: DataClasses.h:49
Spectrum of incoming solar radiation.
Definition: DataClasses.h:55
double perc
Percentage of Energy.
Definition: DataClasses.h:57
double nm
Wavelength.
Definition: DataClasses.h:56