NAME

WHO::GrowthReference::Table - Lookup height/weight in the WHO growth chart (a.k.a. growth reference, growth standards)

VERSION

This document describes version 0.012 of WHO::GrowthReference::Table (from Perl distribution WHO-GrowthReference-Table), released on 2022-06-07.

SYNOPSIS

 use WHO::GrowthReference::Table qw(get_who_growth_reference);

 # get mean height & weight of a 3-year old girl

 my $res = get_who_growth_reference(gender => "F", dob => time() - 3*365.25*86400);
 # => [200, "OK", {
 #      age => "36.0 month(s)",
 #      height_mean => 95.034, # cm
 #      weight_mean => 13.9,   # kg
 #      height_P01  => ..., # height at 0.1% percentile
 #      height_P1   => ..., # height at 1% percentile
 #      height_Z-3  => ..., # height at -3 SD
 #      height_Z-2  => ..., # height at -2 SD
 #      ...
 #     }]

 # you have a 3.5-year old boy weighing at 14.8kg and with a height of 102cm,
 # calculate the percentiles

 my $res = get_who_growth_reference(gender => "M", dob => time() - 3.5*365.25*86400, weight=>14.8, height=>102);
 # => [200, "OK", {
 #      age => "42.0 month(s)",
 #      height_mean => 99.844, # cm
 #      height_percentile => 70.2, # your boy's height is above world average, about 70.2% of boys of the same age are shorter than your boy
 #      height_zscore => ...,
 #      weight_mean => 15.3,   # kg
 #      weight_percentile => 39.6, # your boy's weight is below world average, about 39.6% of boys of the same age weigh less than your boy
 #      weight_zscore => ...,
 #      height_P01 => ...,
 #      ...
 #      height_potential => ...,
 #      height_potential_Z0 => ...,
 #      weight_potential_10y => ...,
 #      weight_potential_10y_Z0 => ...,
 #     }]

DESCRIPTION

FUNCTIONS

get_who_growth_reference

Usage:

 get_who_growth_reference(%args) -> [$status_code, $reason, $payload, \%result_meta]

Lookup height/weight in the WHO growth chart (a.k.a. growth reference, growth standards).

