prt_report_my_pet

Creates report_my_pet.html in specified directory

Contents

Syntax

prt_report_my_pet (focusSpecies, comparisonSpecies, T, f, destinationFolder, filename)

Description

Writes report_my_pet.html with a list of parameters and implied model properties for selected species. focusSpecies can be empty, or a single species; comparisonSpecies can be empty (if focusSpecies is specified), or a cell-string of entries; their parameter values are taken from allStat. The parameters of the focusSpeces are obtained from one of three sources:

The traits are computed using statistics_st.

Input:

Output:

Remarks

If the focus species is specified by string (rather than by data), its parameters are obtained from allStat.mat. The parameters of the comparison species are obtained from allStat.mat, and the data of creation of that file is indicated on the top of the report. The allStat.mat is available via the Collection tab of the Add-my-pet webpage (https://www.bio.vu.nl/thb/deb/deblab/add_my_pet/), and needs to be in the work folder or on a path. AmPtool functions select or clade can be used to create a cell string of comparison species.

The difference between focus and comparison species only becomes important in the case of more than one comparison species and color-coding is used to indicate how eccentric the focus-species is from the comparison-species. The lava color-scheme is used, from white (high) to black (low), via red and blue, to show the value of the eccentricity. This quantity is computed for each statistic and parameter and is the squared distance to the mean of the comparison species as a hyperbolically-transformed fraction of the variance for the comparison-species. Function color_lava is used to convert the eccentricity to rgb-colors. If the focus species also occurs in the comparison species, it is removed from that list. So, if the comparison species all belong to the same genus, for instance, you can change your selection of focus species, and so change colors, without affecting numbers. If you just have a set of species and want to avoid colors, treat them all as comparison species, leaving focusSpecies empty. If model types differ among species in the tabel, only parameter and statistics fields for the focus species are shown. In absence of a focus species, the first comparison species serves this role. The default name of the output file is report_My_pet, but this name is replaced by filename, if specified, which is not opened automatically. If filename is specified, destinationFolder must be specified as well

The search boxes in the top-line of the report can be used to symbols, units, descriptions, but also (on the top-right) to make selections from the statictics and/or the parameters. NA means "not applicable": the parameter or statistic does not depend on temperature or food. nan means "not a number": the model for that species does not have that field.

Example of use