BuildTreeObject           package:treeglia           R Documentation

_B_u_i_l_d_s _a _d_a_t_a._f_r_a_m_e _h_o_l_d_i_n_g _t_r_e_e _d_a_t_a

_D_e_s_c_r_i_p_t_i_o_n:

     Builds a 'data.frame' holding conversion coefficients and tree
     physical properties including.  The creation of this object is a
     mandatory step before any call to 'StemAnalysis' and to
     'BuildAgeTable'. It is passed as an argument to both the above
     functions.

_U_s_a_g_e:

     BuildTreeObject(tom = 1000000, tocm = 10000, vols = 1.0635, vols.ste = 0.0, basd = 0.51783, basd.ste = 0.04281, carb = 0.4577,carb.ste = 0.00243)

_A_r_g_u_m_e_n_t_s:

     tom: a numeric value holding the multiplicative coefficients to
          get to [m] from ring-width measures. This is used in
          'StemAnalysis'.

    tocm: a numeric value holding the multiplicative coefficients to
          get to [cm] from ring-width measures. This is used in
          'BuildAgeTable'.

    vols: a numeric value holding the multiplicative coefficients to
          get to fresh stem volume [m$^3$] from the computed volume.

vols.ste: a numeric value holding the standard error of the
          multiplicative coefficients to get to fresh stem volume
          [m$^3$] from the computed volume.

    basd: a numeric value holding the wood basic density (_i.e._
          dry-matter wood weight over fresh wood volume).

basd.ste: a numeric value holding the standard error of wood basic
          density.

    carb: a numeric value holding the amount of carbon stored in wood.
          It is expressed as a [0..1] number.

carb.ste: a numeric value holding the standard error of the amount of
          carbon stored in wood. It is expressed as a [0..1] number.

_D_e_t_a_i_l_s:

     Volume shrinks from wet wood to dry wood. if RWs are measured at
     room temperature and humidity, the computed volume must be
     expanded to fresh volume If not measured, fetch the values for
     volume reduction in the literature (see below). If ring-widths are
     measured at room temperature and humidity, the tabled shrink
     coefficient has to be halved: _Picea abies_ shrinkage coefficient
     from dry-matter to fresh volume is 1.127. (1.127-1)/2+1 becomes
     1.0635. As a result, the computed volume of _Picea abies_ must be
     expanded of 6.35

_N_o_t_e:

     'BuildTreeObject' is just a wrapper for 'data.frame'.

_A_u_t_h_o_r(_s):

     Marco Bascietto

_R_e_f_e_r_e_n_c_e_s:

     Nardi Berti R., La struttura anatomica del legno ed il
     riconoscimento dei legnami italiani di pi comune impiego,
     Contributi Scientifico-Pratici per una migliore conoscenza ed
     utilizzazione del legno, CNR 24 (1979) 117-155.
      in  Bascietto M., Scarascia-Mugnozza G., A collection of
     functions to determine annual tree Carbon increment via stem
     analysis, Annals of Forest Science (accepted)
      Giordano, G., Variazioni della densit del legno, in: Tecnologia
     del legno,UTET,Torino, Italy, pp. 832-869.

_S_e_e _A_l_s_o:

     'StemAnalysis''BuildAgeTable'

_E_x_a_m_p_l_e_s:

     # Build a tree object
     Tree.features.1 <- BuildTreeObject(vols=1.085, vols.ste=0.0, basd=0.5792, basd.ste=0.016, carb=0.4424,carb.ste=0.0011)

