The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

ISS::AH::Predictor - Provides prediction models for adult height (AH) in patients with idiopathic short stature (ISS).

SYNOPSIS

use ISS::AH::Predictor;

ATTRIBUTES

MODELS

This attribute contains the default models and parameters, estimated by Blum et al.

my $models = ISS::AH::Predictor::MODELS;

# each element of the $models arrayref is an arrayref with estimated parameters of one model
$models->[0]->[0]; # first parameter (intercept) of the first model

PARAMETER_NAMES

Hashref that contains the names of the model parameters for each variable index.

SUBROUTINES/METHODS

predict

Provide a hash with properties of a subject to predict adult height (AH). You can also provide custom model parameters to overwrite the default once from Blum et al.

my $ah = ISS::AH::Predictor::predict(
  age           => ...,    # years
  body_height   => ...,    # cm
  target_height => ...,    # cm
  mother_height => ...,    # cm
  father_height => ...,    # cm
  bone_age      => ...,    # years
  birth_weight  => ...,    # kg
  sex           => ...,    # 'male' or 'female'
  models        => [ ... ],
);

get_model

Returns an appropriate model with a set of parameters for the given subject properties. The returned model is determined by the amount of available parameters. You can also provide custom model parameters to overwrite the default once from Blum et al.

If no model is appropriate, the result is undef. If there are multiple matching models (with identical parameter count), the first one will be returned.

my $model = ISS::AH::Predictor::get_model(
  age           => ...,    # years
  body_height   => ...,    # cm
  target_height => ...,    # cm
  mother_height => ...,    # cm
  father_height => ...,    # cm
  bone_age      => ...,    # years
  birth_weight  => ...,    # kg
  sex           => ...,    # 'male' or 'female'
  models        => [ ... ],
);

AUTHOR

Christoph Beger, <christoph.beger at medizin.uni-leipzig.de>