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>