results_pets
Computes model predictions and handles them
Contents
Syntax
results_pets(par, metaPar, txtPar, data, auxData, metaData, txtData, weights)
Description
Computes model predictions and handles them (by plotting, saving or publishing). All input structures have the species name as first field, which is done by estim_pars. The user composes these structures via the mydata_my_pet and pars_init_my_pet files, where the first field directly relates to the variables. This function also requires a working predict_my_pet.
Input
- par: structure with parameters of species
- metaPar: structure with information on metaparameters
- txtPar: structure with information on parameters
- data: structure with data for species
- auxData: structure with auxilliairy data that is required to compute predictions of data (e.g. temperature, food.). auxData is unpacked in predict and the user needs to construct predictions accordingly.
- metaData: structure with information on the entry
- txtData: structure with information on the data
- weights: structure with weights for each data set
Remarks
Depending on estim_options settings: writes to results_my_pet.mat and/or results_my_pet_i.png and/or my_pet_res.html and/or report_my_pet.html and/or my_pet_pop.html; writes and/or plots to screen.
Plots use lava-colour scheme; from high to low: white, red, blue, black. In grp-plots, colours are assigned from high to low. Since the standard colour for females is red, and for males blue, compose set with females first, then males.
Bi-variate data requires field auxData.treat.(name-of-data-set) with a 2-cell string: the first element 0 for no interpolation, 1 for mesh, 2 for surface; the second element is a cell-string of a length equal to the number of values for the second independent variable. (So one minus the number of columns of (name-of-data-set); the first column is the first independent variable). If the second element of treat is numeric, there must be a field txtData.units.treat.(name-of-data-set). If no interpolation is used, the legend is plotted in a separate figure.
If output options -5/5 or 6 are used, and comparison species are included in the traits-table. Function clade is used to identify a few most related species, unless global refPets is defined in the run-file with names to species to compare with.
In the case of multiple species, par and metaPar have the species names as first field, but not so for a single species
For curators: my_pet_res.html is written in the directory entries, and deleted by run_collection, which writes another file with that name in directory entries_web.