Merge pull request #587 from ChHaeni/develop

Update user help text

share/Models/version6/Application/Slurry/Applrate.nhd

@@ -67,11 +67,11 @@ taxonomy = Application::Slurry::Applrate
       Application rate, mean volume of slurry applied on a ha per deployment.
     ++help
       +++en
-         <p>Standard value for Switzerland: 30 m<sup>3</sup></p>
+         <p>Standard value for Switzerland: 25 m<sup>3</sup></p>
       +++de
-         <p>Vorschlag für Standardwert: 30 m<sup>3</sup></p>
+         <p>Vorschlag für Standardwert: 25 m<sup>3</sup></p>
       +++fr
-         <p>Proposition de valeur standard: 30 m<sup>3</sup></p>
+         <p>Proposition de valeur standard: 25 m<sup>3</sup></p>
 ?endif
 
 *** technical ***

share/Models/version6/Application/Slurry/Cfermented.nhd

@@ -33,11 +33,11 @@ taxonomy = Application::Slurry::Cfermented
        <p>Standard value for Switzerland: 0%</p>
     +++de
        <p>Anteil der auf dem Betrieb produzierten Gülle, welche nach der Vergärung in einer Biogasanlage als Gärgülle ausgebracht wird. Gärgülle: Gesamtsubstrat nach der Vergärung von Material landwirtschaftlicher Herkunft plus maximal 20% Material nicht-landwirtschaftlicher Herkunft (Frischsubstanz).</p>
-       <p>Agridea, BLW. 2010. Wegleitung Suisse-Bilanz. Auflage 1.8, April 2010. Agridea, Lindau. Bundesamt für Landwirtschaft, BLW, Bern.</p>
+       <p>Agridea, BLW. 2020. Wegleitung Suisse-Bilanz. Auflage 1.16. Agridea, Lindau. Bundesamt für Landwirtschaft, BLW, Bern.</p>
        <p>Vorschlag für Standardwert: 0%</p>
     +++fr
        <p>Part de lisier produit sur l'exploitation et épandu en tant que lisier issu de digestion après avoir passé dans une installation de biogaz. Lisier issu de digestion: ensemble des substrats après la méthanisation de produits d'origine agricole comportant au plus 20% MF (matière fraîche) de produits d'origine non agricole. </p>
-       <p>Agridea, OFAG. 2010. Guide Suisse-Bilanz. Edition 1.8, avril 2010. Agridea, Lindau. Office fédéral de l'agriculture OFAG , Berne.</p>
+       <p>Agridea, OFAG. 2020. Guide Suisse-Bilanz. Edition 1.16. Agridea, Lindau. Office fédéral de l'agriculture OFAG , Berne.</p>
        <p>Proposition de valeur standard: 0%</p>
 
 
@@ -54,4 +54,4 @@ taxonomy = Application::Slurry::Cfermented
   ++description
     Share of fermented slurry.
   ++formula
-    In(fermented_slurry)/100;
+    In(fermented_slurry)/100;

share/Models/version6/Livestock/DairyCow.nhd

@@ -6,10 +6,11 @@ instances = multi
 gui = Livestock::DairyCow,Tierhaltung::Milchkühe,Production animale::Vâches laitières,Livestock::Dairy cows
 
 +short
-  annual emission
+  Collects the annual emission of NH3 and the N flux for dairy cows.
 
 + description
-  XXX
+  This process summarizes the annual emission of NH3 for dairy cows. 
+  from housing, yard and grazing. Further it summarizes the annual N flux from housing and yard to the storage for dairy cows.
 
 *** input ***
 

share/Models/version6/Livestock/DairyCow/Excretion.nhd

@@ -11,32 +11,14 @@ milk yield and the feed ration.
 
 +description
 