Examples:

  • Get weight/height information for a boy that is born on May 4, 2017:

     get_who_growth_reference(gender => "M", dob => "2017-05-04");

    Result:

     [
       200,
       "OK",
       {
         age           => "61.0 month(s)",
         bmi_mean      => 15.264,
         bmi_P01       => 12.041,
         bmi_P1        => 12.72,
         bmi_P10       => 13.764,
         bmi_P15       => 14.03,
         bmi_P25       => 14.441,
         bmi_P3        => 13.148,
         bmi_P5        => 13.384,
         bmi_P50       => 15.264,
         bmi_P75       => 16.172,
         bmi_P85       => 16.7,
         bmi_P90       => 17.074,
         bmi_P95       => 17.656,
         bmi_P97       => 18.052,
         bmi_P99       => 18.845,
         bmi_P999      => 20.355,
         bmi_SD0       => 15.264,
         bmi_SD1       => 16.645,
         bmi_SD1neg    => 14.071,
         bmi_SD2       => 18.259,
         bmi_SD2neg    => 13.031,
         bmi_SD3       => 20.166,
         bmi_SD3neg    => 12.118,
         bmi_SD4       => 22.072,
         bmi_SD4neg    => 11.204,
         gender        => "M",
         height_mean   => 110.265,
         height_P01    => 96.076,
         height_P1     => 99.583,
         height_P10    => 104.381,
         height_P15    => 105.506,
         height_P25    => 107.168,
         height_P3     => 101.629,
         height_P5     => 102.712,
         height_P50    => 110.265,
         height_P75    => 113.362,
         height_P85    => 115.023,
         height_P90    => 116.149,
         height_P95    => 117.817,
         height_P97    => 118.9,
         height_P99    => 120.946,
         height_P999   => 124.453,
         height_SD0    => 110.265,
         height_SD1    => 114.856,
         height_SD1neg => 105.673,
         height_SD2    => 119.448,
         height_SD2neg => 101.082,
         height_SD3    => 124.039,
         height_SD3neg => 96.49,
         height_SD4    => 128.63,
         height_SD4neg => 91.899,
         weight_mean   => 18.506,
         weight_P01    => 12.581,
         weight_P1     => 13.802,
         weight_P10    => 15.711,
         weight_P15    => 16.204,
         weight_P25    => 16.967,
         weight_P3     => 14.58,
         weight_P5     => 15.013,
         weight_P50    => 18.506,
         weight_P75    => 20.216,
         weight_P85    => 21.212,
         weight_P90    => 21.92,
         weight_P95    => 23.023,
         weight_P97    => 23.774,
         weight_P99    => 25.276,
         weight_P999   => 28.126,
         weight_SD0    => 18.506,
         weight_SD1    => 21.109,
         weight_SD1neg => 16.279,
         weight_SD2    => 24.165,
         weight_SD2neg => 14.367,
         weight_SD3    => 27.77,
         weight_SD3neg => 12.718,
         weight_SD4    => 31.375,
         weight_SD4neg => 11.07,
       },
       {
         "func.raw_weight" => [
           61,
           -0.2026,
           18.5057,
           0.12988,
           12.581,
           13.802,
           14.58,
           15.013,
           15.711,
           16.204,
           16.967,
           18.506,
           20.216,
           21.212,
           21.92,
           23.023,
           23.774,
           25.276,
           28.126,
         ],
       },
     ]
  • Get weight/height information for a 6.5yo girl:

     get_who_growth_reference(gender => "F", age => "6.5y");

    Result:

     [
       200,
       "OK",
       {
         age           => "78.0 month(s)",
         bmi_mean      => 15.32,
         bmi_P01       => 11.645,
         bmi_P1        => 12.365,
         bmi_P10       => 13.525,
         bmi_P15       => 13.832,
         bmi_P25       => 14.315,
         bmi_P3        => 12.832,
         bmi_P5        => 13.096,
         bmi_P50       => 15.32,
         bmi_P75       => 16.492,
         bmi_P85       => 17.206,
         bmi_P90       => 17.728,
         bmi_P95       => 18.57,
         bmi_P97       => 19.165,
         bmi_P99       => 20.41,
         bmi_P999      => 23.013,
         bmi_SD0       => 15.32,
         bmi_SD1       => 17.131,
         bmi_SD1neg    => 13.879,
         bmi_SD2       => 19.482,
         bmi_SD2neg    => 12.704,
         bmi_SD3       => 22.668,
         bmi_SD3neg    => 11.725,
         bmi_SD4       => 25.855,
         bmi_SD4neg    => 10.746,
         gender        => "F",
         height_mean   => 117.977,
         height_P01    => 101.611,
         height_P1     => 105.657,
         height_P10    => 111.19,
         height_P15    => 112.488,
         height_P25    => 114.405,
         height_P3     => 108.016,
         height_P5     => 109.266,
         height_P50    => 117.977,
         height_P75    => 121.549,
         height_P85    => 123.466,
         height_P90    => 124.764,
         height_P95    => 126.688,
         height_P97    => 127.938,
         height_P99    => 130.297,
         height_P999   => 134.343,
         height_SD0    => 117.977,
         height_SD1    => 123.273,
         height_SD1neg => 112.681,
         height_SD2    => 128.569,
         height_SD2neg => 107.385,
         height_SD3    => 133.865,
         height_SD3neg => 102.089,
         height_SD4    => 139.161,
         height_SD4neg => 96.793,
         weight_mean   => 21.227,
         weight_P01    => 13.932,
         weight_P1     => 15.333,
         weight_P10    => 17.626,
         weight_P15    => 18.239,
         weight_P25    => 19.206,
         weight_P3     => 16.252,
         weight_P5     => 16.773,
         weight_P50    => 21.227,
         weight_P75    => 23.591,
         weight_P85    => 25.028,
         weight_P90    => 26.077,
         weight_P95    => 27.761,
         weight_P97    => 28.945,
         weight_P99    => 31.399,
         weight_P999   => 36.41,
         weight_SD0    => 21.227,
         weight_SD1    => 24.877,
         weight_SD1neg => 18.333,
         weight_SD2    => 29.572,
         weight_SD2neg => 15.998,
         weight_SD3    => 35.757,
         weight_SD3neg => 14.087,
         weight_SD4    => 41.942,
         weight_SD4neg => 12.175,
       },
       {
         "func.raw_weight" => [
           78,
           -0.5185,
           21.2274,
           0.1523,
           13.932,
           15.333,
           16.252,
           16.773,
           17.626,
           18.239,
           19.206,
           21.227,
           23.591,
           25.028,
           26.077,
           27.761,
           28.945,
           31.399,
           36.41,
         ],
       },
     ]
  • See percentiles/z-scores for a 6yo boy weighing 17kg and having a height of 102cm:

     get_who_growth_reference(gender => "M", age => "6y", height => 102, weight => 17);

    Result:

     [
       200,
       "OK",
       {
         age                  => "72.0 month(s)",
         bmi                  => 16.3398692810458,
         bmi_mean             => 15.306,
         bmi_P01              => 12.066,
         bmi_P1               => 12.733,
         bmi_P10              => 13.773,
         bmi_P15              => 14.042,
         bmi_P25              => 14.459,
         bmi_P3               => 13.157,
         bmi_P5               => 13.393,
         bmi_P50              => 15.306,
         bmi_P75              => 16.258,
         bmi_P85              => 16.819,
         bmi_P90              => 17.221,
         bmi_P95              => 17.854,
         bmi_P97              => 18.291,
         bmi_P99              => 19.176,
         bmi_P999             => 20.91,
         bmi_percentile       => 76.4593454731863,
         bmi_SD0              => 15.306,
         bmi_SD1              => 16.761,
         bmi_SD1neg           => 14.083,
         bmi_SD2              => 18.52,
         bmi_SD2neg           => 13.04,
         bmi_SD3              => 20.689,
         bmi_SD3neg           => 12.141,
         bmi_SD4              => 22.858,
         bmi_SD4neg           => 11.242,
         bmi_zscore           => 0.71056307975653,
         gender               => "M",
         height_mean          => 115.951,
         height_P01           => 100.726,
         height_P1            => 104.49,
         height_P10           => 109.637,
         height_P15           => 110.845,
         height_P25           => 112.628,
         height_P3            => 106.685,
         height_P5            => 107.847,
         height_P50           => 115.951,
         height_P75           => 119.274,
         height_P85           => 121.057,
         height_P90           => 122.265,
         height_P95           => 124.055,
         height_P97           => 125.217,
         height_P99           => 127.412,
         height_P999          => 131.176,
         height_percentile    => 0.404622741764081,
         height_potential     => 155.876968650372,
         height_potential_SD0 => 176.543,
         height_SD0           => 115.951,
         height_SD1           => 120.878,
         height_SD1neg        => 111.024,
         height_SD2           => 125.804,
         height_SD2neg        => 106.097,
         height_SD3           => 130.731,
         height_SD3neg        => 101.171,
         height_SD4           => 135.658,
         height_SD4neg        => 96.244,
         height_zscore        => -2.83170929760455,
         weight_mean          => 20.514,
         weight_P01           => 13.913,
         weight_P1            => 15.248,
         weight_P10           => 17.361,
         weight_P15           => 17.912,
         weight_P25           => 18.768,
         weight_P3            => 16.105,
         weight_P5            => 16.585,
         weight_P50           => 20.514,
         weight_P75           => 22.48,
         weight_P85           => 23.637,
         weight_P90           => 24.467,
         weight_P95           => 25.767,
         weight_P97           => 26.661,
         weight_P99           => 28.464,
         weight_P999          => 31.948,
         weight_percentile    => 7.67396907216494,
         weight_SD0           => 20.514,
         weight_SD1           => 23.517,
         weight_SD1neg        => 17.996,
         weight_SD2           => 27.129,
         weight_SD2neg        => 15.87,
         weight_SD3           => 31.508,
         weight_SD3neg        => 14.063,
         weight_SD4           => 35.888,
         weight_SD4neg        => 12.256,
         weight_zscore        => -1.46848541862653,
       },
       {
         "func.raw_weight" => [
           72,
           -0.318,
           20.5137,
           0.13372,
           13.913,
           15.248,
           16.105,
           16.585,
           17.361,
           17.912,
           18.768,
           20.514,
           22.48,
           23.637,
           24.467,
           25.767,
           26.661,
           28.464,
           31.948,
         ],
       },
     ]

