Computational Model Library

FNNR-ABM (version 1.0.0)

FNNR-ABM is an agent-based model that simulates human activity, Guizhou snub-nosed monkey movement, and GTGP-enrolled land parcel conversion in the Fanjingshan National Nature Reserve in Guizhou, China.

Quick-start guide:
1. Install Python and set environmental path variables.
2. Install the mesa, matplotlib (optional), and pyshp (optional) Python libraries.
3. Configure
4. Run either (for a web-based browser visualization) or (for generating data outputs).
5. Analyze the data; more information and documentation on this is available in the model’s Github repository at


Release Notes

Welcome! This project seeks to understand population demographics and factors affecting the movement of Guizhou snub-nosed (“golden”) monkeys endemic to the Fanjingshan National Nature Reserve in Guizhou, China. It uses Mesa, a library framework with tools designed to support agent-based modeling in Python 3.X.

An overview of Mesa can be found at: A more thorough doc can be found at:

Documentation for this project–as well as the source code available for download–can be found in the Github repository. Please refer to the User’s Manual.

Instructions for Running the Code:

  1. Have Python 3.X installed, as well as the Mesa (which comes with dependencies such as numpy, pandas, and tornado) and matplotlib libraries.
    *If you have errors running the code, make sure Mesa’s edition is 0.8.3, and tornado’s edition is 4.5.2.

  2. Download the code; refer to the Github repository. Configure the file ‘’ or leave it as default.

3a. Run ‘’ to launch a web browser with an interactive visualization module of monkey movement in the Fanjingshan National Nature Reserve in China (and human resource gathering, though humans will appear to flicker due to low time resolution). Monkey movements are semi-randomized, and based on the weighted value of their 8-neighbor surroundings. This weighted value is currently determined by vegetation, human presence, season, and elevation (changeable in code; requires raster layers converted to an ASCII file).

A web app version of is being worked on.

3b. Run ‘’ to see population demographic charts after 10 years, or 730 time-steps (changeable in code). also provides all data output (Excel file export)– is the main file to run for data analysis; is simply a demonstration.

Version Submitter First published Last modified Status
1.0.0 Judy Mak Thu Feb 28 04:26:47 2019 Thu Feb 28 04:26:47 2019 Published


This website uses cookies and Google Analytics to help us track user engagement and improve our site. If you'd like to know more information about what data we collect and why, please see our data privacy policy. If you continue to use this site, you consent to our use of cookies.