-This process calculates the annual N excretion (total N and Nsol (urea plus
-measured total ammoniacal nitrogen)) of a number of dairy cows as a
-function of the milk yield and the supplied feed ration. Nitrogen
-surpluses from increased nitrogen uptake are primarily excreted as
-Nsol in the urine. Eighty percent of the increased N excretion is
-therefore added to the Nsol fraction.
-
-The standard N excretion was taken from the official Swiss fertilizer
-guidelines. These values were compiled on the basis of official
-feeding recommendations (RAP 1999) by a group of feeding experts under
-the lead of H. Menzi. Even though the methodology used is not
-documented in detail, it was well known to the authors of DYNAMO.
+This process calculates the annual N excretion (total N and TAN (Total Ammoniacal Nitrogen) of a number of dairy cows as a function of the milk yield and the supplied feed ration. Nitrogen surpluses from increased nitrogen uptake are primarily excreted as TAN in the urine.
 
-\subsubsection{References:}
-
-Burgos SA, Robinson PH, Fadel JG, DePeters EJ 2005. Ammonia volatilization
-potential: Prediction of urinary urea nitrogen output on lactating dairy
-cows. Agriculture, Ecosystems and Environment 111:261-269.
+The standard N excretion was taken from the PRIF 2017 (Richner et al., 2017; PRIF: Principles of Agricultural Crop Fertilisation in Switzerland).
 
-Peterson SO, Sommer SG, Aaes O, Soegaard K 1998. Ammonia losses from urine and
-dung of grazing cattle: effect of N intake. Atmospheric environment
-32:295-300.
+\subsubsection{References:}
 
-RAP 1999. Fütterungsempfehlungen und Nährwerttabelle für Wiederkäuer. 4. Überarbeitete Auflage, 327p, Landwirtschaftliche Lehrmittelzentrale, Zollikofen.
+Richner, W., Flisch, R., Mayer, J., Schlegel, P., Zähner, M., Menzi, H., 2017. 4/ Eigenschaften und Anwendung von Düngern, in: Richner, W., Sinaj, S. (Eds.), Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz / GRUD 2017. Agrarforschung Schweiz 8 (6) Spezialpublikation, pp. 4/1-4/24.
 
-Flisch R, Sinaj S, Charles R, Richner W 2009. Grundlagen für die die Düngung im Acker- und Futterbau. Agrarforschung 16(2).
 
 *** input ***
 
@@ -64,7 +46,7 @@ Flisch R, Sinaj S, Charles R, Richner W 2009. Grundlagen für die die Düngung i
   +++de
      <p>Für Milchkühe sind keine Unterkategorien vorgesehen.</p>
   +++fr
-     <p><Für Milchkühe sind keine Unterkategorien vorgesehen./p>
+     <p><Il n'y a pas de sous-catégories pour les vaches laitières./p>
 
 +animals
   type = float
@@ -84,7 +66,7 @@ Flisch R, Sinaj S, Charles R, Richner W 2009. Grundlagen für die die Düngung i
     +++de
        <p>Tatsächliche Anzahl Tiere im Stall.</p>
     +++fr
-       <p>Nombre effectif d'animaux dans la stabulation.</p>
+       <p>Nombre effectif d'animaux dans l'étable.</p>
 
 +dimensioning_barn
   type = float
@@ -108,7 +90,7 @@ Flisch R, Sinaj S, Charles R, Richner W 2009. Grundlagen für die die Düngung i
          <p>Bei Auswahl "Standard" wird die Anzahl Tierplätze im Stall der eingegebenen Anzahl Tiere gleichgesetzt.</p>
       +++fr
          <p>Pour les stabulations libres: mentionner toutes les places accessibles aux animaux. Le nombre de places dans l'étable peut être supérieur au cheptel actuel, dans la perspective d'un agrandissement futur de l'exploitation p.ex. Dans les stabulations libres, un nombre de places supérieur au nombre d'animaux signifie une augmentation de la surface souillée par animal. Au contraire, dans les stabulations entravées, un nombre de places supérieur au nombre d'animaux ne conduit pas à une augmentation de la surface souillée par animal, vu que ces places libres ne sont pas accessibles aux animaux.  </p>
-         <p>Si "Standard" est introduisé, la valeur du nombre d'animaux est utilisée.</p>
+         <p>Si "Standard" est sélectionné, la valeur du nombre d'animaux est utilisée.</p>
 
 ?if !Kantonal_LU
   +inp_n_excretion
@@ -131,7 +113,7 @@ Flisch R, Sinaj S, Charles R, Richner W 2009. Grundlagen für die die Düngung i
             nitrogen excretion according to PRIF 2017 is applied (Richner
             et al., 2017) is applied (PRIF: Principles of Agricultural Crop
             Fertilisation in Switzerland). If a number is entered, a value
-            for the nitrogen excretion can be selected by the user.</p>
+            for the nitrogen excretion can be selected by the user. This option applies for cases for which the nitrogen excretion can be optained from e.g. a feeding model.</p>
          <p>Richner, W., Flisch, R., Mayer, J., Schlegel, P., Zähner,
             M., Menzi, H., 2017. 4/ Eigenschaften und Anwendung von
             Düngern, in: Richner, W., Sinaj, S. (Eds.), Grundlagen für
@@ -141,18 +123,18 @@ Flisch R, Sinaj S, Charles R, Richner W 2009. Grundlagen für die die Düngung i
       +++de
          <p>Bei Eingabe <b>Standard</b> wird der Richtwert für die Stickstoffausscheidung gemäss GRUD
             2017 (Richner et al., 2017) verwendet. Bei Eingabe einer Zahl kann der Wert für die
-            Stickstoffausscheidung selbst gewählt werden.</p>
+            Stickstoffausscheidung selbst gewählt werden. Diese Option ist für Fälle gedacht, in denen die Stickstoffausscheidung beispielsweise aus einem Fütterungsmodell bekannt ist.</p>
          <p>Richner, W., Flisch, R., Mayer, J., Schlegel, P., Zähner,
             M., Menzi, H., 2017. 4/ Eigenschaften und Anwendung von
             Düngern, in: Richner, W., Sinaj, S. (Eds.), Grundlagen für
             die Düngung landwirtschaftlicher Kulturen in der Schweiz /
             GRUD 2017. Agrarforschung Schweiz 8 (6) Spezialpublikation,
             pp. 4/1-4/23.</p>
       +++fr
-         <p>Si "Standard" est introduisé, la valeur de référence pour
+         <p>Si "Standard" est sélectionné, la valeur de référence pour
             les excrétions azotées d'après PRIF 2017 (Richner et al., 2017)
             est utilisée (PRIF: « Principes de la fertilisation des
-            cultures agricoles en Suisse » ). Si un nombre est introduisé
+            cultures agricoles en Suisse » ). Si un nombre est saisi
             une valeur pour les excrétions azotées peut être déterminée par
             l'utilisateur/-trice.</p>
           <p>Richner, W., Flisch, R., Mayer, J., Schlegel, P., Zähner,
