The FRS extension for LANDIS-II

Simulate forest roads for your research easily, and flexibly.

Star us on GitHub

Learn more

The FRS extension for LANDIS-II

Features

Build forest roads

from harvested cells to delivery areas

Make realistic paths

using least-cost path algorithms

Create loops

and control their size and distribution

Age the roads

to simulate their wear and destruction

Determine wood fluxes

account for the mouvement of timber trucks

Consider repeated harvest

to choose the right road type to build

Extensive documentation

to know everything about how it works

Self-guided workshop

to learn how to use it for your research

Easy parameterization

adapted to the data you have

📸 Screenshots







⏱ Performance

Creating thousands of roads in a landscape made of millions of cells takes less than a minute for each time step with our extension, when using an average CPU for the time (Intel i7 CPU with 4 cores working at 2.60GHz).

Using the woodflux algorithm usually requires half the time that was needed to create the roads for the time step.

This is due to optimizations using two open-source C# Nuget packages (see Acknowledgments) that greatly improved the running time of the extension.

🧱 Requirements

To use the FRS extension, you need:

  • The LANDIS-II model v7.0 installed on your computer.
  • One of the succession extensions of LANDIS-II installed on your computer.
  • One of the harvest extensions (Base Harvest or Biomass Harvest) installed on your computer.
  • The FRS extension installed on your computer (see Download section below).
  • The parameter files for your scenario (see Parameterization section below).

💾 Download

Version 1.3.1 can be downloaded here.

To install it on your computer, just launch the installer.

🛠 Parameters and use

To learn how to parameterize and use the FRS extension, take a look at the FRS extension workshop.

The workshop will give you files, scripts, figures and examples to understand and use the FRS extension for your research. It will also give you tips to better interpret the output data of the extension.

To know how to generate the parameter files for the succession extension and the harvest extension that you will use, please refer to their user manual.

🎮 Example and testing

If you want to experiment with the extension or test it, you can download the example files, or try the workshop.

To launch the example scenario, you’ll need the Age-Only succession extension and the Base Harvest extension installed on your computer, in addition to the FRS extension. Just launch the test_scenario.bat file, and the example scenario should run.

☎️ Support

If you have a question, please send me an e-mail at clem.hardy@outlook.fr. I’ll do my best to answer you in time.

You can also ask for help in the LANDIS-II users group.

If you come across any issue or suspected bug when using the FRS extension, please post about it in the issue section of the Github repository of the extension.

✒️ Author

Clément Hardy

PhD Student at the Université du Québec à Montréal

Mail : clem.hardy@outlook.fr

Github : https://github.com/Klemet

💚 Acknowledgments

This work would not be possible without the incredible project that is LANDIS-II, and without the care and passion that the LANDIS-II fondation have to make the project as participative and accessible as it is. I thank them all tremendously.

I would also like to thank Github users BlueRaja and eregina92 for their respective packages, High Speed Priority Queue for C# and Supercluster.KDTree. Both packages were of tremendous use to improve the performance of the FRS extension, and I highly recommend you to check out their work.

The background picture for the top of this webpage is from Tom Parsons on Unsplash.