Merge pull request #40 from LimesLimits/main

submit livestock herd demography module

Author: Andros-Spica

2025-Verhagen-001/CHANGELOG.md

@@ -0,0 +1,2 @@
+## 1.0.0
+- Creation of the module.

2025-Verhagen-001/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright 2025 Jamie Joyce and Philip Verhagen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

2025-Verhagen-001/NASSA.yml

@@ -0,0 +1,123 @@
+id: 2025-Verhagen-001
+nassaVersion: 1.0.0
+moduleType: Submodel
+title: Livestock demography
+moduleVersion: 1.1.0
+contributors:
+ - name: Joyce, Jamie
+   roles: [ "Author", "Copyright Holder"]
+   email: jamie.alexander.joyce@gmail.com
+   orcid: 0000-0002-1825-0097
+ - name: Verhagen, Philip
+   roles: [ "Creator", "Contributor", "Copyright Holder", "Thesis Advisor" ]
+   email: j.w.h.p.verhagen@vu.nl
+   orcid: 0000-0001-8166-122X
+lastUpdateDate: 2025-05-05
+description: >
+  This submodel simulates livestock herd demography and slaughter effects. Initially part of the ROMFARMS model for animal husbandry on the Dutch Roman frontier, it focused on cattle, sheep, and horses. However, the code is adaptable for various animals, regions, and historical periods.
+relatedModules: 
+references:
+  moduleReferences: [ Joyce-2019a, Weijgertse-2020, Joyce-2021, Verhagen-2021 ]
+domainKeywords:
+  regions:
+    - Netherlands 
+  periods: 
+    - Roman period
+  subjects: 
+    - rural economy
+    - animal husbandry
+    - livestock demography
+modellingKeywords:
+  - agent initialisation
+  - parameter initialisation
+  - agent variables
+  - agent behaviour (self)
+  - output visualisation
+programmingKeywords:
+  - Functional
+  - Object-Oriented
+implementations:
+  - language: NetLogo
+    softwareDependencies: 
+    - NetLogo 6.4.0
+inputs:
+  - name: species-type
+    type: string
+    description: animal species, OPTIONAL; for multiple species different rules can be specified if desired
+  - name: alphaA
+    type: floating point
+    description: age of senescence of animal
+  - name: alpha
+    type: floating point
+    description: standard deviation age of senescence
+  - name: NMR
+    type: floating point
+    description: mortality rate of neonatal animals
+  - name: BMR
+    type: floating point
+    description: background natural annual mortality rate of animals
+  - name: FR
+    type: floating point
+    description: fertility rate of female animals
+  - name: YAA
+    type: floating point
+    description: maximum age of young animal
+  - name: AAA
+    type: floating point
+    description: minimum age of adult animal
+  - name: YMR
+    type: floating point
+    description: mortality rate of young animal for slaughter
+  - name: IMR
+    type: floating point
+    description: mortality rate of immature animal for slaughter
+  - name: AMR
+    type: floating point
+    description: mortality rate of adult animal for slaughter
+  - name: animals
+    type: turtle-set
+    description: animals found in livestock herd
+  - name: sex (agent attribute)
+    type: string
+    description: sex of animal (F/M)
+  - name: age (agent attribute)
+    type: integer
+    description: age of animal
+  - name: fertility (agent attribute)
+    type: floating point
+    description: fertility of animal
+  - name: lactating (agent attribute)
+    type: string
+    description: lactation state of animal (Y/N)
+  - name: survivorship (agent attribute)
+    type: floating point
+    default: 1.0
+    description: survivorship of animal
+outputs:
+  - name: pop-list
+    type: integer
+    description: number of animals
+  - name: d-pop 
+    type: integer
+    description: number of animals at end of year
+  - name: d1-pop
+    type: integer
+    description: number of animals at start of year
+  - name: livestock
+    type: turtle-set
+    description: current turtle set of animals
+  - name: pop-growth
+    type: floating point
+    description: herd population growth as the percentage increase or decrease from the previous year
+license: MIT
+
+
+
+
+
+
+
+
+
+
+

2025-Verhagen-001/README.md

@@ -0,0 +1,32 @@
+# Livestock herd demography
+*by Philip Verhagen* 
+
+A NetLogo simulation of livestock herd demography. This module allows you to simulate the population size of a herd of livestock, depending on the slaughter practices applied. Default inputs are provided for cattle husbandry.
+
+## License
+
+MIT
+
+## References
+
+Joyce, Jamie A. 2019a. Farming along the limes: Using agent-based modelling to investigate possibilities for subsistence and surplus-based agricultural production in the Lower Rhine delta between 12BCE and 270CE. PhD-Thesis, Vrije Universiteit Amsterdam. Available at [https://research.vu.nl/en/publications/farming-along-the-limes-using-agent-based-modelling-to-investigat](https://research.vu.nl/en/publications/farming-along-the-limes-using-agent-based-modelling-to-investigat)
+
+Joyce, Jamie A. 2019b. ‘Modelling Agricultural Strategies in the Dutch Roman Limes via Agent-Based Modelling (ROMFARMS)’. In Finding the Limits of the Limes: Modelling Demography, Economy and Transport on the Edge of the Roman Empire, edited by Philip Verhagen, Jamie Joyce, and Mark R. Groenhuijzen. Computational Social Sciences. Springer International Publishing. [https://doi.org/10.1007/978-3-030-04576-0_7](https://doi.org/10.1007/978-3-030-04576-0_7).
+
+Joyce, Jamie A., and Philip Verhagen. 2021. ROMFARMS v1.2. [https://github.com/LimesLimits/ROMFARMS](https://github.com/LimesLimits/ROMFARMS).
+
+Verhagen, Philip, Maurice de Kleijn, and Jamie A. Joyce. 2021. ‘Different Models, Different Outcomes? A Comparison of Approaches to Land Use Modeling in the Dutch Limes’. Heritage 4 (3): 2081–104. [https://doi.org/10.3390/heritage4030118](https://doi.org/10.3390/heritage4030118).
+
+Weijgertse, S. 2020. ‘What Is in the Black Box? Assessing the Equivalence of Different Algorithms from Similar Model Components in Archaeological Agent-Based Land-Use Models’. MSc thesis, Leiden University.
+
+## Further information
+
+This module was originally part of the ROMFARMS model (Joyce 2019) in order to simulate different scenarios of animal husbandry practice in the Dutch Roman frontier zone. The original module focused on understanding the economic viability of stockbreeding of cattle, sheep and horses for the Roman army. In particular slaughter rate proved to be an important parameter for this.
+
+The standard input values used in the submodule are taken from the ROMFARMS source code, and are described and substantiated in Joyce (2019). However, users are free to adapt these values to their own research questions. The original module was developed for a runtime of 100 ticks (years), during which the herd size growth will be relatively modest using these parameters. However, after approx. 400 ticks the herd population will start to grow exponentially.
+
+
+
+
+
+