Conditions of use
Downloading the code implies agreement to these conditions.
- Any researcher and organ can use SEIB-DGVM for research purposes. For other usage, please contact to Dr Hisashi SATO and obtain permission beforehand.
- The code is provided with no guarantees on the output’s accuracy, correctness, or utility.
- Redistribution of modified code is only allowed with the explicit permission of Dr. Hisashi SATO.
- Publications should adequately cite the authors of the SEIB-DGVM (see Publications page). I would appreciate it if you sent me the results of the publications!
SEIB-DGVM Distribution Packages
The distributed code is a point simulation version; it simulates only a single virtual forest (grassland). The setting area of the virtual forest is 30m x 30m, but you can easily change it by modifying the configuration file. For the simulation of multiple plots (regional scale or global scale), please refer to related information and code in the “code>mpi” folder.
SEIB-DGVM is written in Fortran90. We are developing and validating the code under Intel FORTRAN Compiler 11.0 (Linux version). But, we confirmed that the code can also work on gfortran (MinGW-w64 based).
Newer versions:
* version3.13 -> seib_code313.zip
* version3.12 -> seib_code312.zip
* version3.11 -> seib_code311.zip
* version3.10 -> seib_code310.zip (This version corresponds with Sato et al. 2020, Sato et al. 2023) (Updated the model description document on 13 June 2023!)
Legacy versions
* version3.03 -> seib_code303.zip (Updated the model description document on 08 June 2023!)
* version3.02 -> seib_code302.zip
* version3.01 -> seib_code301.zip
* version3.00 -> seib_code300.zip (This version corresponds with Sato et al. 2016)
* version2.82 -> seib_code282.zip
* version2.81 -> seib_code281.zip
* version2.80 -> seib_code280.zip (This version corresponds with Sato et al. 2015)
* version2.71 -> seib_code271.zip
* version2.70 -> seib_code270.zip (This version corresponds with Sato & Ise, 2012)
* version2.62 -> seib_code262.zip
* version2.61 -> seib_code261.zip
* version2.60 -> seib_code260.zip
* version2.55 -> seib_code255.zip
* version2.54 -> seib_code254.zip
* version2.53 -> seib_code253.zip
* version2.52 -> seib_code252.zip
* version2.51 -> seib_code251.zip
* version2.50 -> seib_code250.zip
* version2.42 -> seib_code242.zip (This version corresponds with Sato et al., 2010)
* version2.41 -> seib_code241.zip
* version2.40 -> seib_code240.zip
* version2.30 -> seib_code230.zip (This version corresponds with Sato, 2009)
* version2.20 -> seib_code220.zip
* version2.11 -> seib_code211.zip
* version2.10 -> seib_code210.zip
* version2.00 -> seib_code200.zip
* version1.43 -> seib_code143.zip
* version1.42 -> seib_code142.zip
* version1.41 -> seib_code141.zip
* version1.40 -> seib_code140.zip (This version corresponds with Sato et al., 2007)
* version1.31 -> seib_code131.zip
* version1.30 -> seib_code130.zip
* version1.20 -> seib_code120.zip
* version1.10 -> seib_code110.zip
* version1.02 -> seib_code102.zip
* version1.01 -> seib_code101.zip
* version1.00 -> seib_code100.zip
* TOPMODL implemented version (This version corresponds with Sato et al. 2020) –> seib_code_TOPMODEL.zip
Update history (Only form version 3.00)
****** ver3.12 -> ver3.13 ******
Only the subroutine output_for_viewer2 in output.f90 has been modified. The types of data and the format written to the file "output_for_viewer2.txt" by this subroutine have been changed. This "output_for_viewer2.txt" is an input file for SEIB-Explorer 1.20 (and future versions planned).
****** ver3.11 -> ver3.12 ******
(1) I added the subroutine "output_VegStructure" and the subroutine "output_for_viewer2" to output.f90. These subroutines add the yearly maximum leaf area index (LAI) output for the herbaceous layer to the existing subroutines "output_forest" and "output_for_viewer". These subroutines generate the output files "output_VegStructure.txt" and "output_for_viewer2.txt", respectively. The "output_VegStructure.txt" is the output file for the simulation result viewer SEIB-Explorer 1.10, which includes a function to visualize the herbaceous layer. The "output_for_viewer2.txt" is for inputting future versions of the SEIB-Explorer, where I plan to add more functions.
(2) I changed the FR_ratio of C3 herbaceous plants from 0.12 to 0.5, and the FR_ratio of C4 herbaceous plants from 0.10 to 0.5. I documented the reason for this change in Table B4 of the "Model_description (240902).doc" included in the distribution package.
****** ver3.10 -> ver3.11 ******
Only minor bug fixes.
(1) For biome determination, newly introduced PFTs (Cold-temperate trees) in version 3.10 were taken into consideration (@Subroutine biome_determine in etc.f90 )
(2) Enabled tropical-rain-green trees (PFT6, TrBR) to be established outside Africa. (@Line 118 of population_regu.f90)
(3) Preventing zero division even if Pmax is zero. (@Line 370 of metabolic.f90. )
(4) Avoided an undefined SOILTYP being employed. (@Lines 305-322 of main.f90)
(5) Disabled establishment of PFTs 17 and 18, which are not yet implemented. (@Lines 120-130 of population_regu.f90)
(6) I provided a default value of "1" for the parameter SLOPETYP. (@Line 303 of main.f90)
****** ver3.03 -> ver3.10 ******
This update corresponds to Sato et al. (2022) Ecological Research, in which the SEIB-DGVM was adapted to cold-tempearte forest in Northmost part of Japan.
(1) Following six PFTs were newly added.
PFT number: Description of the PFT (Abbreviate PFT name), Life_type
10: Cold-temperate needle-leaved evergreen, Late-succession (CTeNE1), 7
11: Cold-temperate needle-leaved evergreen, Middle-succession (CTeNE2), 7
12: Cold-temperate broad-leaved summergreen, Early-succession, drought-tolerant (CTeBS1), 8
13: Cold-temperate broad-leaved summergreen, Early-succession, drought-intolerant(CTeBS2), 8
14: Cold-temperate broad-leaved summergreen, Late-succession, drought-tolerant (CTeBS3), 8
15: Cold-temperate broad-leaved summergreen, Late-succession, drought-intolerant (CTeBS4), 8
(2) Leaf metabolic properties (Pmax, SLA, PN_f) of the newly introduced PFT are given as functions of leaf longevity. This procedure is conducted once a year (L838-890 in main_point.f90 and L845-893 in main.f90) because the relative light environment for each tree would also control these properties in upcoming updates.
(3) Soil wetness regulation in photosynthesis was changed and implemented in L232-235 in metabolic.f90. For this modification, the following PFT-specific parameters were introduced.
real,dimension(PFT_no)::Stat_water_opt !Optimum stat_water for photosynthesis (frac)
real,dimension(PFT_no)::Stat_water_min !Minimum stat_water for photosynthesis (frac)
real,dimension(PFT_no)::Stat_water_max !Maximum stat_water for photosynthesis (frac)
(4) Differences in CTI (Composite Terrestrial Index) of the simulation site to the grid average can be taken into consideration. For implementing this feature, a variable CTI_dif is newly defined.
(5) For the climatic envelope, which determines the climatic condition for the establishment of each woody PFT, an option was introduced so that its sharpness was reduced.
Implemented in L93-120 of population_regu.f90
(6) Two variables (par_rel_sum and par_rel_count) were introduced for daily summing up of relative PAR intensity on the crown of each tree. This sumup is only done when the tree is in the growth period. This implementation is not used in the current version but may be used for controlling leaf metabolic properties in upcoming updates.
****** ver3.02 -> ver3.03 ******
Minor bug fixes. MPI packages
Also, I prepared sample environment for small MPI computation.
Climate data for sample small MPI run can be obtained on the net.
See the readme_mpi.txt for detail.
****** ver3.01 -> ver3.02 ******
Only the SEIB-Viewer was updated. No change has been done for the SEIB-DGVM.
****** ver3.00 -> ver3.01 ******
Only minor bug fixes.
SEIB-Explorer
This Windows software is for interactively visualizing forest dynamics from a single location simulated by SEIB-DGVM (with file names output_forest.txt or output_VegStructure.txt). The software includes a “realistic” representation feature that emphasizes enjoyment and engagement, making it primarily suitable for educational and presentation purposes rather than for research. This software also has a “Simplified View” feature that represents the tree shapes assumed in the model (i.e., SEIB-DGVM assumes cylindrical shapes for canopies and trunks), which is for more academic uses.
Further explanation
[Input Files]
The software accepts "output_forest.txt," "output_VegStructure.txt," and "output_for_viewer2.txt" as input files. Note that the last file can only be used if it was output by SEIB-DGVM v3.13 (and later versions).
The last two types of file contain information about the herbaceous layer (annual maximum LAI per forest floor tile). When this file is loaded, a "Change Display Target" icon appears. Each time you click the icon, the visualization toggles between "Woody plants only" -> "Woody plants + Herbaceous layer" -> "Herbaceous layer only" -> and back to the original state.
The last type of file includes time-series outputs related to biogeochemical cycles. When this type of file is loaded, the annual averages of the carbon and water cycles are output.
[Viewpoint Movement]
The viewpoint is always directed toward the center of the virtual forest stand. You can change the viewing angle by dragging the forest displayed on the screen with the mouse. Additionally, you can adjust the distance to the viewpoint using the mouse wheel.
[Note]
(1) SEIB-Explorer 1.00-1.10 assumes the allocation of woody plant PFT numbers based on SEIB-DGVM version 3.10 and later. Therefore, when visualizing output from earlier versions, the legend labels may not correspond accurately to the actual data.
(2) In version 1.10 and earlier, the cylindrical representation of trees displayed in this view may not precisely match the numerical values or sizes in the simulation file. When creating figures for academic publications, please use the PovRay code (file extension ".pov") included with the simulation code.
* version1.20 -> SEIB_Explorer1.20_Installer.exe
* version1.10 -> SEIB_Explorer1.10_Installer.exe
* Sample data for SEIB-Explorer (compressed using ZIP) -> Sample_for_SEIB_Explorer.zip
Update history
****** ver1.10 -> ver1.20 (8 Oct 2024) ******
New Feature
I added a new feature to display only the carbon and water cycles (annual average values). For this feature, input the "output_for_viewer2.txt" file generated by SEIB-DGVM v3.13 (and expected later). Although SEIB-DGVM v3.12 also generates an output file with the same name, it cannot be used. It is also possible to visualize forest structure by reading the "output_forest.txt" and "output_VegStructure.txt" files as before, but in this case, the carbon/water cycles will not be visualized.
Bug Fixe
I fixed an issue where trunk thickness was overly exaggerated in the Simplified view. This issue has persisted since the last version, but I believe it has been fully resolved in this update.
****** ver1.00 -> ver1.10 (10 Sep 2024) ******
New Features
I added a new feature for visualizing the herbaceous layer. Each time you click the "Change Display Target" icon, the visualization will toggle through "Woody plants only" → "Woody plants + Herbaceous layer" → "Herbaceous layer only" → and back to the original state. For this feature, input the "output_VegStructure.txt" file generated by SEIB-DGVM v3.20. It is also possible to visualize forest structure by reading the "output_forest.txt" file as before, but the herbaceous layer will not be visualized in this case.
Bug Fixes
I fixed an issue where trunk thickness was overly exaggerated in the Simplistic view. Unfortunately, this bug still happens sometimes. I will fix it perfectly in the next update.
I fixed an issue where the horizontal coordinates of the visualized virtual stand were reversed.
I fixed a problem where small woody plants were displayed with incorrect PFTs.
****** ver1.0 (9 Aug 2024) ******
Released
SEIB-Viewer
This Windows software interactively visualizes the result from a single location simulated by SEIB-DGVM (with file names output.txt). The help file, accessible from within the program, provides further explanations about the software. Currently (Sep 2024), I am transferring the functions of SEIB-Viewer to SEIB-Explorer.
* Version 3.1 –> SEIB-Viewer3.1.zip
* Sample data for inputting the SEIB-Viewer 3.1 –> sample_for_SV3.1.zip
[Legacy] Sample of climatic data for running SEIB-DGVM
Climatic data sample for SEIB-DGVM ver1.41 and earlier. Sample climatic data for SEIB-DGVM ver1.42 and later is included in the distribution package.
[Legacy] Virtual Forest Viewer
This Windows software enables the visualization of the 3D structure of simulated forests. After the SEIB-DGVM 3.0, I included all functions of this software in the SEIB-Viewer.
* Program –> ForestViewer_1.0.zip
* Sample input data –> sample_ForestViewer.zip
SEIB-DGVM Official Logo and Icon
Fair use, please. Transparent PNG format.
Official Logo, Official Icon, SEIB-Explorer Icon