Caveats:

Currently the z-zcore line values (e.g. height_Z1, height_Z-1, etc) are calculated using linear interpolation.

This function is not exported by default, but exportable.

Arguments ('*' denotes required arguments):

  • age => duration

  • dob => date

  • gender* => str

  • height => float

    Specify height to calculate percentile.

  • now => date

    Assume now is this date, instead of current date.

  • weight => float

    Specify weight to calculate percentile.

Returns an enveloped result (an array).

First element ($status_code) is an integer containing HTTP-like status code (200 means OK, 4xx caller error, 5xx function error). Second element ($reason) is a string containing error message, or something like "OK" if status is 200. Third element ($payload) is the actual result, but usually not present when enveloped result is an error response ($status_code is not 2xx). Fourth element (%result_meta) is called result metadata and is optional, a hash that contains extra information, much like how HTTP response headers provide additional metadata.

Return value: (any)

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/WHO-GrowthReference-Table.

SOURCE

Source repository is at https://github.com/perlancar/perl-WHO-GrowthReference-Table.

SEE ALSO

WHO::GrowthReference::GenChart uses this module to make growth charts.

For CLI frontends for this module and more, see App::WHOGrowthReferenceUtils.

Source data is from http://www.who.int/childgrowth/standards/en/. Note that CDC also publishes growth standards; I might write CDC::GrowthReference::Table too someday.

AUTHOR

perlancar <perlancar@cpan.org>

CONTRIBUTING

To contribute, you can send patches by email/via RT, or send pull requests on GitHub.

Most of the time, you don't need to build the distribution yourself. You can simply modify the code, then test via:

 % prove -l

If you want to build the distribution (e.g. to try to install it locally on your system), you can install Dist::Zilla, Dist::Zilla::PluginBundle::Author::PERLANCAR, and sometimes one or two other Dist::Zilla plugin and/or Pod::Weaver::Plugin. Any additional steps required beyond that are considered a bug and can be reported to me.

COPYRIGHT AND LICENSE

This software is copyright (c) 2022, 2021, 2018 by perlancar <perlancar@cpan.org>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=WHO-GrowthReference-Table

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.