PyPI - fvs-python - Versions diffs - 0.2.3__py3-none-any.whl - Mend

fvs-python 0.2.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (149) hide show

fvs_python-0.2.3.dist-info/METADATA +254 -0
fvs_python-0.2.3.dist-info/RECORD +149 -0
fvs_python-0.2.3.dist-info/WHEEL +5 -0
fvs_python-0.2.3.dist-info/licenses/LICENSE +21 -0
fvs_python-0.2.3.dist-info/top_level.txt +1 -0
pyfvs/__init__.py +107 -0
pyfvs/bark_ratio.py +323 -0
pyfvs/cfg/CFG_README.md +73 -0
pyfvs/cfg/dbh_bounding_table_4_7_1_8.json +103 -0
pyfvs/cfg/ecounit_coefficients_table_4_7_1_5.json +981 -0
pyfvs/cfg/ecounit_coefficients_table_4_7_1_6.json +856 -0
pyfvs/cfg/forest_type_mapping_table_4_7_1_4.json +38 -0
pyfvs/cfg/fortype_coefficients_table_4_7_1_3.json +1183 -0
pyfvs/cfg/functional_forms.yaml +111 -0
pyfvs/cfg/growth_model_parameters.yaml +98 -0
pyfvs/cfg/plant_values_table_4_7_1_7.json +15 -0
pyfvs/cfg/site_index_transformation.yaml +113 -0
pyfvs/cfg/sn_bark_ratio_coefficients.json +115 -0
pyfvs/cfg/sn_crown_competition_factor.json +109 -0
pyfvs/cfg/sn_crown_ratio_coefficients.json +956 -0
pyfvs/cfg/sn_crown_width_coefficients.json +1664 -0
pyfvs/cfg/sn_diameter_growth_coefficients.json +300 -0
pyfvs/cfg/sn_height_diameter_coefficients.json +97 -0
pyfvs/cfg/sn_large_tree_diameter_growth.json +191 -0
pyfvs/cfg/sn_large_tree_height_growth.json +229 -0
pyfvs/cfg/sn_large_tree_height_growth_coefficients.json +1187 -0
pyfvs/cfg/sn_mortality_model.json +176 -0
pyfvs/cfg/sn_regeneration_model.json +252 -0
pyfvs/cfg/sn_relative_site_index.json +263 -0
pyfvs/cfg/sn_small_tree_height_growth.json +879 -0
pyfvs/cfg/sn_species_codes_table.json +728 -0
pyfvs/cfg/sn_stand_density_index.json +398 -0
pyfvs/cfg/species/ab_american_basswood.yaml +251 -0
pyfvs/cfg/species/ae_american_elm.yaml +240 -0
pyfvs/cfg/species/ah_american_hornbeam.yaml +250 -0
pyfvs/cfg/species/ap_american_plum.yaml +251 -0
pyfvs/cfg/species/as_american_sycamore.yaml +253 -0
pyfvs/cfg/species/ba_black_ash.yaml +254 -0
pyfvs/cfg/species/bb_basswood.yaml +254 -0
pyfvs/cfg/species/bc_black_cherry.yaml +254 -0
pyfvs/cfg/species/bd_sweet_birch.yaml +252 -0
pyfvs/cfg/species/be_american_beech.yaml +251 -0
pyfvs/cfg/species/bg_black_gum.yaml +252 -0
pyfvs/cfg/species/bj_blue_jay.yaml +254 -0
pyfvs/cfg/species/bk_sugar_maple.yaml +251 -0
pyfvs/cfg/species/bn_butternut.yaml +252 -0
pyfvs/cfg/species/bo_red_maple.yaml +255 -0
pyfvs/cfg/species/bt_bigtooth_aspen.yaml +254 -0
pyfvs/cfg/species/bu_buckeye.yaml +252 -0
pyfvs/cfg/species/by_bald_cypress.yaml +255 -0
pyfvs/cfg/species/ca_american_chestnut.yaml +254 -0
pyfvs/cfg/species/cb_cucumber_tree.yaml +254 -0
pyfvs/cfg/species/ck_virginia_pine.yaml +254 -0
pyfvs/cfg/species/co_pond_cypress.yaml +251 -0
pyfvs/cfg/species/ct_catalpa.yaml +251 -0
pyfvs/cfg/species/cw_chestnut_oak.yaml +253 -0
pyfvs/cfg/species/dw_dogwood.yaml +250 -0
pyfvs/cfg/species/el_american_hornbeam.yaml +254 -0
pyfvs/cfg/species/fm_flowering_dogwood.yaml +251 -0
pyfvs/cfg/species/fr_fraser_fir.yaml +247 -0
pyfvs/cfg/species/ga_green_ash.yaml +254 -0
pyfvs/cfg/species/ha_hawthorn.yaml +252 -0
pyfvs/cfg/species/hb_hornbeam.yaml +254 -0
pyfvs/cfg/species/hh_dogwood.yaml +251 -0
pyfvs/cfg/species/hi_hickory_species.yaml +252 -0
pyfvs/cfg/species/hl_holly.yaml +254 -0
pyfvs/cfg/species/hm_eastern_hemlock.yaml +246 -0
pyfvs/cfg/species/hy_holly.yaml +252 -0
pyfvs/cfg/species/ju_eastern_juniper.yaml +247 -0
pyfvs/cfg/species/lb_loblolly_bay.yaml +254 -0
pyfvs/cfg/species/lk_laurel_oak.yaml +254 -0
pyfvs/cfg/species/ll_longleaf_pine.yaml +265 -0
pyfvs/cfg/species/lo_silver_maple.yaml +252 -0
pyfvs/cfg/species/lp_loblolly_pine.yaml +268 -0
pyfvs/cfg/species/mb_mountain_birch.yaml +250 -0
pyfvs/cfg/species/mg_magnolia.yaml +251 -0
pyfvs/cfg/species/ml_maple_leaf.yaml +254 -0
pyfvs/cfg/species/ms_maple_species.yaml +247 -0
pyfvs/cfg/species/mv_magnolia_vine.yaml +254 -0
pyfvs/cfg/species/oh_other_hardwood.yaml +231 -0
pyfvs/cfg/species/os_other_softwood.yaml +232 -0
pyfvs/cfg/species/ot_other_tree.yaml +210 -0
pyfvs/cfg/species/ov_overcup_oak.yaml +254 -0
pyfvs/cfg/species/pc_pond_cypress.yaml +254 -0
pyfvs/cfg/species/pd_pitch_pine.yaml +245 -0
pyfvs/cfg/species/pi_pine_species.yaml +246 -0
pyfvs/cfg/species/po_american_beech.yaml +254 -0
pyfvs/cfg/species/pp_pond_pine.yaml +246 -0
pyfvs/cfg/species/ps_persimmon.yaml +251 -0
pyfvs/cfg/species/pu_pond_pine.yaml +249 -0
pyfvs/cfg/species/qs_flowering_dogwood.yaml +254 -0
pyfvs/cfg/species/ra_red_ash.yaml +245 -0
pyfvs/cfg/species/rd_redbud.yaml +251 -0
pyfvs/cfg/species/rl_red_elm.yaml +240 -0
pyfvs/cfg/species/rm_red_maple.yaml +256 -0
pyfvs/cfg/species/ro_eastern_hemlock.yaml +255 -0
pyfvs/cfg/species/sa_slash_pine.yaml +265 -0
pyfvs/cfg/species/sb_sweet_birch.yaml +255 -0
pyfvs/cfg/species/sd_sand_pine.yaml +251 -0
pyfvs/cfg/species/sk_swamp_oak.yaml +253 -0
pyfvs/cfg/species/sm_sugar_maple.yaml +252 -0
pyfvs/cfg/species/sn_loblolly_pine.yaml +254 -0
pyfvs/cfg/species/so_southern_oak.yaml +253 -0
pyfvs/cfg/species/sp_shortleaf_pine.yaml +267 -0
pyfvs/cfg/species/sr_spruce_pine.yaml +246 -0
pyfvs/cfg/species/ss_basswood.yaml +251 -0
pyfvs/cfg/species/su_sweetgum.yaml +255 -0
pyfvs/cfg/species/sv_silver_maple.yaml +255 -0
pyfvs/cfg/species/sy_sycamore.yaml +254 -0
pyfvs/cfg/species/tm_tamarack.yaml +246 -0
pyfvs/cfg/species/to_tulip_oak.yaml +254 -0
pyfvs/cfg/species/ts_tulip_tree.yaml +253 -0
pyfvs/cfg/species/vp_virginia_pine.yaml +248 -0
pyfvs/cfg/species/wa_white_ash.yaml +254 -0
pyfvs/cfg/species/we_white_elm.yaml +250 -0
pyfvs/cfg/species/wi_willow.yaml +248 -0
pyfvs/cfg/species/wk_water_oak.yaml +254 -0
pyfvs/cfg/species/wn_walnut.yaml +254 -0
pyfvs/cfg/species/wo_white_oak.yaml +256 -0
pyfvs/cfg/species/wp_white_pine.yaml +250 -0
pyfvs/cfg/species/wt_water_tupelo.yaml +254 -0
pyfvs/cfg/species/yp_yellow_poplar.yaml +261 -0
pyfvs/cfg/species_config.yaml +106 -0
pyfvs/clark_profile.py +323 -0
pyfvs/competition.py +332 -0
pyfvs/config_loader.py +375 -0
pyfvs/crown_competition_factor.py +464 -0
pyfvs/crown_ratio.py +377 -0
pyfvs/crown_width.py +512 -0
pyfvs/data_export.py +356 -0
pyfvs/ecological_unit.py +272 -0
pyfvs/exceptions.py +86 -0
pyfvs/fia_integration.py +876 -0
pyfvs/forest_type.py +253 -0
pyfvs/growth_plots.py +579 -0
pyfvs/harvest.py +603 -0
pyfvs/height_diameter.py +248 -0
pyfvs/large_tree_height_growth.py +822 -0
pyfvs/logging_config.py +213 -0
pyfvs/main.py +99 -0
pyfvs/mortality.py +431 -0
pyfvs/parameters.py +121 -0
pyfvs/simulation_engine.py +386 -0
pyfvs/stand.py +1004 -0
pyfvs/stand_metrics.py +436 -0
pyfvs/stand_output.py +552 -0
pyfvs/tree.py +756 -0
pyfvs/validation.py +190 -0
pyfvs/volume_library.py +761 -0

