|
DISPLACE
1.0
A spatial model of fisheries to help sustainable fishing and maritime spatial planning
|
|
DISPLACE
1.0
A spatial model of fisheries to help sustainable fishing and maritime spatial planning
|
DISPLACE is a dynamic, individual-based model for spatial fishing planning and effort displacement integrating underlying fish population models. The DISPLACE project develops and provides a platform primarily for research purposes to transform the fishermen detailed knowledge into models, evaluation tools, and methods that can provide the fisheries with research and advice. By conducting a ecological and socio-economic impact assessment the model intends to serve as an aid to decision-making for (fishery) managers. An impact assessment will help answering on what are the impacts of the different policy options and who will be affected. By quantifying the effects the assessment will measure how the different options compare, for example how different the options perform in achieving the objective(s) of the policy.
Please read our CONTRIBUTING statement here
Look at the Release section on this GitHub repository to download an installer for Windows. Alternatively, look at the google drive for DISPLACE for Unix or MacOSX packages, also hosting additional files i.e. possible dependencies and the DISPLACE software development kit.
Launch the installer application, and follow the guide. There are no prerequisites on Windows, and the application should work out of the box.
Open the DMG file, then drop the program in the Application folder. There are no prerequisites on MacOS, and the application should work out of the box.
Ubuntu 18.04LTS has a few prerequisites that must be installed before installing the displace package itself.
Run the following command to install the prerequisites:
Then install the msqlitecpp packages provided in the download section:
Finally, install the displace package:
If you have any difficulty, try fixing the package dependencies by running:
Any missing package should be automatically installed.
compiling with CMake (preferred)
compiling on HPC (simulator only)
making the displace sdk (optional)
compiling on Windows (deprecated)
compiling on MacOSX deprecated)
Can be found here
Procedure for updating the doxygen documentation without keeping track of git history here
DISPLACE Example datasets are available for download. You need to unzip the downloaded file to a folder that name the dataset with the pattern DISPLACE_input_xx, for example DISPLACE_input_minitest which is the minimal dataset typically used for demonstration purpose.
Run DISPLACE with e.g. displacegui
By default the Model Objects is set to 4. If you want to run a scenario, first make sure your Model Objects is set to [0].
If yes then in the main menu do a "File">"Load a Scenario Model,
and choose a scenario file (a .dat file) you´ll find in the\simusspe subfolder of your DISPLACE dataset. Select the file, click Ok and wait to see the DISPLACE graph plotted on the map.
You can now click Start in the DISPLACE command panel for a DISPLACE simulation to start:
After some object creation and initialization the time step window will shortly update and the simulation run to the end time step. By default, 8762 hourly time steps will be simulated which is approx. the number of hours in one year. in Setup menu the total number of time step can be changed to up to 52586 for a maximal 6-years horizon. Because of the computation time, running more than one year simulation and many replicates are better done on a HPC cluster. Automated shell scripts to run many DISPLACE simulations in parallel on a HPC cluster can be provided on request.
Look at the description of the list of files produced by a DISPLACE simulation. A displaceplot R package has been developed to handle these output text files and produced some plots out of them. Simulation outcomes are also exported as a SQLite database which can be re-loaded within DISPLACE in a Replay mode. The internal structure and simulated data can be further retrieved from the database when using an external SQLite DB browser.
To load a result database into DISPLACE:
Select a DISPLACE db file:
Once loaded, the simulation can be replayed with the Replay command:
Current version of QMapControl supports shapefiles loading ONLY for WGS84 Coordinates system. This is because QMapControl itself uses WGS84 coordinates. So you need to convert your shapefiles if not using this CRS. You can use ogr2ogr or the provided script in the scripts/ directory.
$ ogr2ogr -t_srs WGS84 DEST.shp SRC.shp
Note that DEST file is specified before the source!
Unit testing is performed using the Boost::Test framework. It can be compiled and linked in two ways:
The two methods can be selected by defining boost_test_included in the CONFIG line of the Qt Project. It is enabled by default on Windows (see localconfig.pri).
If boost::test is not available in any form, it can be disabled by removing the units-test option from the CONFIG variable in the pro file.
1.8.15