From ae8acb6e7e3a5d9cbb8b0eca16f941a04afb02ff Mon Sep 17 00:00:00 2001 From: Namya LG Date: Mon, 19 Dec 2022 14:57:28 +0530 Subject: [PATCH 1/6] chore: setup docs for Colombia, added steps to run simulation on Windows and Docker --- .gitignore | 6 + docs/Makefile | 20 ++++ docs/assets/install_tools.PNG | Bin 0 -> 41598 bytes docs/conf.py | 52 +++++++++ docs/index.rst | 14 +++ docs/make.bat | 35 ++++++ docs/requirements.txt | 1 + docs/run_simulation/docker.rst | 59 ++++++++++ docs/run_simulation/index.rst | 27 +++++ docs/run_simulation/windows.rst | 199 ++++++++++++++++++++++++++++++++ 10 files changed, 413 insertions(+) create mode 100644 .gitignore create mode 100644 docs/Makefile create mode 100644 docs/assets/install_tools.PNG create mode 100644 docs/conf.py create mode 100644 docs/index.rst create mode 100644 docs/make.bat create mode 100644 docs/requirements.txt create mode 100644 docs/run_simulation/docker.rst create mode 100644 docs/run_simulation/index.rst create mode 100644 docs/run_simulation/windows.rst diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..4c6b28c --- /dev/null +++ b/.gitignore @@ -0,0 +1,6 @@ +Postprocessing/.Rproj.user +Postprocessing/.Rhistory +Postprocessing/.RData +Postprocessing/.Ruserdata +Postprocessing/renv/library +docs/_build diff --git a/docs/Makefile b/docs/Makefile new file mode 100644 index 0000000..d4bb2cb --- /dev/null +++ b/docs/Makefile @@ -0,0 +1,20 @@ +# Minimal makefile for Sphinx documentation +# + +# You can set these variables from the command line, and also +# from the environment for the first two. +SPHINXOPTS ?= +SPHINXBUILD ?= sphinx-build +SOURCEDIR = . +BUILDDIR = _build + +# Put it first so that "make" without argument is like "make help". +help: + @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + +.PHONY: help Makefile + +# Catch-all target: route all unknown targets to Sphinx using the new +# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). +%: Makefile + @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/docs/assets/install_tools.PNG b/docs/assets/install_tools.PNG new file mode 100644 index 0000000000000000000000000000000000000000..b474a3f4d4d5773038ce0932f6e3252f998cabb9 GIT binary patch literal 41598 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 literal 0 HcmV?d00001 diff --git a/docs/conf.py b/docs/conf.py new file mode 100644 index 0000000..1f9368d --- /dev/null +++ b/docs/conf.py @@ -0,0 +1,52 @@ +# Configuration file for the Sphinx documentation builder. +# +# This file only contains a selection of the most common options. For a full +# list see the documentation: +# https://www.sphinx-doc.org/en/master/usage/configuration.html + +# -- Path setup -------------------------------------------------------------- + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +# +# import os +# import sys +# sys.path.insert(0, os.path.abspath('.')) + + +# -- Project information ----------------------------------------------------- + +project = 'GCBM Colombia' +copyright = '2022, moja global' +author = 'moja global' + + +# -- General configuration --------------------------------------------------- + +# Add any Sphinx extension module names here, as strings. They can be +# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom +# ones. +extensions = [ +] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +# This pattern also affects html_static_path and html_extra_path. +exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] + + +# -- Options for HTML output ------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +# +html_theme = 'furo' + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst new file mode 100644 index 0000000..f1e3cda --- /dev/null +++ b/docs/index.rst @@ -0,0 +1,14 @@ +GCBM Colombia +============= + +This is the official documentation of the GCBM Colombia project. +This project is based on the `Standalone Template for the GCBM `_ + +**Disclaimer : The calculations performed in this repository are not official and do not represent the Government of Colombia in any way.** + +.. toctree:: + :hidden: + + run_simulation/index.rst + + diff --git a/docs/make.bat b/docs/make.bat new file mode 100644 index 0000000..922152e --- /dev/null +++ b/docs/make.bat @@ -0,0 +1,35 @@ +@ECHO OFF + +pushd %~dp0 + +REM Command file for Sphinx documentation + +if "%SPHINXBUILD%" == "" ( + set SPHINXBUILD=sphinx-build +) +set SOURCEDIR=. +set BUILDDIR=_build + +if "%1" == "" goto help + +%SPHINXBUILD% >NUL 2>NUL +if errorlevel 9009 ( + echo. + echo.The 'sphinx-build' command was not found. Make sure you have Sphinx + echo.installed, then set the SPHINXBUILD environment variable to point + echo.to the full path of the 'sphinx-build' executable. Alternatively you + echo.may add the Sphinx directory to PATH. + echo. + echo.If you don't have Sphinx installed, grab it from + echo.http://sphinx-doc.org/ + exit /b 1 +) + +%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% +goto end + +:help +%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% + +:end +popd diff --git a/docs/requirements.txt b/docs/requirements.txt new file mode 100644 index 0000000..9e279e7 --- /dev/null +++ b/docs/requirements.txt @@ -0,0 +1 @@ +furo \ No newline at end of file diff --git a/docs/run_simulation/docker.rst b/docs/run_simulation/docker.rst new file mode 100644 index 0000000..e4b1601 --- /dev/null +++ b/docs/run_simulation/docker.rst @@ -0,0 +1,59 @@ +On Docker +========= + +Install Docker and docker-compose based on your `operating system `_ . + +Steps to run the Colombia simulation in a docker environment + +1. Clone the `docker-setup` branch of `GCBM Colombia `_ using the command + +.. code-block:: bash + + git clone -b docker-setup https://github.com/moja-global/GCBM.Colombia + + +2. Navigate into `GCBM.Colombia` + +.. code-block:: bash + + cd GCBM.Colombia + + +3. Use docker-compose to build the image + +.. code-block:: bash + + docker-compose up -d + + +If an error with the following message appears : + +`ERROR: Version in "./docker-compose.yml" is unsupported. You might be seeing this error because you're using the wrong Compose file version. Either specify a supported version (e.g "2.2" or "3.3") and place your service definitions under the services key, or omit the version key and place your service definitions at the root of the file to use version 1. +For more on the Compose file format versions, see https://docs.docker.com/compose/compose-file/` + +Change the docker version in the file `./docker-compose.yml` to an appropriate version and run the command again. + + +4. Run the container using the command + +.. code-block:: bash + + docker exec -it gcbm-colombia /bin/bash + + +5. Inside the running docker container, run + +.. code-block:: bash + + cd /server/gcbm_project + + +6. Start the simulation using + +.. code-block:: bash + + /opt/gcbm/moja.cli --config_file gcbm_config.cfg --config_provider provider_config.json + + +If there are existing images cached on your machine you may need to docker pull ghcr.io/moja-global/rest_api_gcbm:master +and build the container using `docker-compose -d --force-recreate` \ No newline at end of file diff --git a/docs/run_simulation/index.rst b/docs/run_simulation/index.rst new file mode 100644 index 0000000..2421517 --- /dev/null +++ b/docs/run_simulation/index.rst @@ -0,0 +1,27 @@ +Running the Colombia simulation +=============================== + +A local simulation of the GCBM model is run for the Colombia region can be run locally. + +The repository is located at: https://github.com/moja-global/GCBM.Colombia + +.. list-table:: Contents of the repository + :widths: 50 50 + :header-rows: 1 + + * - Folder + - Description + * - Standalone_GCBM + - Contains the inputs and scripts required to run the simulation + * - Postprocessing + - Postprocessing scripts written in R, these operate on the outputs generated by the simulation + * - Science + - Contains information about the science behind the GCBM model + + +.. toctree:: + :hidden: + + windows + docker + diff --git a/docs/run_simulation/windows.rst b/docs/run_simulation/windows.rst new file mode 100644 index 0000000..411721b --- /dev/null +++ b/docs/run_simulation/windows.rst @@ -0,0 +1,199 @@ +On Windows +========== + +Prerequisites ++++++++++++++ + +1. Clone the `GCBM Colombia `_ repository + +2. Download the installation tools from releases: `install_tools `_, and unzip them into `Standalone_GCBM\\tools` folder. On unzipping, `Standalone_GCBM\\tools` will contain a folder tools with the folders `python_3_installer` and `VC_redist` . +The configuration is **strictly for Python3.7**, it will not work with other versions + + +.. figure:: ../assets/install_tools.PNG + :alt: Unzipped contents of install tools + :align: center + :width: 600px + + +Running the simulation (short version) +-------------------------------------- + +Navigate to `Standalone_GCBM`, edit `run_all.bat` and set the `GCBM_PYTHON path` and `PLATFORM` variables in the `USER CONFIGURATION` section near the top to the correct values for your system + +Run `run_all.bat`, which performs the following preprocessing, and simulation + +Running the project (long version) +---------------------------------- + +This involves running each stage of the simulation step by step. +It helps in understanding the sequence of steps, inputs, outputs and dependencies to each step + +Step 1 +------ + +Working directory : **Standalone_GCBM\\layers\\tiled** + +.. code-block:: bash + :caption: Command + + c:\\python37\\python.exe ..\\..\\tools\\Tiler\\tiler.py + +Description : + 1. define all spatial layers needed for the simulation - can be raster or shapefile: + - bounding box + - age + - classifiers + - disturbance events (optional) + 2. crops all layers to a bounding box and reprojects to WGS84 processes layers into GCBM tile/block/cell format + 3. Output is a number of zip files containing GCBM-format data plus a json file containing metadata and an optional attribute table + +Output : Logs written into **Standalone_GCBM\\logs\\tiler_log.txt** + + +Step 2 +------ + +Working directory : **Standalone_GCBM** + +.. code-block:: bash + :caption: Command + + tools\\Recliner2GCBM-x64\\Recliner2GCBM.exe -c input_database\\recliner2gcbm_config.json + +Description : + +1. Runs the command-line version of Recliner2GCBM (`tools\Recliner2GCBM-[x86\x64]\Recliner2GCBM.exe`) on the saved project configuration made by running the GUI tool (Recliner2GCBM-GUI.exe) +2. Note: The paths in the saved `recliner2gcbm_config.json` file are relative to the location of the json file + +Output : An SQLite database **gcbm_input.db** which contains all of the non-spatial data required to run the project parameters taken from a CBM3 ArchiveIndex database - disturbance matrices, default climate data, etc. + +Step 3 +------ +Working directory : **Standalone_GCBM** + +.. code-block:: bash + :caption: Command + + c:\\python37\\python.exe input_database\\add_species_vol_to_bio.py input_database\\gcbm_input.db + +Description : Adding a generic tropical species and Vol to Bio parameters + +Step 4 +------ +Working directory : **Standalone_GCBM** + +.. code-block:: bash + :caption: Command + + c:\\python37\\python.exe input_database\\modify_root_parameters.py input_database\\gcbm_input.db + +Description : Modify root parameters + +Step 5 +------ +Working directory : **Standalone_GCBM** + +.. code-block:: bash + :caption: Command + + c:\\python37\\python.exe input_database\\modify_decay_parameters.py input_database\\gcbm_input.db + +Description : Modify decay parameters + +Step 6 +------ +Working directory : **Standalone_GCBM** + +.. code-block:: bash + :caption: Command + + c:\\python37\\python.exe input_database\\modify_turnover_parameters.py input_database\\gcbm_input.db + +Description : Modify turnover parameters + +Step 7 +------ +Working directory : **Standalone_GCBM** + +.. code-block:: bash + :caption: Command + + c:\\python37\\python.exe input_database\\modify_spinup_parameters.py input_database\\gcbm_input.db + +Description : Modify spinup parameters + + +Step 8 +------ + +Working directory : **Standalone_GCBM\\gcbm_project** + +.. code-block:: bash + :caption: Command + + update_gcbm_configuration.bat + +Description : + +1. Update the GCBM configuration +2. Automatically updates the GCBM configuration files based on the tiled layers: + - scans for all of the tiled layers and adds them to the provider configuration file + - sets the tile, block, and cell size in the config files so that the model knows the overall resolution of the simulation (the lowest common denominator of all the tiled layer resolutions) + - updates the list of disturbance layers in the simulation based on the DisturbanceLayer items in tiler.py + - updates the initial classifier set with the classifier layers tagged in tiler.py + +Output : Logs generated in `Standalone_GCBM\\logs\\update_gcbm_config.log` + +Step 9 +------ +Working directory : **Standalone_GCBM\\gcbm_project** + +.. code-block:: bash + :caption: Command + + run_gcbm.bat + +Description : + +1. Run the GCBM model +2. Project configuration is split between multiple files listed in `gcbm_project\\gcbm_config.cfg` +3. Data source configuration (spatial layers + SQLite) is in `gcbm_project\\provider_config.json` + +- Output : Logs generated in `Standalone_GCBM\\logs\\Moja_Debug.log` + +Step 10 +------- + +Working directory : **Standalone_GCBM\\tools\\CompileGCBMSpatialOutput** + +.. code-block:: bash + :caption: Command + + create_tiffs.bat + +Description : + +1. Compile the spatial output +2. Generates tiff layers from raw GCBM spatial output + +Output : + +1. A tiff layer per indicator and timestep in `processed_output\\spatial` +2. Logs written into `Standalone_GCBM\\logs\\create_tiffs.log` + +Step 11 +------- + +Working directory : **Standalone_GCBM\\tools\\CompileGCBMResults** + +.. code-block:: bash + :caption: Command + + compileGCBMResults.bat + +Description : + +1. Compile the GCBM results +2. Turns the raw GCBM output database into a more user-friendly format containing most of the familiar indicators from the CBM3 Toolbox +3. Produces `processed_output\\compiled_gcbm_output.db` \ No newline at end of file From 4ca6af1eb2ff338125ca6742c2fa21fb886a7779 Mon Sep 17 00:00:00 2001 From: Namya LG Date: Sun, 25 Dec 2022 12:09:42 +0530 Subject: [PATCH 2/6] add About Colombia and Postprocessing steps --- docs/about_colombia/index.rst | 33 +++++++++++++++++++++++++++++++++ docs/assets/colombia.gif | Bin 0 -> 62852 bytes docs/index.rst | 2 ++ docs/postprocessing/index.rst | 15 +++++++++++++++ 4 files changed, 50 insertions(+) create mode 100644 docs/about_colombia/index.rst create mode 100644 docs/assets/colombia.gif create mode 100644 docs/postprocessing/index.rst diff --git a/docs/about_colombia/index.rst b/docs/about_colombia/index.rst new file mode 100644 index 0000000..1a85e95 --- /dev/null +++ b/docs/about_colombia/index.rst @@ -0,0 +1,33 @@ +About Colombia +============== + +(Source - Wikipedia) + +Colombia is a country in South America with an insular region in North America. +It is bordered by the Caribbean Sea to the north, Venezuela to the east, +Brazil to the southeast, Ecuador and Peru to the south, the Pacific Ocean to the west and +Panama to the northwest. Colombia comprises 32 departments and the Capital District of Bogotá, +the country's largest city. It covers an area of 1,141,748 square kilometers (440,831 sq mi), with a population of 50 million. + + +The geography of Colombia is characterized by its six main natural regions that +present their own unique characteristics, from the Andes mountain range region +shared with Ecuador and Venezuela; the Pacific Coastal region shared with Panama and Ecuador; +the Caribbean coastal region shared with Venezuela and Panama; the Llanos (plains) +shared with Venezuela; the Amazon rainforest region shared with Venezuela, Brazil, +Peru and Ecuador; to the insular area, comprising islands in both the Atlantic and Pacific oceans +Belize is highly forested, with more than 50% of the mainland covered with forests, +and the remaining land consisting mainly of agriculture, arable +land, and human settlements. + +Colombia is the second most biologically diverse country on Earth. This biodiversity results +from Colombia's varied ecosystems—from the rich tropical rainforest to the coastal cloud +forests to the open savannas + +.. figure:: ../assets/colombia.gif + :alt: Map of Colombia + :align: center + :width: 405px + :height: 486px + + Image source https://geology.com/world/belize-satellite-image.shtml diff --git a/docs/assets/colombia.gif b/docs/assets/colombia.gif new file mode 100644 index 0000000000000000000000000000000000000000..70a68f8c677b1503f4d4384fa95f5bd61d40c56a GIT binary patch literal 62852 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 G0suSd^aK`_ based on the OS + +2. Get the path to the R executable, e.g. **c:\\"Program Files"\R\R-4.2.1\bin\R.exe**, on Windows + +3. Navigate to the `Standalone_GCBM\\Postprocessing` and execute **c:\\"Program Files"\\R\\R-4.2.1\\bin\\R.exe CMD BATCH Summarize_DOM_Stocks.R** . + +This generates the plots `Figures\\Colombia_Sensitivity_TropicalPremontaneWetTransitiontoBasal-Pacific.png`, +`Figures\\Colombia_Sensitivity_TropicalMoist.png` and `Figures\\Colombia_Sensitivity_TropicalDry.png` + +4. The logs are written into **Summarize_DOM_Stocks.Rout**, missing R packages, if any, can be installed by following the steps mentioned here: https://www.datacamp.com/tutorial/r-packages-guide \ No newline at end of file From b258d37f3bf895aae55d2b22c1c17bdcc65e52b0 Mon Sep 17 00:00:00 2001 From: Namya LG Date: Sun, 25 Dec 2022 12:09:42 +0530 Subject: [PATCH 3/6] chore : Add About Colombia and Postprocessing --- docs/about_colombia/index.rst | 32 ++++++++++++++++++++++++++++++++ docs/assets/colombia.gif | Bin 0 -> 62852 bytes docs/index.rst | 2 ++ docs/postprocessing/index.rst | 15 +++++++++++++++ 4 files changed, 49 insertions(+) create mode 100644 docs/about_colombia/index.rst create mode 100644 docs/assets/colombia.gif create mode 100644 docs/postprocessing/index.rst diff --git a/docs/about_colombia/index.rst b/docs/about_colombia/index.rst new file mode 100644 index 0000000..c41dc48 --- /dev/null +++ b/docs/about_colombia/index.rst @@ -0,0 +1,32 @@ +About Colombia +============== + +(Source - Wikipedia) + +Colombia is a country in South America with an insular region in North America. +It is bordered by the Caribbean Sea to the north, Venezuela to the east, +Brazil to the southeast, Ecuador and Peru to the south, the Pacific Ocean to the west and +Panama to the northwest. Colombia comprises 32 departments and the Capital District of Bogotá, +the country's largest city. It covers an area of 1,141,748 square kilometers (440,831 sq mi), with a population of 50 million. + +The geography of Colombia is characterized by its six main natural regions that +present their own unique characteristics, from the Andes mountain range region +shared with Ecuador and Venezuela; the Pacific Coastal region shared with Panama and Ecuador; +the Caribbean coastal region shared with Venezuela and Panama; the Llanos (plains) +shared with Venezuela; the Amazon rainforest region shared with Venezuela, Brazil, +Peru and Ecuador; to the insular area, comprising islands in both the Atlantic and Pacific oceans. +The climate of Colombia is characterized for being tropical presenting variations within six natural regions +and depending on the altitude, temperature, humidity, winds and rainfall. +Colombia has a diverse range of climate zones, including tropical rainforests, savannas, steppes, deserts and mountain climates. + +Colombia is the second most biologically diverse country on Earth. This biodiversity results +from Colombia's varied ecosystems—from the rich tropical rainforest to the coastal cloud +forests to the open savannas + +.. figure:: ../assets/colombia.gif + :alt: Map of Colombia + :align: center + :width: 405px + :height: 486px + + Image source https://geology.com/world/belize-satellite-image.shtml diff --git a/docs/assets/colombia.gif b/docs/assets/colombia.gif new file mode 100644 index 0000000000000000000000000000000000000000..70a68f8c677b1503f4d4384fa95f5bd61d40c56a GIT binary patch literal 62852 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 G0suSd^aK`_ based on the OS + +2. Get the path to the R executable, e.g. **c:\\"Program Files"\R\R-4.2.1\bin\R.exe**, on Windows + +3. Navigate to the `Standalone_GCBM\\Postprocessing` and execute **c:\\"Program Files"\\R\\R-4.2.1\\bin\\R.exe CMD BATCH Summarize_DOM_Stocks.R** . + +This generates the plots `Figures\\Colombia_Sensitivity_TropicalPremontaneWetTransitiontoBasal-Pacific.png`, +`Figures\\Colombia_Sensitivity_TropicalMoist.png` and `Figures\\Colombia_Sensitivity_TropicalDry.png` + +4. The logs are written into **Summarize_DOM_Stocks.Rout**, missing R packages, if any, can be installed by following the steps mentioned here: https://www.datacamp.com/tutorial/r-packages-guide \ No newline at end of file From c1e6f7826a9ffe7e526a7480bbba33f49744b01c Mon Sep 17 00:00:00 2001 From: Namya LG <53875297+Namyalg@users.noreply.github.com> Date: Sun, 19 Mar 2023 15:32:59 +0530 Subject: [PATCH 4/6] chore : update documentation Co-authored-by: Iheanacho Amarachi Sharon <58210919+Iheanacho-ai@users.noreply.github.com> --- docs/about_colombia/index.rst | 10 +++++----- docs/postprocessing/index.rst | 6 +++--- docs/run_simulation/docker.rst | 4 ++-- docs/run_simulation/index.rst | 8 ++++++++ docs/run_simulation/windows.rst | 14 +++++++------- 5 files changed, 25 insertions(+), 17 deletions(-) diff --git a/docs/about_colombia/index.rst b/docs/about_colombia/index.rst index c41dc48..98a9827 100644 --- a/docs/about_colombia/index.rst +++ b/docs/about_colombia/index.rst @@ -4,20 +4,20 @@ About Colombia (Source - Wikipedia) Colombia is a country in South America with an insular region in North America. -It is bordered by the Caribbean Sea to the north, Venezuela to the east, +The Caribbean Sea borders it to the north, Venezuela to the east, Brazil to the southeast, Ecuador and Peru to the south, the Pacific Ocean to the west and Panama to the northwest. Colombia comprises 32 departments and the Capital District of Bogotá, the country's largest city. It covers an area of 1,141,748 square kilometers (440,831 sq mi), with a population of 50 million. The geography of Colombia is characterized by its six main natural regions that -present their own unique characteristics, from the Andes mountain range region +present their unique characteristics from the Andes mountain range region shared with Ecuador and Venezuela; the Pacific Coastal region shared with Panama and Ecuador; the Caribbean coastal region shared with Venezuela and Panama; the Llanos (plains) shared with Venezuela; the Amazon rainforest region shared with Venezuela, Brazil, -Peru and Ecuador; to the insular area, comprising islands in both the Atlantic and Pacific oceans. -The climate of Colombia is characterized for being tropical presenting variations within six natural regions +Peru and Ecuador; to the insular area, comprising islands in the Atlantic and Pacific oceans. +The climate of Colombia is characterized as being tropical, presenting variations within six natural regions and depending on the altitude, temperature, humidity, winds and rainfall. -Colombia has a diverse range of climate zones, including tropical rainforests, savannas, steppes, deserts and mountain climates. +Colombia has diverse climate zones, including tropical rainforests, savannas, steppes, deserts and mountain climates. Colombia is the second most biologically diverse country on Earth. This biodiversity results from Colombia's varied ecosystems—from the rich tropical rainforest to the coastal cloud diff --git a/docs/postprocessing/index.rst b/docs/postprocessing/index.rst index eb42f7b..c389066 100644 --- a/docs/postprocessing/index.rst +++ b/docs/postprocessing/index.rst @@ -1,13 +1,13 @@ Postprocessing ============== -After the simulation is complete, either by running the **run_all.bat** script or following the step-by-step procedure, for postprocessing, the following steps are to be followed: +After the simulation is complete, either by running the **run_all.bat** script or following the step-by-step procedure for postprocessing, the following steps are to be followed: 1. Install `R `_ based on the OS -2. Get the path to the R executable, e.g. **c:\\"Program Files"\R\R-4.2.1\bin\R.exe**, on Windows +2. Get the `path `_ to the R executable, e.g. **c:\\"Program Files"\R\R-4.2.1\bin\R.exe**, on Windows -3. Navigate to the `Standalone_GCBM\\Postprocessing` and execute **c:\\"Program Files"\\R\\R-4.2.1\\bin\\R.exe CMD BATCH Summarize_DOM_Stocks.R** . +3. Navigate to the directory `Standalone_GCBM\\Postprocessing` and execute **c:\\"Program Files"\\R\\R-4.2.1\\bin\\R.exe CMD BATCH Summarize_DOM_Stocks.R** . This generates the plots `Figures\\Colombia_Sensitivity_TropicalPremontaneWetTransitiontoBasal-Pacific.png`, `Figures\\Colombia_Sensitivity_TropicalMoist.png` and `Figures\\Colombia_Sensitivity_TropicalDry.png` diff --git a/docs/run_simulation/docker.rst b/docs/run_simulation/docker.rst index e4b1601..ea740f2 100644 --- a/docs/run_simulation/docker.rst +++ b/docs/run_simulation/docker.rst @@ -12,7 +12,7 @@ Steps to run the Colombia simulation in a docker environment git clone -b docker-setup https://github.com/moja-global/GCBM.Colombia -2. Navigate into `GCBM.Colombia` +2. Navigate into directory `GCBM.Colombia` .. code-block:: bash @@ -55,5 +55,5 @@ Change the docker version in the file `./docker-compose.yml` to an appropriate v /opt/gcbm/moja.cli --config_file gcbm_config.cfg --config_provider provider_config.json -If there are existing images cached on your machine you may need to docker pull ghcr.io/moja-global/rest_api_gcbm:master +If there are existing images cached on your machine, you may need to docker pull ghcr.io/moja-global/rest_api_gcbm:master and build the container using `docker-compose -d --force-recreate` \ No newline at end of file diff --git a/docs/run_simulation/index.rst b/docs/run_simulation/index.rst index 2421517..b79882e 100644 --- a/docs/run_simulation/index.rst +++ b/docs/run_simulation/index.rst @@ -1,6 +1,14 @@ Running the Colombia simulation =============================== +:Authors: + Tony J. (Tibs) Ibbs, + David Goodger + (and sundry other good-natured folks) + +:Version: 1.0 of 2001/08/08 +:Dedication: To my father. + A local simulation of the GCBM model is run for the Colombia region can be run locally. The repository is located at: https://github.com/moja-global/GCBM.Colombia diff --git a/docs/run_simulation/windows.rst b/docs/run_simulation/windows.rst index 411721b..42f4701 100644 --- a/docs/run_simulation/windows.rst +++ b/docs/run_simulation/windows.rst @@ -19,19 +19,19 @@ The configuration is **strictly for Python3.7**, it will not work with other ver Running the simulation (short version) -------------------------------------- -Navigate to `Standalone_GCBM`, edit `run_all.bat` and set the `GCBM_PYTHON path` and `PLATFORM` variables in the `USER CONFIGURATION` section near the top to the correct values for your system +Navigate to `Standalone_GCBM`, edit `run_all.bat` and set the `GCBM_PYTHON path` and `PLATFORM` variables in the `USER CONFIGURATION` section near the top to the correct values for your system. -Run `run_all.bat`, which performs the following preprocessing, and simulation +Run `run_all.bat`, which performs the following preprocessing and simulation. Running the project (long version) ---------------------------------- -This involves running each stage of the simulation step by step. -It helps in understanding the sequence of steps, inputs, outputs and dependencies to each step +This action involves running each stage of the simulation step by step. +It helps in understanding the sequence of steps, inputs, outputs and dependencies to each step. Step 1 ------ - +tiler Working directory : **Standalone_GCBM\\layers\\tiled** .. code-block:: bash @@ -40,12 +40,12 @@ Working directory : **Standalone_GCBM\\layers\\tiled** c:\\python37\\python.exe ..\\..\\tools\\Tiler\\tiler.py Description : - 1. define all spatial layers needed for the simulation - can be raster or shapefile: + 1. Define all spatial layers needed for the simulation - can be raster or shapefile: - bounding box - age - classifiers - disturbance events (optional) - 2. crops all layers to a bounding box and reprojects to WGS84 processes layers into GCBM tile/block/cell format + 2. Crops all layers to a bounding box and reprojects to WGS84 processes layers into GCBM tile/block/cell format 3. Output is a number of zip files containing GCBM-format data plus a json file containing metadata and an optional attribute table Output : Logs written into **Standalone_GCBM\\logs\\tiler_log.txt** From f27d86cb81b036957d317d74325aa291cd671f7e Mon Sep 17 00:00:00 2001 From: Namya LG <53875297+Namyalg@users.noreply.github.com> Date: Sun, 9 Apr 2023 17:20:15 +0530 Subject: [PATCH 5/6] Update index.rst --- docs/run_simulation/index.rst | 8 -------- 1 file changed, 8 deletions(-) diff --git a/docs/run_simulation/index.rst b/docs/run_simulation/index.rst index b79882e..2421517 100644 --- a/docs/run_simulation/index.rst +++ b/docs/run_simulation/index.rst @@ -1,14 +1,6 @@ Running the Colombia simulation =============================== -:Authors: - Tony J. (Tibs) Ibbs, - David Goodger - (and sundry other good-natured folks) - -:Version: 1.0 of 2001/08/08 -:Dedication: To my father. - A local simulation of the GCBM model is run for the Colombia region can be run locally. The repository is located at: https://github.com/moja-global/GCBM.Colombia From bfb78c837733042b771c8e87d932c14343587ea2 Mon Sep 17 00:00:00 2001 From: Namya LG <53875297+Namyalg@users.noreply.github.com> Date: Sun, 9 Apr 2023 17:21:26 +0530 Subject: [PATCH 6/6] Update windows.rst --- docs/run_simulation/windows.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/run_simulation/windows.rst b/docs/run_simulation/windows.rst index 42f4701..8a00e52 100644 --- a/docs/run_simulation/windows.rst +++ b/docs/run_simulation/windows.rst @@ -160,7 +160,7 @@ Description : 2. Project configuration is split between multiple files listed in `gcbm_project\\gcbm_config.cfg` 3. Data source configuration (spatial layers + SQLite) is in `gcbm_project\\provider_config.json` -- Output : Logs generated in `Standalone_GCBM\\logs\\Moja_Debug.log` +Output : Logs generated in `Standalone_GCBM\\logs\\Moja_Debug.log` Step 10 ------- @@ -196,4 +196,4 @@ Description : 1. Compile the GCBM results 2. Turns the raw GCBM output database into a more user-friendly format containing most of the familiar indicators from the CBM3 Toolbox -3. Produces `processed_output\\compiled_gcbm_output.db` \ No newline at end of file +3. Produces `processed_output\\compiled_gcbm_output.db`