vinos

https://github.com/platipodium/vinos

Last synced: 6 months ago · JSON representation ·

Repository

Basic Info

Host: GitHub
Owner: platipodium
License: other
Language: Python
Default Branch: main
Size: 31.5 MB

Statistics

Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Releases: 11

Created almost 3 years ago · Last pushed over 1 year ago

Metadata Files

Readme License Citation Codemeta Zenodo

Viable North Sea (ViNoS): A NetLogo Agent-based Model of German Small-scale Fisheries

Viable North Sea (ViNoS) is an Agent-based Model (ABM) of the German Small-scale Fisheries. As a Social-Ecological Systems (SES) model it focusses on the adaptive behaviour of fishers facing regulatory, economic, and resource changes. Small-scale fisheries are an important part both of the cultural perception of the German North Sea coast and of its fishing industry. These fisheries are typically family-run operations that use smaller boats and traditional fishing methods to catch a variety of bottom-dwelling species, including plaice, sole, and brown shrimp.

Fishers in the North Sea face area competition with other uses of the sea---long practiced ones like shipping, gas exploration and sand extractions, and currently increasing ones like marine protection and offshore wind farming (OWF). German authorities have just released a new maritime spatial plan implementing the need for 30% of protection areas (of these 30% as no-use zones) demanded by the United Nations High Seas Treaty and aiming at up to 70 GW of offshore wind power generation by 2045. Fisheries in the North Sea also have to adjust to the northward migration of their established resources following the climate heating of the water. And they have to re-evaluate their economic balance by figuring in the foreseeable rise in oil price and the need for re-investing into their aged fleet.

Installation

The simulation model is implemented in NetLogo, a graphical simulator and programming environment developed for educational purposes. Please install NetLogo version 6.4 or later from https://ccl.northwestern.edu/netlogo/download.shtml. On Windows and macOS systems, double-clicking the NetLogo application or the model code ./netlogo/vinos.nlogo will open NetLogo's integrated development environment. On Linux, start NetLogo with the netlogo-gui.sh shell script provided by NetLogo.

Using the model

Upon opening the model, all data are loaded, variables are initialized with default values and the Interface tab of the IDE is shown, with a North Sea map displayed in the world view panel, and sliders and switches to change parameters. Upon clicking the go button, the model advances and the view as well as the line and bar plots are updated.