@@ -178,11 +160,14 @@ Flisch R, Sinaj S, Charles R, Richner W 2009. Grundlagen für die die Düngung i
       TAN fraction of the annual standard N excretion
     ++help
       +++en
-         <p>If "Standard" is selected ...</p>
+         <p>If "Standard" is selected the proportion of TAN in the excretions of the dairy cows is calculaded according to the Agrammon model. If a number is entered, a value
+            for the proportion of TAN in the excretion can be selected by the user. This option applies for cases for which the proportion of TAN in the excretions can be optained from e.g. a feeding model.</p>
       +++de
-         <p>Bei Eingabe <b>Standard</b> wird ...</p>
+         <p>Bei Eingabe <b>Standard</b> wird der Anteil von TAN in den Ausscheidungen der Milchkühe wie vom Modell Agrammon vorgegeben festgelegt. Bei Eingabe einer Zahl kann der Wert für den
+            Anteil von TAN in den Ausscheidungen selbst gewählt werden. Diese Option ist für Fälle gedacht, in denen  der Anteil von TAN in den Ausscheidungen beispielsweise aus einem Fütterungsmodell bekannt ist.</p>
       +++fr
-         <p>Si "Standard" est introduisé, la valeur de ...</p>
+         <p>Si <b>Standard</b> est sélectionné, le pourcentage de TAN issu des excrétions des vâches laitières est utilisé comme défini par le modèle Agrammon. Si un nombre est saisi, une valeur pour la proportion de TAN
+         dans les excrétions peut être déterminée par l'utilisateur/-trice. Cette option est destinée aux cas où la proportion de TAN dans les excréments est connue, par exemple à partir d'un modèle d'alimentation.</p>
 
 ?endif
 
