Configuration
Runtime configuration schema
The configuration file config_data/config.json
provides a number of modelling
parameters that are supposedly invariant across experiments. Those values have been extracted
from available literature and documented wherever possible. Here we provide an autogenerated
list of parameters.
The schema is used for both validation and parsing purposes.
RuntimeConfig
type |
object |
||||
properties |
|||||
|
Global seed to use in the simulations |
||||
type |
integer |
||||
|
Stage-age average evolution times (in days) |
||||
type |
object |
||||
properties |
|||||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
Weibull power transformation constant for each development stage |
||||
type |
object |
||||
properties |
|||||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
Weibull shape transformation constant for each development stage |
||||
type |
object |
||||
properties |
|||||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
10 °C median development time |
||||
type |
object |
||||
properties |
|||||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
Lice development rates from the ith stage to the next |
||||
properties |
|||||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
Infection expectation |
||||
type |
number |
||||
|
Infection regression coefficient |
||||
type |
number |
||||
|
Log-expectation of fish weight |
||||
type |
number |
||||
|
Fish mortality sigmoid center |
||||
type |
number |
||||
|
Fish mortality sigmoid steepness |
||||
type |
number |
||||
|
Background lice mortality rates per stage |
||||
type |
object |
||||
properties |
|||||
|
Aldrin et al., 2017 |
||||
type |
number |
||||
|
Tucker et al., 2002 |
||||
type |
number |
||||
|
Stien et al., 2005 |
||||
type |
number |
||||
|
Stien et al., 2005 |
||||
type |
number |
||||
|
Stien et al., 2005 |
||||
type |
number |
||||
|
Initial number of viable eggs after the first extrusion |
||||
type |
number |
||||
|
Exponential coefficient on viable eggs depending on age |
||||
type |
number |
||||
|
Female unavailability time after mating (in days) |
||||
type |
integer |
||||
|
Sigmoid parameters that pilot the average smolt-to-adult average weight development |
||||
type |
object |
||||
properties |
|||||
|
type |
number |
|||
|
type |
number |
|||
|
type |
number |
|||
|
Selling rate for fish kg (in GBP) |
||||
type |
string |
||||
pattern |
^[0-9]+\.[0-9]{2}$ |
||||
|
Genetic ratios of lice population |
||||
type |
object |
||||
|
The ratio of offspring coming being expelled from the external pressure to make available in the reservoir |
||||
type |
number |
||||
|
The length of the rolling average to consider in the external pressure calculation |
||||
|
Mutation rate, as in number of individual mutation events that can happen out of the number of offsprings. For example, 1e-5 is one mutation every 10,000 extruded eggs |
||||
type |
number |
||||
|
Rate at which an adult male detaches from a dying fish and survives |
||||
type |
number |
||||
|
The allowed aggregation rate at any time |
||||
type |
number |
||||
|
Parameters related to specific treatments |
||||
type |
array |
||||
items |
type |
object |
|||
properties |
|||||
|
The name of the treatment |
||||
type |
string |
||||
|
The type of treatment |
||||
enum |
chemical, thermal, mechanical |
||||
|
Lookup table to translate between genotype. |
||||
type |
object |
||||
|
Fitted quadratic regression coefficients from Overton et al. |
||||
type |
array |
||||
items |
type |
number |
Environment-specific configuration schema
Let us consider the Fyne
environment located in config_data/Fyne
for starters.
The organisation-specific configuration is thus inside params.json
.
Similarly to the runtime configuration, we provide a well-documented schema.
FarmConfig
type |
object |
||||
properties |
|||||
|
Organisation name |
||||
type |
string |
||||
|
Simulation start date |
||||
type |
string |
||||
|
Simulation end date |
||||
type |
string |
||||
|
Sealice per day per cage/farm arriving from wildlife. Note that this value has been determined experimentally in the original code. |
||||
type |
integer |
||||
|
Fixed infrastructure cost (per 28 activity day) |
||||
type |
string |
||||
pattern |
^[0-9]+\.[0-9]{2}$ |
||||
|
The initial genotype ratio distribution |
||||
type |
object |
||||
|
Dirichlet learning rate |
||||
type |
number |
||||
|
FarmConfig |
||||
Farm-specific configuration |
|||||
type |
array |
||||
items |
type |
object |
|||
properties |
|||||
|
Number of cages on the farm |
||||
type |
integer |
||||
|
Location of the farm (in northing and easthing) |
||||
type |
array |
||||
items |
type |
number |
|||
maxLength |
2 |
||||
minLength |
2 |
||||
|
Starting number of fish. We assume this to be constant across all cages |
||||
type |
integer |
||||
|
Start date of simulation of the farm |
||||
type |
string |
||||
|
Start dates for individual cages. This is discouraged |
||||
type |
array |
||||
|
Type of applied treatment |
||||
enum |
emb, thermolicer |
||||
|
Treatment dates for each cage |
||||
type |
array |
||||
|
Maximum number of treatments allowed within one year |
||||
type |
integer |
||||
|
Time distance (in days) between fish samplings |
||||
type |
integer |
||||
|
Probability to defect and not apply treatment contemporarily with the other farms |
||||
type |
number |