Different spatial results can be displayed in the view by selecting in the chooser (NetLogo's term for dropdown menus) scene other variables than bathymetry. We typically look at fishing effort Effort MWh. Different statistical results about the boats can be shown by selection in the bottom left chooser for boat properties. You need to hit the update button after changing a chooser's value.

Please refer to the Info tab in the graphical NetLogo model to learn quickly more about the model and it's mathematical implementation. There is a full documentation of the agent-based model in ODD format available in ./doc/odd/odd.md. In the ./doc folder, there are also sources to open access presentations and other documentations of the model.

Evaluating a model simulation

The typical evaluation of a NetLogo model is visual inspection, as its canonical use is for education or participatory modeling. So go explore the changes in the view and the line and bar plots as you change parameters (a rising diesel price, perhaps?).

The model does write out geospatial data for later analysis with third-party GIS software in the directory ./netlogo/results/. Currently, static maps for water depth, accessibility, and OWF fraction are written out, as well as weekly maps of fishing effort and other dynamic variables. The output format is ESRII ASCII .asc raster data. Fleet statistical data is written out as ./netlogo/results/total_avg.csv comma-separated value tabular format.

Data and supplementary routines

The simulation model uses open data available in the ./data folder. Some of the routines to convert data into a format usable by the NetLogo model are available as R or python routines in the folders ./R, and ./python, respectively. You do not need R or python to run the simulation, unless you would like to recreate some of the input data or project metadata. The ./assets folder contains graphical material used jointly by the NetLogo model and its documentation.

Licenses

The NetLogo model is copyrighted by Helmholtz-Zentrum hereon GmbH, Universität Hamburg, and Hochschule Bremerhaven. It is available under the permissive open source Apache 2.0 license. You may freely use, distribute, and modify the model; if you do so, you must acknowledge us. Please find the full license terms under ./LICENSES/APACHE-2.0.txt

The results from model simulations using this software are the intellectual property of the person operating the model. They are free to choose any license, subject to the constraints imposed by the data used to produce these results. If any of your results critically depend on data (as in: are modifications of) that carries a strong copyleft (e.g. the Creative Commons Share-Alike license class), you have to publish your results under this license.

Some data and utility routines were also contributed by the Thünen Institute, by Hochschule Bremerhaven, non-governmental organizations and government agencies; some are available under licenses different from Apache 2.0. Please refer to the license information available for each individual file in this project for details, and to the full terms of each license available in ./LICENSES/. You may use REUSE.software facilities to view all licenses.

Funding

Initial funding for this software development 2019-2023 was obtained by the German Federal Ministry for Education and Research (BMBF) in the project Multiple Stressors on North Sea Life (MuSSeL) in the framework of the agenda Küstenforschung Nordsee-Ostsee (KüNO III) within the ministry's Forschung für Nachhaltigkeit (FONA) program; the grant number is 03F0862A through E. MuSSeL is a collaborative project by Hereon, Universität Hamburg, Hochschule Bremerhaven, Thünen Institut and the Bundesamt für Seeschiffahrt und Hydrografie.

Further development is supported by the program-oriented funding of the Helmholtz-Gemeinschaft deutscher Forschungszentren within their Earth and Environmental topic "Changing Coasts".

Contributing and reporting

We issue release notes along with each major and minor version. We recommend to use bleeding edge (latest git commit an branch main) during the stabilization phase of the model. We hope you can make good use of the software and find it useful and enjoyable.

We appreciate your feedback, bug reports and improvement suggestions on our issue tracker. We also welcome your contributions, subject to our Contributor Covenant code of conduct and our contributor license agreement. The best way to contribute is by (1) creating a fork off our repository, (2) committing your changes on your fork and then (3) creating a pull request ("PR") to push your changes back to us.

To file an issue or to contribute, you are asked to (1) authenticate with an existing identity and (2) to register on the HIFIS GitLab instance and sign in. When asked, click "Sign in with Helmholtz AAI". On the following page "Login to Helmholtz AAI OAuth2 Authorization Server", search for one of your existing authentication providers (this may be your university, company, ORCID, GitHub, or many others) and provide their login credentials for authorization. If you are not already registered on the HIFIS GitLab instance, a confirmation email will be sent to the primary email address registered with your authentication provider. After clicking the confirmation link, you will also be asked to provide a name on this Gitlab instance; this will be your nickname. Help on this one-time registration process is available from https://hifis.net/tutorial/2021/06/23/how-to-helmholtz-aai.html.

Owner

Name: Carsten Lemmen
Login: platipodium
Kind: user
Location: Geesthacht, Germany
Company: Helmholtz-Zentrum Hereon

Website: https://www.hereon.de
Twitter: platipodium
Repositories: 1
Profile: https://github.com/platipodium

Cross-disciplines walker, world #system #history explorer #ecosystem scientist #physics lecturer @openmodelingfoundation @schism-dev @hereon_helmholtz

Citation (CITATION.cff)

# SPDX-FileCopyrightText: 2022-2024 Helmholtz-Zentrum hereon GmbH
# SPDX-License-Identifier: CC0-1.0
# SPDX-FileContributor: Carsten Lemmen <carsten.lemmen@hereon.de

authors:
  # list author information. see
  # https://github.com/citation-file-format/citation-file-format/blob/main/schema-guide.md#definitionsperson
  # for metadata
  - family-names: "Lemmen"
    given-names: "Carsten"
    affiliation: "Helmholtz-Zentrum Hereon, Institute of Coastal Systems Modeling and Analysis, Germany"
    orcid: 0000-0003-3483-6036
    email: "carsten.lemmen@hereon.de"
  - family-names: Hokamp
    given-names: Sascha
    orcid: 0000-0002-2192-4013
    email: sascha.hokamp@uni-hamburg.de
    affiliation: "Universität Hamburg, Centre for Earth System Research and Sustainability (CEN), Germany"
  - family-names: Örey
    given-names: Serra
    orcid: 0000-0003-3483-6036
    email: soerey@hs-bremerhaven.de
    affiliation: "Hochschule Bremerhaven, Research Cluster Life Sciences, Bremerhaven, Germany"
  - family-names: Scheffran
    given-names: Jürgen
    email: juergen.scheffran@uni-hamburg.de
    orcid: 0000-0002-7171-3062
    affiliation: "Universität Hamburg, Centre for Earth System Research and Sustainability (CEN), Germany"
  - family-names: Probst
    given-names: "W. Nikolaus"
    email: nikolaus.probst@thuenen.de
    affiliation: "Thünen Institute of Sea Fishery, Germany"
    orcid: 0000-0002-0450-2222
  - family-names: Seo
    given-names: "Jieun"
    email: jieun.seo@uni-hamburg.de
    affiliation: "Universität Hamburg, Centre for Earth System Research and Sustainability (CEN), Germany"
  - family-names: Mühlberger
    given-names: "Verena"
    email: verena.muehlberger@uni-hamburg.de
    orcid: 0009-0000-0785-6811
    affiliation: "Universität Hamburg, Centre for Earth System Research and Sustainability (CEN), Germany"
cff-version: 1.2.0
message: "If you use this software, please cite it using these metadata."
title: "Viable North Sea (ViNoS): A NetLogo Agent-based Model of German Small-scale Fisheries"
keywords:
  - NetLogo
  - Agent-based Model
  - ABM
  - North Sea
  - Fisheries
  - MuSSeL project
  - VIABLE
  - Plaice
  - Sole
  - Shrimp
license: "Apache 2.0"
repository-code: "https://codebase.helmholtz.cloud/mussel/netlogo-northsea-species.git"
url: "https://codebase.helmholtz.cloud/mussel/netlogo-northsea-species/"
contact:
  # list maintainer information. see
  # https://github.com/citation-file-format/citation-file-format/blob/main/schema-guide.md#definitionsperson
  # for metadata
  - family-names: "Lemmen"
    given-names: "Carsten"
    affiliation: "Helmholtz-Zentrum Hereon, Institute of Coastal Systems Modeling and Analysis, Germany"
    orcid: 0000-0003-3483-6036
    email: "carsten.lemmen@hereon.de"

version: "1.3.2"
date-released: "2024-03-08"
abstract: "Viable North Sea (ViNoS) is an Agent-based Model (ABM) of the German Small-scale Fisheries.  As a Social-Ecological Systems (SES) model it focusses on the adaptive behaviour of fishers facing regulatory, economic, and resource changes. Small-scale fisheries are an important part both of the cultural perception of the German North Sea coast and of its fishing industry. These fisheries are typically family-run operations that use smaller boats and traditional fishing methods to catch a variety of bottom-dwelling species, including plaice, sole, and brown shrimp. Fishers in the North Sea face area competition with other uses of the sea---long practiced ones like shipping, gas exploration and sand extractions, and currently increasing ones like marine protection and offshore wind farming (OWF).  German authorities have just released a new maritime spatial plan implementing the need for 30% of protection areas demanded by the United Nations High Seas Treaty and aiming at up to 70 GW of offshore wind power generation by 2045.  Fisheries in the North Sea also have to adjust to the northward migration of their established resources following the climate heating of the water.  And they have to re-evaluate their economic balance by figuring in the foreseeable rise in oil price and the need for re-investing into their aged fleet."

CodeMeta (codemeta.json)

{
  "@context": "https://doi.org/10.5063/schema/codemeta-2.0",
  "@type": "SoftwareSourceCode",
  "license": "https://spdx.org/licenses/Apache-2.0",
  "codeRepository": "https://codebase.helmholtz.cloud/mussel/netlogo-northsea-species.git",
  "contIntegration": "https://codebase.helmholtz.cloud/mussel/netlogo-northsea-species/-/pipelines",
  "dateCreated": "2022-01-07",
  "datePublished": "2023-04-17",
  "dateModified": "2024-03-08",
  "issueTracker": "https://codebase.helmholtz.cloud/mussel/netlogo-northsea-species/-/issues",
  "name": "Viable North Sea (ViNoS): A NetLogo Agent-based Model of German Small-scale Fisheries",
  "version": "1.3.2",
  "description": "Viable North Sea (ViNoS) is an Agent-based Model (ABM) of the German Small-scale Fisheries.  As a Social-Ecological Systems (SES) model it focusses on the adaptive behaviour of fishers facing regulatory, economic, and resource changes. Small-scale fisheries are an important part both of the cultural perception of the German North Sea coast and of its fishing industry. These fisheries are typically family-run operations that use smaller boats and traditional fishing methods to catch a variety of bottom-dwelling species, including plaice, sole, and brown shrimp.\n",
  "applicationCategory": "Social Ecological Systems",
  "funding": "03F0862A",
  "developmentStatus": "active",
  "isPartOf": "https://mussel-project.de",
  "funder": {
    "@type": "Organization",
    "name": "BMBF"
  },
  "keywords": [
    "NetLogo",
    "North Sea",
    "Fishery",
    "Shrimp",
    "Plaice",
    "Sole",
    "Agent-based Model",
    "MuSSeL"
  ],
  "programmingLanguage": [
    "NetLogo"
  ],
  "runtimePlatform": [
    "JVM"
  ],
  "operatingSystem": [
    "Linux",
    "Windows",
    "macOS"
  ],
  "author": [
    {
      "@type": "Person",
      "@id": "https://orcid.org/0000-0003-3483-6036",
      "givenName": "Carsten",
      "familyName": "Lemmen",
      "email": "carsten.lemmen@hereon.de",
      "affiliation": {
        "@type": "Organization",
        "name": "Helmholtz-Zentrum Hereon"
      }
    },
    {
      "@type": "Person",
      "@id": "https://orcid.org/0000-0002-2192-4013",
      "givenName": "Sascha",
      "familyName": "Hokamp",
      "email": "sascha.hokamp@uni-hamburg.de",
      "affiliation": {
        "@type": "Organization",
        "name": "Universitt Hamburg"
      }
    },
    {
      "@type": "Person",
      "@id": "https://orcid.org/0000-0003-3483-6036",
      "givenName": "Serra",
      "familyName": "rey",
      "email": "soerey@hs-bremerhaven.de",
      "affiliation": {
        "@type": "Organization",
        "name": "Hochschule Bremerhaven"
      }
    },
    {
      "@type": "Person",
      "@id": "https://orcid.org/0000-0002-0450-2222",
      "givenName": "W. Nikolaus",
      "familyName": "Probst",
      "email": "nikolaus.probst@thuenen.de",
      "affiliation": {
        "@type": "Organization",
        "name": "Thnen Institut for Sea Fishery"
      }
    },
    {
      "@type": "Person",
      "@id": "https://orcid.org/0000-0002-7171-3062",
      "givenName": "Jrgen",
      "familyName": "Scheffran",
      "email": "juergen.scheffran@uni-hamburg.de",
      "affiliation": {
        "@type": "Organization",
        "name": "Universitt Hamburg"
      }
    }
  ],
  "maintainer:": "https://orcid.org/0000-0003-3483-6036",
  "contributor": [
    {
      "@type": "Person",
      "givenName": "Jieun",
      "familyName": "Seo",
      "email": "jieun.seo@uni-hamburg.de",
      "affiliation": {
        "@type": "Organization",
        "name": "Universitt Hamburg"
      }
    },
    {
      "@type": "Person",
      "@id": "https://orcid.org/0009-0000-0785-6811",
      "givenName": "Verena",
      "familyName": "Mhlberger",
      "email": "verena.muehlberger@uni-hamburg.de",
      "affiliation": {
        "@type": "Organization",
        "name": "Universitt Hamburg"
      }
    }
  ]
}

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Source Science