pyfvs/cfg/species/hb_hornbeam.yaml ADDED Viewed

@@ -0,0 +1,254 @@
+metadata:
+  code: HB
+  fia_code: 391
+  scientific_name: Carpinus caroliniana
+  common_name: hornbeam
+  valid_site_species: false
+site_index:
+  min: 15
+  max: 90
+  site_index_group: 1
+  height_growth_equation: 'NC-128: 068/73'
+density:
+  sdi_max: 420
+height_diameter:
+  model: curtis_arney
+  curtis_arney:
+    p2: 484.7529797
+    p3: 3.93933286
+    p4: -0.25998833
+    dbw: 0.1
+  wykoff:
+    b1: 4.4207
+    b2: -5.1435
+bark_ratio:
+  b1: -0.18338
+  b2: 0.95768
+crown_ratio:
+  acr_equation: 4.3.1.6
+  d0: 50.8266
+  d1: -14.5261
+  d2: null
+  a: 4.5671
+  b0: -49.1736
+  b1: 2.1311
+  c: 2.9883
+diameter_growth:
+  model: ln_dds
+  coefficients:
+    b1: -0.833167
+    b2: 1.190567
+    b3: 0.0
+    b4: 0.193368
+    b5: 0.508738
+    b6: -5.6e-05
+    b7: -0.001846
+    b8: -0.001776
+    b9: -0.179044
+    b10: 0.039673
+    b11: -0.071628
+  dbh_bounds:
+    lower_limit: 32.9
+    upper_limit: 60.0
+volume:
+  pulpwood:
+    min_dbh: 6
+    top_diameter: 4
+  sawtimber:
+    min_dbh: 10
+    top_diameter: 7
+crown_width:
+  forest_grown:
+    equation_number: '46201'
+    a1: 7.1043
+    a2: 1.3041
+    a3: null
+    a4: 0.0456
+    a5: null
+    bounds: FCW < 51
+  open_grown:
+    equation_number: '46201'
+    a1: 7.1043
+    a2: 1.3041
+    a3: null
+    a4: 0.0456
+    a5: null
+    bounds: OCW < 51
+small_tree_height_growth:
+  model: chapman_richards_nc128
+  threshold_diameter: 3.0
+  fia_code: 068
+  page_number: '73'
+  c1: 0.9276
+  c2: 1.0591
+  c3: -0.0424
+  c4: 0.3529
+  c5: 0.3114
+large_tree_height_growth:
+  model: wensel_1987
+  threshold_diameter: 3.0
+  methodology:
+    approach: Wensel and others (1987)
+    crown_ratio_weight: 0.25
+    relative_height_weight: 0.75
+  equations:
+    main: HTG = POTHTG * (0.25 * HGMDCR + 0.75 * HGMDRH)
+    crown_ratio_modifier: HGMDCR = 100 * CR^3.0 * exp(-5.0*CR)
+    relative_height_modifier: HGMDRH = RHK * (1 + FCTRKX * exp(FCTRRB*FCTRXB))^FCTRM
+  shade_tolerance: Intermediate
+  shade_tolerance_coefficients:
+    RHR: 15
+    RHYXS: 0.1
+    RHM: 1.1
+    RHB: -1.45
+    RHXS: 0
+    RHK: 1
+fortype:
+  base_fortype: FTLOHD
+  coefficients:
+    FTLOHD: 0.0
+    FTNOHD: -0.020917
+    FTOKPN: -0.227013
+    FTSFHP: 0.0
+    FTUPHD: -0.0466
+    FTUPOK: -0.142184
+    FTYLPN: -0.37316
+  forest_type_groups:
+    FTLOHD:
+      name: Lowland Hardwoods
+      fia_forest_types:
+      - 168
+      - 508
+      - 601
+      - 602
+      - 605
+      - 606
+      - 607
+      - 608
+      - 702
+      - 703
+      - 704
+      - 705
+      - 706
+      - 708
+    FTNOHD:
+      name: Northern Hardwoods
+      fia_forest_types:
+      - 701
+      - 801
+      - 805
+    FTOKPN:
+      name: Oak - Pine
+      fia_forest_types:
+      - 165
+      - 403
+      - 404
+      - 405
+      - 406
+      - 407
+      - 409
+    FTSFHP:
+      name: Spruce - Fir - Hemlock - Pine
+      fia_forest_types:
+      - 104
+      - 105
+      - 121
+      - 124
+    FTUPHD:
+      name: Upland Hardwoods
+      fia_forest_types:
+      - 103
+      - 167
+      - 181
+      - 401
+      - 402
+      - 506
+      - 511
+      - 512
+      - 513
+      - 519
+      - 520
+      - 802
+      - 807
+      - 809
+    FTUPOK:
+      name: Upland Oak
+      fia_forest_types:
+      - 501
+      - 502
+      - 503
+      - 504
+      - 505
+      - 510
+      - 514
+      - 515
+    FTYLPN:
+      name: Yellow Pine
+      fia_forest_types:
+      - 141
+      - 142
+      - 161
+      - 162
+      - 163
+      - 164
+      - 166
+ecounit:
+  table_4_7_1_5:
+    base_ecounit: '234'
+    coefficients:
+      M221: -0.435211
+      M222: -0.117993
+      M231: -0.495339
+      '221': -0.347813
+      '222': -0.336521
+      231T: -0.32578
+    ecological_unit_groups:
+      M221: Ecological unit group M221
+      M222: Ecological unit group M222
+      M231: Ecological unit group M231
+      '221': Ecological unit group 221
+      '222': Ecological unit group 222
+      231T: Ecological unit group 231T
+      231L: Ecological unit group 231L
+      '232': Ecological unit group 232
+      '234': Ecological unit group 234
+      '255': Ecological unit group 255
+      '411': Ecological unit group 411
+  table_4_7_1_6:
+    base_ecounit: '234'
+    coefficients:
+      231L: -0.130359
+      '232': -0.212093
+      '234': 0.0
+      '255': -0.208957
+      '411': 0.0
+    ecological_unit_groups:
+      231L: Ecological unit group 231L
+      '232': Ecological unit group 232
+      '234': Ecological unit group 234
+      '255': Ecological unit group 255
+      '411': Ecological unit group 411
+mortality:
+  background_mortality:
+    equation: 5.0.1
+    formula: RI = [1 / (1 + exp(p0 + p1 * DBH))]
+    coefficients:
+      p0: 5.9617
+      p1: -0.0340128
+  mortality_weight:
+    mwt: 0.5
+    description: Species-specific mortality weight value representing shade tolerance
+regeneration:
+  parameters:
+    sprouting_capable: true
+    min_bud_width: 0.1
+    min_height: 2.08
+    max_height: 20
+  sprouting:
+    probability: equation_6.0.3
+    equation: 6.0.3
+    sprout_records: 1
+    source: Keyser and Loftis, 2014
+    coefficients:
+      b0: 2.7386
+      b1: -0.1076

