From d4f44e748dd70a2eebd355a777c69703f0dd8394 Mon Sep 17 00:00:00 2001 From: Shloka gupta Date: Sat, 5 Jun 2021 22:54:46 +0530 Subject: [PATCH 1/3] Changes in README Signed-off-by: Shloka gupta --- README.md | 54 ++++++++++++++++++++++++++++++------------------------ 1 file changed, 30 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index f573e87..7b532ee 100644 --- a/README.md +++ b/README.md @@ -2,29 +2,34 @@ [![All Contributors](https://img.shields.io/badge/all_contributors-5-orange.svg?style=flat-square)](#contributors) -## What is `FLINT`? +## What is FLINT? -The Full Lands Integration Tool (FLINT) is a C++ framework that combines satellite and ground data in ways that meet policy needs. It is based on over 20 years of experience building and operating integration tools in Australia and Canada. It's an Open-source Library maintained under [**moja.global**](https://github.com/moja-global/About-moja-global/blob/master/README.md), a project under the Linux Foundation +Full Lands Integration Tool (FLINT) is a C++ framework that combines satellite and ground data in a way that meets policy requirements.It is based on more than 20 years of experience in building and operating integrated tools in Australia and Canada. It's an Open-Source Library maintained under [**moja global**](https://github.com/moja-global/About-moja-global/blob/master/README.md), a project under the Linux Foundation. ## Why FLINT? -The FLINT makes developing and operating advanced systems achievable by all countries. It is a generic platform with a modular structure, allowing countries to attach any variety of models or data to build country-specific systems. The platform handles complex computer science tasks, such as the storage and processing of large data sets, leaving users to focus on monitoring, reporting and scenario analyses. +FLINT enables all countries to develop and operate advanced systems. It is a universal platform with a modular structure, allowing countries to attach any kind of models or data to build a country-specific system. The platform handles complex computer science tasks, such as storing and processing large data sets, allowing users to focus on monitoring, reporting, and scenario analysis. ## How is FLINT different from earlier integrating tools? -The FLINT is using the lessons learned from first generation tools, to build a new framework that meets present and future needs. The key improvements compared to the first generation tools include: -+ a flexible, modular approach, allowing for country specific implementations from [IPCC Tier 1 to 3 ](https://www.reddcompass.org/mgd-content-v1/dita-webhelp/en/Box1.html) -+ support for [wall-to-wall, sample based, jurisdictional, and supply chain approaches](https://static1.squarespace.com/static/5896200f414fb57d26f3d600/t/59362b028419c2db8f57e747/1496722191543/REDD_nested_projects.pdf) -+ the ability to cover all [land uses and land use changes, and activity-based reporting such as REDD+](https://theredddesk.org/what-redd) -+ scenario analysis systems to allow the development of projections -+ the potential to be used for multiple other purposes, including economics, water and biodiversity -+ development managed using a true open source approach under [moja global](http://moja.global), which will allow users (countries, companies and organizations) to direct strategy and control the budget. -+ software that allows data processing on local desktops or cloud-based systems +FLINT is using the lessons learned from the first generation of tools to build a new framework that meets current and future needs. Compared with the first-generation tools, the main improvements include: ++ A flexible and modular approach that allows specific countries from [IPCC Tier 1 to 3](https://www.reddcompass.org/mgd-content-v1/dita-webhelp/en/Box1.html) to implement a [comprehensive, sample-based, jurisdictional and supply chain-based approach.](https://static1.squarespace.com/static/5896200f414fb57d26f3d600/t/59362b028419c2db8f57e747/1496722191543/REDD_nested_projects.pdf) ++ The ability to cover all [land uses and land use changes, and activity-based reporting such as REDD+.](https://theredddesk.org/what-redd) ++ Scenario analysis systems to allow the development of projections. ++ Potential for a variety of other purposes, including economics, water, and biodiversity. ++ Development managed using a true open source approach under [moja global](http://moja.global), which will allow users (countries, companies and organizations) to direct strategy and control the budget. ++ Software that allows data processing on local desktops or cloud-based systems. -## How to use FLINT? +## Getting Started with FLINT + +Below are instructions for quick installation. + +Note: If you need more detailed information, you can use a [step-by-step guide](https://github.com/moja-global/FLINT/tree/master/How_to_use_FLINT) or view the [video](https://www.youtube.com/watch?v=Jfi2-vEhfkg). + +Please provide us with feedback on how to improve these guidelines. +You can leave your comment in the [version under development.](https://github.com/moja-global/FLINT/blob/master/How_to_use_FLINT/How_to_use_FLINT.md) -Below are the quick install instructions. [Step-by-step instructions guides](https://github.com/moja-global/FLINT/tree/master/How_to_use_FLINT) are available if you would like to have more detailed information. Please provide us with feedback on how we can improve these guides. You can leave your comments in the [versions under development](https://github.com/moja-global/FLINT/blob/master/How_to_use_FLINT/How_to_use_FLINT.md). ### Development Environment How-To for Windows @@ -34,7 +39,7 @@ These instructions are for building the FLINT on Windows using Visual Studio 201 ##### CMake -- download [cmake-3.15.2-win64-x64.msi](https://github.com/Kitware/CMake/releases/download/v3.15.2/cmake-3.15.2-win64-x64.msi) +- Download [cmake-3.15.2-win64-x64.msi](https://github.com/Kitware/CMake/releases/download/v3.15.2/cmake-3.15.2-win64-x64.msi) #### Using vcpkg to install required libraries @@ -81,7 +86,7 @@ It is possible to use the Visual Studio moja solution to install built versions ##### SQLIte Studio -a simple windows SQLite database manager (http://sqlitestudio.pl/) +A simple windows SQLite database manager (http://sqlitestudio.pl/) [sqlitestudio-3.1.0.zip](http://sqlitestudio.pl/files/sqlitestudio3/complete/win32/sqlitestudio-3.1.0.zip) ##### TortoiseGit @@ -145,17 +150,17 @@ Configuration file options: ## How to Get Involved? -moja global welcomes a wide range of contributions as explained in [Contributing document](https://github.com/moja-global/About-moja-global/blob/master/CONTRIBUTING.md) and in the [About moja-global Wiki](https://github.com/moja-global/.github/wiki). +moja global welcomes a wide range of contributions as explained in [Contributing document](https://github.com/moja-global/About-moja-global/blob/master/CONTRIBUTING.md) and in the [About moja global Wiki](https://github.com/moja-global/.github/wiki). ## FAQ and Other Questions -* You can find FAQs on the [Wiki](https://github.com/moja.global/.github/wiki). -* If you have a question about the code, submit [user feedback](https://github.com/moja-global/About-moja-global/blob/master/Contributing/How-to-Provide-User-Feedback.md) in the relevant repository -* If you have a general question about a project or repository or moja global, [join moja global](https://github.com/moja-global/About-moja-global/blob/master/Contributing/How-to-Join-moja-global.md) and - * [submit a discussion](https://help.github.com/en/articles/about-team-discussions) to the project, repository or moja global [team](https://github.com/orgs/moja-global/teams) - * [submit a message](https://get.slack.help/hc/en-us/categories/200111606#send-messages) to the relevant channel on [moja global's Slack workspace](mojaglobal.slack.com). -* If you have other questions, please write to info@moja.global +* You can find FAQs on the [FAQs section of our docs](https://docs.moja.global/en/latest/faq.html). +* If you have a question about the code, submit a [user feedback](https://github.com/moja-global/About-moja-global/blob/master/Contributing/How-to-Provide-User-Feedback.md) on the relevant repository +* If you have a general question about a project or repository or moja global, [join moja global](https://docs.moja.global/en/latest/contact.html) and: + * [Submit a discussion](https://help.github.com/en/articles/about-team-discussions) to the project, repository or moja global [team](https://github.com/orgs/moja-global/teams) + * [Submit a message](https://get.slack.help/hc/en-us/categories/200111606#send-messages) to the relevant channel on [moja global's Slack workspace](https://app.slack.com/client/T1G1M5HPF/slack-connect). +* If you have other questions, please write to [info@moja.global](mailto:info@moja.global). ## Contributors @@ -167,13 +172,14 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
Rob de Ligt
Rob de Ligt

πŸ“– 🚧
Mal
Mal

πŸ’»
James Leitch
James Leitch

πŸ’»
Max Fellows
Max Fellows

πŸ’»
-This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! +This project follows the [all contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! ## Maintainers Reviewers Ambassadors Coaches -The following people are Maintainers of this repository +The following people are Maintainers, Reviewers, Ambassadors or Coaches.
Mal
Mal

πŸ’»
James Leitch
James Leitch

πŸ’»
Max Fellows
Max Fellows

πŸ’»
+ **Maintainers** review and accept proposed changes **Reviewers** check proposed changes before they go to the Maintainers **Ambassadors** are available to provide training related to this repository From 1c13747efaac709766d0ee6dc234178f910253ba Mon Sep 17 00:00:00 2001 From: Shloka gupta Date: Sun, 6 Jun 2021 16:23:40 +0530 Subject: [PATCH 2/3] Did asked changes. Will use markdown beautifier for better output. Signed-off-by: Shloka gupta --- README.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 7b532ee..bbf47da 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ ## What is FLINT? -Full Lands Integration Tool (FLINT) is a C++ framework that combines satellite and ground data in a way that meets policy requirements.It is based on more than 20 years of experience in building and operating integrated tools in Australia and Canada. It's an Open-Source Library maintained under [**moja global**](https://github.com/moja-global/About-moja-global/blob/master/README.md), a project under the Linux Foundation. +Full Lands Integration Tool (FLINT) is a C++ framework that combines satellite and ground data in a way that meets policy requirements. It is based on more than 20 years of experience in building and operating integrated tools in Australia and Canada. It's an Open-Source Library maintained under [**moja global**](https://github.com/moja-global/About-moja-global/blob/master/README.md), a project under the [Linux Foundation.](https://linuxfoundation.org/) ## Why FLINT? @@ -25,10 +25,9 @@ FLINT is using the lessons learned from the first generation of tools to build a Below are instructions for quick installation. -Note: If you need more detailed information, you can use a [step-by-step guide](https://github.com/moja-global/FLINT/tree/master/How_to_use_FLINT) or view the [video](https://www.youtube.com/watch?v=Jfi2-vEhfkg). +**Note:** If you need more detailed information, you can use a [step-by-step guide](https://github.com/moja-global/FLINT/tree/master/How_to_use_FLINT) or view the [video](https://www.youtube.com/watch?v=Jfi2-vEhfkg). -Please provide us with feedback on how to improve these guidelines. -You can leave your comment in the [version under development.](https://github.com/moja-global/FLINT/blob/master/How_to_use_FLINT/How_to_use_FLINT.md) +Please provide us with feedback on how to improve these guidelines. You can leave your comment in the [version under development.](https://github.com/moja-global/FLINT/blob/master/How_to_use_FLINT/How_to_use_FLINT.md) ### Development Environment How-To for Windows @@ -152,14 +151,13 @@ Configuration file options: moja global welcomes a wide range of contributions as explained in [Contributing document](https://github.com/moja-global/About-moja-global/blob/master/CONTRIBUTING.md) and in the [About moja global Wiki](https://github.com/moja-global/.github/wiki). - ## FAQ and Other Questions * You can find FAQs on the [FAQs section of our docs](https://docs.moja.global/en/latest/faq.html). * If you have a question about the code, submit a [user feedback](https://github.com/moja-global/About-moja-global/blob/master/Contributing/How-to-Provide-User-Feedback.md) on the relevant repository * If you have a general question about a project or repository or moja global, [join moja global](https://docs.moja.global/en/latest/contact.html) and: * [Submit a discussion](https://help.github.com/en/articles/about-team-discussions) to the project, repository or moja global [team](https://github.com/orgs/moja-global/teams) - * [Submit a message](https://get.slack.help/hc/en-us/categories/200111606#send-messages) to the relevant channel on [moja global's Slack workspace](https://app.slack.com/client/T1G1M5HPF/slack-connect). + * [Submit a message](https://get.slack.help/hc/en-us/categories/200111606#send-messages) to the relevant channel on [moja global's Slack workspace](mojaglobal.slack.com). * If you have other questions, please write to [info@moja.global](mailto:info@moja.global). @@ -181,7 +179,7 @@ The following people are Maintainers, Reviewers, Ambassadors or Coaches.
Mal
Mal

πŸ’»
James Leitch
James Leitch

πŸ’»
Max Fellows
Max Fellows

πŸ’»
**Maintainers** review and accept proposed changes -**Reviewers** check proposed changes before they go to the Maintainers +**Reviewers** check proposed changes before they go to the Maintainers **Ambassadors** are available to provide training related to this repository **Coaches** are available to provide information to new contributors to this repository From c0d5b2ca3925b099a89b34f69a84a745c8d045eb Mon Sep 17 00:00:00 2001 From: Shloka gupta Date: Sun, 6 Jun 2021 17:30:48 +0530 Subject: [PATCH 3/3] Applied Mardown beautifier to the whole doc Signed-off-by: Shloka gupta --- README.md | 65 ++++++++++++++++++++++++++----------------------------- 1 file changed, 31 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index bbf47da..7b4237f 100644 --- a/README.md +++ b/README.md @@ -8,18 +8,18 @@ Full Lands Integration Tool (FLINT) is a C++ framework that combines satellite a ## Why FLINT? -FLINT enables all countries to develop and operate advanced systems. It is a universal platform with a modular structure, allowing countries to attach any kind of models or data to build a country-specific system. The platform handles complex computer science tasks, such as storing and processing large data sets, allowing users to focus on monitoring, reporting, and scenario analysis. +FLINT enables all countries to develop and operate advanced systems. It is a universal platform with a modular structure, allowing countries to attach any kind of models or data to build a country-specific system. The platform handles complex computer science tasks, such as storing and processing large data sets, allowing users to focus on monitoring, reporting, and scenario analysis. ## How is FLINT different from earlier integrating tools? FLINT is using the lessons learned from the first generation of tools to build a new framework that meets current and future needs. Compared with the first-generation tools, the main improvements include: -+ A flexible and modular approach that allows specific countries from [IPCC Tier 1 to 3](https://www.reddcompass.org/mgd-content-v1/dita-webhelp/en/Box1.html) to implement a [comprehensive, sample-based, jurisdictional and supply chain-based approach.](https://static1.squarespace.com/static/5896200f414fb57d26f3d600/t/59362b028419c2db8f57e747/1496722191543/REDD_nested_projects.pdf) -+ The ability to cover all [land uses and land use changes, and activity-based reporting such as REDD+.](https://theredddesk.org/what-redd) -+ Scenario analysis systems to allow the development of projections. -+ Potential for a variety of other purposes, including economics, water, and biodiversity. -+ Development managed using a true open source approach under [moja global](http://moja.global), which will allow users (countries, companies and organizations) to direct strategy and control the budget. -+ Software that allows data processing on local desktops or cloud-based systems. +- A flexible and modular approach that allows specific countries from [IPCC Tier 1 to 3](https://www.reddcompass.org/mgd-content-v1/dita-webhelp/en/Box1.html) to implement a [comprehensive, sample-based, jurisdictional and supply chain-based approach.](https://static1.squarespace.com/static/5896200f414fb57d26f3d600/t/59362b028419c2db8f57e747/1496722191543/REDD_nested_projects.pdf) +- The ability to cover all [land uses and land use changes, and activity-based reporting such as REDD+.](https://theredddesk.org/what-redd) +- Scenario analysis systems to allow the development of projections. +- Potential for a variety of other purposes, including economics, water, and biodiversity. +- Development managed using a true open source approach under [moja global](http://moja.global), which will allow users (countries, companies and organizations) to direct strategy and control the budget. +- Software that allows data processing on local desktops or cloud-based systems. ## Getting Started with FLINT @@ -29,7 +29,6 @@ Below are instructions for quick installation. Please provide us with feedback on how to improve these guidelines. You can leave your comment in the [version under development.](https://github.com/moja-global/FLINT/blob/master/How_to_use_FLINT/How_to_use_FLINT.md) - ### Development Environment How-To for Windows These instructions are for building the FLINT on Windows using Visual Studio 2017, or Visual Studio 2019. @@ -42,44 +41,44 @@ These instructions are for building the FLINT on Windows using Visual Studio 201 #### Using vcpkg to install required libraries -A fork of a *Vcpkg* repository has been created for the FLINT required libraries. To build these libraries you can use the following process: +A fork of a _Vcpkg_ repository has been created for the FLINT required libraries. To build these libraries you can use the following process: -+ Clone the Vcpkg repository: https://github.com/moja-global/vcpkg +- Clone the Vcpkg repository: https://github.com/moja-global/vcpkg -+ Start a command shell in the Vcpkg repository folder and use the following commands: +- Start a command shell in the Vcpkg repository folder and use the following commands: ```powershell # bootstrap bootstrap-vcpkg.bat - + # install packages vcpkg.exe install boost-test:x64-windows boost-program-options:x64-windows boost-log:x64-windows turtle:x64-windows zipper:x64-windows poco:x64-windows libpq:x64-windows gdal:x64-windows sqlite3:x64-windows boost-ublas:x64-windows ``` -+ Once this has completed, start a command shell in your FLINT repository folder. Now use the following commands to create the Visual Studio solution: +- Once this has completed, start a command shell in your FLINT repository folder. Now use the following commands to create the Visual Studio solution: ```powershell # Create a build folder under the Source folder cd Source mkdir build cd build - + # now create the Visual Studio Solution (2019) cmake -G "Visual Studio 16 2019" -DCMAKE_INSTALL_PREFIX=C:/Development/Software/moja -DVCPKG_TARGET_TRIPLET=x64-windows -DENABLE_TESTS=OFF -DENABLE_MOJA.MODULES.ZIPPER=OFF -DCMAKE_TOOLCHAIN_FILE=c:\Development\moja-global\vcpkg\scripts\buildsystems\vcpkg.cmake .. - + # OR Visual Studio Solution (2017) cmake -G "Visual Studio 15 2017" -DCMAKE_INSTALL_PREFIX=C:/Development/Software/moja -DVCPKG_TARGET_TRIPLET=x64-windows -DENABLE_TESTS=OFF -DENABLE_MOJA.MODULES.ZIPPER=OFF -DCMAKE_TOOLCHAIN_FILE=c:\Development\moja-global\vcpkg\scripts\buildsystems\vcpkg.cmake .. ``` #### Install Moja Libraries -It is possible to use the Visual Studio moja solution to install built versions of the Moja libraries. To do this you need to set the CMAKE variable '***CMAKE_INSTALL_PREFIX***' to your install path (i.e. "*C:/Development/Software/moja*"). +It is possible to use the Visual Studio moja solution to install built versions of the Moja libraries. To do this you need to set the CMAKE variable '**_CMAKE_INSTALL_PREFIX_**' to your install path (i.e. "_C:/Development/Software/moja_"). #### Make edits to the Visual Studio Solution using CMake 1. Launch the CMake GUI -2. In the '*Where to build the binaries*' field click β€œBrowse Build…” and select the folder you created above (i.e. `C:\Development\moja-global\FLINT\Source\build`)`. The '*Where is the source code:*' field should update, if not, set it correctly. -4. You should be able to edit any CMake setting now (i.e. ENABLE flags like `ENABLE_TESTS`), then click β€œ***Configure***” – assuming all libraries and required software has been installed you should have no errors. Now click ***"Generate"*** and the Solution with adjustments should be ready to load into Visual Studio. +2. In the '_Where to build the binaries_' field click β€œBrowse Build…” and select the folder you created above (i.e. `C:\Development\moja-global\FLINT\Source\build`)`. The '_Where is the source code:_' field should update, if not, set it correctly. +3. You should be able to edit any CMake setting now (i.e. ENABLE flags like `ENABLE_TESTS`), then click β€œ**_Configure_**” – assuming all libraries and required software has been installed you should have no errors. Now click **_"Generate"_** and the Solution with adjustments should be ready to load into Visual Studio. #### Other Useful Tools @@ -146,20 +145,18 @@ Configuration file options: --config_provider arg path to Moja project config files for data providers ``` +## How to Get Involved? -## How to Get Involved? - -moja global welcomes a wide range of contributions as explained in [Contributing document](https://github.com/moja-global/About-moja-global/blob/master/CONTRIBUTING.md) and in the [About moja global Wiki](https://github.com/moja-global/.github/wiki). +moja global welcomes a wide range of contributions as explained in [Contributing document](https://github.com/moja-global/About-moja-global/blob/master/CONTRIBUTING.md) and in the [About moja global Wiki](https://github.com/moja-global/.github/wiki). -## FAQ and Other Questions +## FAQ and Other Questions -* You can find FAQs on the [FAQs section of our docs](https://docs.moja.global/en/latest/faq.html). -* If you have a question about the code, submit a [user feedback](https://github.com/moja-global/About-moja-global/blob/master/Contributing/How-to-Provide-User-Feedback.md) on the relevant repository -* If you have a general question about a project or repository or moja global, [join moja global](https://docs.moja.global/en/latest/contact.html) and: - * [Submit a discussion](https://help.github.com/en/articles/about-team-discussions) to the project, repository or moja global [team](https://github.com/orgs/moja-global/teams) - * [Submit a message](https://get.slack.help/hc/en-us/categories/200111606#send-messages) to the relevant channel on [moja global's Slack workspace](mojaglobal.slack.com). -* If you have other questions, please write to [info@moja.global](mailto:info@moja.global). - +- You can find FAQs on the [FAQs section of our docs](https://docs.moja.global/en/latest/faq.html). +- If you have a question about the code, submit a [user feedback](https://github.com/moja-global/About-moja-global/blob/master/Contributing/How-to-Provide-User-Feedback.md) on the relevant repository +- If you have a general question about a project or repository or moja global, [join moja global](https://docs.moja.global/en/latest/contact.html) and: + - [Submit a discussion](https://help.github.com/en/articles/about-team-discussions) to the project, repository or moja global [team](https://github.com/orgs/moja-global/teams) + - [Submit a message](https://get.slack.help/hc/en-us/categories/200111606#send-messages) to the relevant channel on [moja global's Slack workspace](mojaglobal.slack.com). +- If you have other questions, please write to [info@moja.global](mailto:info@moja.global). ## Contributors @@ -170,7 +167,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
Rob de Ligt
Rob de Ligt

πŸ“– 🚧
Mal
Mal

πŸ’»
James Leitch
James Leitch

πŸ’»
Max Fellows
Max Fellows

πŸ’»
-This project follows the [all contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! +This project follows the [all contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! ## Maintainers Reviewers Ambassadors Coaches @@ -178,8 +175,8 @@ The following people are Maintainers, Reviewers, Ambassadors or Coaches.
Mal
Mal

πŸ’»
James Leitch
James Leitch

πŸ’»
Max Fellows
Max Fellows

πŸ’»
-**Maintainers** review and accept proposed changes -**Reviewers** check proposed changes before they go to the Maintainers -**Ambassadors** are available to provide training related to this repository -**Coaches** are available to provide information to new contributors to this repository +**Maintainers** review and accept proposed changes. +**Reviewers** check proposed changes before they go to the Maintainers. +**Ambassadors** are available to provide training related to this repository. +**Coaches** are available to provide information to new contributors to this repository.