@@ -211,23 +196,22 @@ Flisch R, Sinaj S, Charles R, Richner W 2009. Grundlagen für die die Düngung i
     fr = kg N/an
   ++description
     Annual standard N excretion for a dairy cow according to
-    Flisch et al. (2009).
+    Richner et al. (2017).
 
 +share_Nsol
   value = 0.55
   ++units
     en  = -
   ++description
-    Nsol content of excreta. Derived from e.g.
-    Peterson et al. (1998) or Burgos et al. (2005).
+    TAN content of excreta.
 
 +feed_influence_on_Nsol
   value = 1
   ++units
     en = kg Nsol/kg N
   ++description
     Proportion of N (calculated from feed ration correction) excreted as
-    Nsol. Derived from e.g. Peterson et al. (1998).
+    TAN.
 
 *** external ***
 

share/Models/version6/Livestock/DairyCow/Excretion/CConcentrates.nhd

@@ -11,10 +11,7 @@ taxonomy = Livestock::DairyCow::Excretion::CConcentrates
 +description
 
   This formula takes into account the amount of concentrates used per cow during the winter and summer feeding period. The correction is based on the fact that concentrates (grains) can specifically balance the energy to protein ratio, thus reducing the crude protein.
-
-
-\subsubsection{References:}
-  Flückiger E 1989. Stickstoff- und Mineralstoffumsatz von Milchkühen in Abhängigkeit von Rationentyp und Produktionsphase unter besonderer Berücksichtigung umweltrelevanter Aspekte. Diss ETH Nr 8865.
+
 
 
 

share/Models/version6/Livestock/DairyCow/Excretion/CFeed.nhd

@@ -13,9 +13,10 @@ and type of concentrates used.
 
 +description
 
- This process accounts for the fact, that special rations can result in higher or lower N excretions as compared to standard excretions from Flisch et al. (2009). A differentiated consideration of the duration of the summer and winter feeding period according to farm location (altitude etc.) is possible but was not implemented for the emission inventory.
+ This process accounts for the fact, that special rations can result in higher or lower N excretions as compared to standard excretions from Richner et al. (2017). A differentiated consideration of the duration of the summer and winter feeding period according to farm location (altitude etc.) is possible but was not implemented for the emission inventory.
 \subsubsection{References:}
-Flisch R, Sinaj S, Charles R, Richner W 2009. Grundlagen für die die Düngung im Acker- und Futterbau. Agrarforschung 16(2).
+Richner, W., Flisch, R., Mayer, J., Schlegel, P., Zähner, M., Menzi, H., 2017. 4/ Eigenschaften und Anwendung von Düngern, in: Richner, W., Sinaj, S. (Eds.), Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz / GRUD 2017. Agrarforschung Schweiz 8 (6) Spezialpublikation, pp. 4/1-4/24.
+
 
 
 *** input ***

share/Models/version6/Livestock/DairyCow/Excretion/CFeedSummerRatio.nhd

@@ -11,28 +11,8 @@ cow as a function of the summer feed ration.
 
 +description
 
-  This process calculates the correction factor for N excretion during
-  the summer feeding period as compared to the standard excretion
-  values of Walther et al. (2001). The average feed ration considered
-  for the standard excretion presented in Walther et al. (2001) was
-  calculated as average of four summer and four winter standard
-  rations using dsummer and dwinter mentioned above. To calculate the
-  N excretion of farm-specific summer rations, excretions were
-  calculated with the same model used by the authors of Walther et al.
-  (2001) (based on official feeing recommendations (RAP 1999)) using
-  proportions of the specific feed typically used on farms (expert
-  assumptions). No correction was considered for grass and grass
-  silage, because grass is used by virtually all farms during the
-  summer feeding period und because the crude protein content of grass
-  silage is not much lower than that of grass. The thus calculated
-  summer excretions were then expressed as % of average excretions.
-
-\subsubsection{References:}
-
-RAP 1999. Fütterungsempfehlungen und Nährwerttabellen für
-Wiederkäuer. 4. überarbeitete Auflage. LMZ Zollikofen.  
-Walther U, Ryser JP, Flisch R (Eds.) 2001. Grundlagen für die Düngung im Acker-
-und Futterbau 2001. Agrarforschung 8:1-80.
+Computes the correction factor for the annual N excretion of a dairy
+cow as a function of the summer feed ration.
 
 
  *** input ***