pyfvs/cfg/species/hh_dogwood.yaml ADDED Viewed

@@ -0,0 +1,251 @@
+metadata:
+  code: HH
+  fia_code: 491
+  scientific_name: Cornus florida
+  common_name: dogwood
+  valid_site_species: false
+site_index:
+  min: 15
+  max: 40
+  site_index_group: 3
+  height_growth_equation: 'NC-128: 068/73'
+density:
+  sdi_max: 304
+height_diameter:
+  model: curtis_arney
+  curtis_arney:
+    p2: 109.7324294
+    p3: 2.25025802
+    p4: -0.41297463
+    dbw: 0.2
+  wykoff:
+    b1: 4.0322
+    b2: -3.0833
+bark_ratio:
+  b1: -0.42001
+  b2: 0.94264
+crown_ratio:
+  acr_equation: 4.3.1.6
+  d0: 52.7207
+  d1: -11.484
+  d2: null
+  a: 5.0
+  b0: 15.0407
+  b1: 0.6546
+  c: 3.0344
+diameter_growth:
+  model: ln_dds
+  coefficients:
+    b1: -1.431973
+    b2: 1.452294
+    b3: -0.001475
+    b4: 0.061077
+    b5: -0.208915
+    b6: 0.004856
+    b7: -0.003145
+    b8: 0.0
+    b9: -0.422675
+    b10: -0.236535
+    b11: 0.201149
+  dbh_bounds:
+    lower_limit: 18.6
+    upper_limit: 24.0
+volume:
+  pulpwood:
+    min_dbh: 6
+    top_diameter: 4
+  sawtimber:
+    min_dbh: 10
+    top_diameter: 7
+crown_width:
+  forest_grown:
+    equation_number: '70101'
+    a1: 7.8084
+    a2: 0.8129
+    a3: null
+    a4: 0.0941
+    a5: -0.0817
+    bounds: FCW < 39
+  open_grown:
+    equation_number: '70101'
+    a1: 7.8084
+    a2: 0.8129
+    a3: null
+    a4: 0.0941
+    a5: -0.0817
+    bounds: OCW < 39
+small_tree_height_growth:
+  model: chapman_richards_nc128
+  threshold_diameter: 3.0
+  fia_code: 068
+  page_number: '73'
+  c1: 0.9276
+  c2: 1.0591
+  c3: -0.0424
+  c4: 0.3529
+  c5: 0.3114
+large_tree_height_growth:
+  model: wensel_1987
+  threshold_diameter: 3.0
+  methodology:
+    approach: Wensel and others (1987)
+    crown_ratio_weight: 0.25
+    relative_height_weight: 0.75
+  equations:
+    main: HTG = POTHTG * (0.25 * HGMDCR + 0.75 * HGMDRH)
+    crown_ratio_modifier: HGMDCR = 100 * CR^3.0 * exp(-5.0*CR)
+    relative_height_modifier: HGMDRH = RHK * (1 + FCTRKX * exp(FCTRRB*FCTRXB))^FCTRM
+  shade_tolerance: Tolerant
+  shade_tolerance_coefficients:
+    RHR: 16
+    RHYXS: 0.15
+    RHM: 1.1
+    RHB: -1.2
+    RHXS: 0
+    RHK: 1
+fortype:
+  base_fortype: FTLOHD
+  coefficients:
+    FTLOHD: 0.0
+    FTNOHD: -0.154634
+    FTOKPN: -0.087145
+    FTSFHP: 0.0
+    FTUPHD: -0.071133
+    FTUPOK: -0.204189
+    FTYLPN: 0.120468
+  forest_type_groups:
+    FTLOHD:
+      name: Lowland Hardwoods
+      fia_forest_types:
+      - 168
+      - 508
+      - 601
+      - 602
+      - 605
+      - 606
+      - 607
+      - 608
+      - 702
+      - 703
+      - 704
+      - 705
+      - 706
+      - 708
+    FTNOHD:
+      name: Northern Hardwoods
+      fia_forest_types:
+      - 701
+      - 801
+      - 805
+    FTOKPN:
+      name: Oak - Pine
+      fia_forest_types:
+      - 165
+      - 403
+      - 404
+      - 405
+      - 406
+      - 407
+      - 409
+    FTSFHP:
+      name: Spruce - Fir - Hemlock - Pine
+      fia_forest_types:
+      - 104
+      - 105
+      - 121
+      - 124
+    FTUPHD:
+      name: Upland Hardwoods
+      fia_forest_types:
+      - 103
+      - 167
+      - 181
+      - 401
+      - 402
+      - 506
+      - 511
+      - 512
+      - 513
+      - 519
+      - 520
+      - 802
+      - 807
+      - 809
+    FTUPOK:
+      name: Upland Oak
+      fia_forest_types:
+      - 501
+      - 502
+      - 503
+      - 504
+      - 505
+      - 510
+      - 514
+      - 515
+    FTYLPN:
+      name: Yellow Pine
+      fia_forest_types:
+      - 141
+      - 142
+      - 161
+      - 162
+      - 163
+      - 164
+      - 166
+ecounit:
+  table_4_7_1_5:
+    base_ecounit: '232'
+    coefficients:
+      M221: -0.041534
+      M222: 0.13042
+      M231: 0.212883
+      '221': 0.110701
+      '222': -0.130543
+      231T: -0.02585
+    ecological_unit_groups:
+      M221: Ecological unit group M221
+      M222: Ecological unit group M222
+      M231: Ecological unit group M231
+      '221': Ecological unit group 221
+      '222': Ecological unit group 222
+      231T: Ecological unit group 231T
+      231L: Ecological unit group 231L
+      '232': Ecological unit group 232
+      '234': Ecological unit group 234
+      '255': Ecological unit group 255
+      '411': Ecological unit group 411
+  table_4_7_1_6:
+    base_ecounit: '232'
+    coefficients:
+      231L: 0.087497
+      '232': 0.0
+      '234': 0.018385
+      '255': 0.255056
+      '411': 0.0
+    ecological_unit_groups:
+      231L: Ecological unit group 231L
+      '232': Ecological unit group 232
+      '234': Ecological unit group 234
+      '255': Ecological unit group 255
+      '411': Ecological unit group 411
+mortality:
+  background_mortality:
+    equation: 5.0.1
+    formula: RI = [1 / (1 + exp(p0 + p1 * DBH))]
+    coefficients:
+      p0: 5.1676998
+      p1: -0.0077681
+  mortality_weight:
+    mwt: 0.3
+    description: Species-specific mortality weight value representing shade tolerance
+regeneration:
+  parameters:
+    sprouting_capable: true
+    min_bud_width: 0.2
+    min_height: 2.08
+    max_height: 20
+  sprouting:
+    probability: 0.94
+    equation: fixed
+    sprout_records: 1
+    source: Keyser and Loftis, 2014