share/Models/version6/Livestock/DairyCow/Excretion/CFeedWinterRatio.nhd

@@ -11,26 +11,8 @@ cow as a function of the winter feed ration.
 
 +description
 
-This process calculates the correction factor for the N excretion
-during the winter feeding period as compared to the standard excretion
-values of Walther et al. (2001). The average feed ration considered for
-the standard excretion presented in Walther et al. (2001) was
-calculated as average of four summer and four winter standard rations
-using dsummer and dwinter mentioned above. To calculate the N
-excretion of farm-specific winter rations, excretions were calculated
-with the same model used by the authors of Walther et al. (2001) (based
-on official feeding recommendations (RAP 1999)) using proportions of
-the specific feed typically used on farms (expert assumptions). No
-correction was considered for hay, because hay is used by virtually
-all farms during the winter feeding period. The thus calculated winter
-excretions were then expressed as % of average excretions.
-
-\subsubsection{References:}
-
-RAP 1999. Fütterungsempfehlungen und Nährwerttabellen für
-Wiederkäuer. 4. überarbeitete Auflage. LMZ Zollikofen.  
-Walther U,Ryser JP, Flisch R (Eds.) 2001. Grundlagen für die Düngung im Acker-
-und Futterbau 2001. Agrarforschung 8:1-80.
+Computes the correction factor for the annual N excretion of a dairy
+cow as a function of the winter feed ration.
 
 
  *** input ***

share/Models/version6/Livestock/DairyCow/Excretion/CMilk.nhd

@@ -11,10 +11,10 @@ cow as a function of the milk yield.
 
 +description
 
- This process describes the relationship between the milk yield and the N excretion. While the N excretion decreases by 10% per 1000 kg less milk yield below the standard milk yield, nitrogen excretion increases by 5% per 1000 kg more milk yield above the standard milk yield. This correction factor was taken from GRUDAF 2009. It was originally derived from excretion calculations for different milk yields ranging from 4000 to 10000 kg year-1. The lower increase of the nitrogen excretion above 6500 kg results from the increasing proportion of concentrate necessary to cover the energy requirement for yields above 6500 kg. It is thus increasingly possible to reduce the unbalance of energy and protein existing in virtually all rations with a high proportion of roughage.
+ This process describes the relationship between the milk yield and the N excretion. While the N excretion decreases by 5% per 1000 kg less milk yield below the standard milk yield, nitrogen excretion increases by 5% per 1000 kg more milk yield above the standard milk yield. This correction factor was taken from GRUD 2017. It was originally derived from excretion calculations for different milk yields ranging from 4000 to 10000 kg year-1. The lower increase of the nitrogen excretion above 7500 kg results from the increasing proportion of concentrate necessary to cover the energy requirement for yields above 7500 kg. It is thus increasingly possible to reduce the unbalance of energy and protein existing in virtually all rations with a high proportion of roughage.
         \subsubsection{References:}
-Flisch R, Sinaj S, Charles R, Richner W (Eds.) 2009. Grundlagen für die die Düngung im
-Acker- und Futterbau 2009 (GRUDAF), Agrarforschung 16.2.
+Richner, W., Flisch, R., Mayer, J., Schlegel, P., Zähner, M., Menzi, H., 2017. 4/ Eigenschaften und Anwendung von Düngern, in: Richner, W., Sinaj, S. (Eds.), Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz / GRUD 2017. Agrarforschung Schweiz 8 (6) Spezialpublikation, pp. 4/1-4/24.
+
 
 
 *** input ***