Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/erik1066/anthstat-statistics

AnthStat computes z-scores for children and adolescents using the WHO 2006 Child Growth Standards, the WHO 2007 Growth Reference, and the CDC 2000 Growth Charts. A z-score-to-percentile converter is also provided.
https://github.com/erik1066/anthstat-statistics

anthropometry csharp dotnet dotnetcore nutrition statistics

Last synced: 25 days ago
JSON representation

AnthStat computes z-scores for children and adolescents using the WHO 2006 Child Growth Standards, the WHO 2007 Growth Reference, and the CDC 2000 Growth Charts. A z-score-to-percentile converter is also provided.

Awesome Lists containing this project

README 

        
# Anthropometry Statistics Library for .NET



[![NuGet version (AnthStat.Statistics)](https://img.shields.io/nuget/v/AnthStat.Statistics.svg?style=flat-square)](https://www.nuget.org/packages/AnthStat.Statistics/)



AnthStat computes z-scores for children and adolescents using the WHO 2006 Child Growth Standards, the WHO 2007 Growth Reference, and the CDC 2000 Growth Charts. Z-scores can be used to determine if a child is growing appropriately and to predict their expected adult height and weight. 



Z-scores for the following indicators can be computed using the WHO 2006 Growth Standard:



* Length/height-for-age

* Weight-for-age

* Weight-for-length/height

* Body mass index-for-age

* Head circumference-for-age

* Arm circumference-for-age

* Subscapular skinfold-for-age

* Triceps skinfold-for-age



Z-scores for the following indicators can be computed using the WHO 2007 Growth Reference:



* Body mass index-for-age (61 to 228 months)

* Height-for-age (61 to 228 months)

* Weight-for-age (61 to 120 months)



Z-scores for the following indicators can be computed using the CDC 2000 Growth Charts:



* Body mass index-for-age

* Length/Height-for-age

* Weight-for-age

* Weight-for-length/height

* Head circumference-for-age



For more information and further documentation:



* WHO 2006 Growth Standards: http://www.who.int/childgrowth/en/

* WHO 2007 Growth Reference: http://www.who.int/growthref/en/

* CDC 2000 Growth Charts: https://www.cdc.gov/growthcharts/index.htm



# Usage



Be sure to first read and agree to the [license](LICENSE) and then include the latest [NuGet Package](https://www.nuget.org/packages/AnthStat.Statistics/).



To compute a z-score and percentile for a 64 month-old male who has a body mass index (BMI) of 17 using the WHO 2007 Growth Reference:



``` cs

var who2007 = new AnthStat.Statistics.WHO2007();



double ageMonths = 64; 

double bmi = 17;

double z = 0.0;



if (who2007.TryCalculateZScore(indicator: Indicator.BodyMassIndexForAge, measurement: bmi, age: ageMonths, sex: Sex.Male, z: ref z))

{

    double p = StatisticsHelper.CalculatePercentile(z);



    z = Math.Round(z, 2);

    p = Math.Round(p, 2);



    Console.WriteLine($"{ageMonths} month old male, BMI = {bmi}, z-score = {z}, percentile = {p}");

}

```



The value of ```z``` (the z-score) is 1.22 which equates to a percentile of 88.90. Note that ```z``` is passed by reference.



To use the WHO 2006 Growth Standards to compute a z-score for a 32 day-old female with a BMI of 16:



``` cs

var who2006 = new AnthStat.Statistics.WHO2006();



double ageDays = 32; 

double bmi = 16;

double z = 0.0;



if (who2006.TryCalculateZScore(indicator: Indicator.BodyMassIndexForAge, measurement1: bmi, measurement2: ageDays, sex: Sex.Female, z: ref z))

{

    double p = StatisticsHelper.CalculatePercentile(z);

}

```



To use the CDC 2000 Growth Charts to compute a z-score for a 24-month old female with a BMI of 15.25:



``` cs

double ageMonths = 24; 

double z = 0.0;

double bmi = 15.25;



if (cdc2000.TryCalculateZScore(indicator: Indicator.BodyMassIndexForAge, measurement1: bmi, measurement2: ageMonths, sex: Sex.Female, z: ref z))

{

    double p = StatisticsHelper.CalculatePercentile(z);

}

```



Some inputs are undefined per the WHO and CDC specifications. For example, the WHO 2007 Growth Reference defines ages between 61 and 228 months for the BMI-for-Age indicator. Ages outside this range have no lookup values and z-scores for them cannot be calculated. The ```TryCalculateZScore``` method protects callers against such out-of-range inputs: The caller checks that the return value is ```true```, and if so, uses the z-score from the ```z``` parameter (```z``` is passed by reference). A ```false``` return value means the values were out-of-range or that some other exception was encountered.



However, clients can also check if a measurement is valid without calculating a z-score:



``` cs

var cdc2000 = new AnthStat.Statistics.CDC2000();

bool isValid = cdc2000.IsValidMeasurement(Indicator.LengthForAge, ageMonths);

```



# Versioning



AnthStat.Statistics follows [semantic versioning](http://semver.org/) guidelines. The major points to remember about semantic versioning are:



> Given a version number MAJOR.MINOR.PATCH, increment the:

> 

> MAJOR version when you make incompatible API changes,

> MINOR version when you add functionality in a backwards-compatible manner, and

> PATCH version when you make backwards-compatible bug fixes.



This implies version 3.x of the AnthStat.Statistics API is not backwards-compatible with version 2.x or 1.x, and likewise, that 2.x is not backwards compatible with 1.x.



# Important Notes



## Unit of measure for age and interpolation



The lookup values for the WHO 2006 Growth Standards are indexed by age in days. Therefore, all age-based input to the ```TryComputeZScore``` method in the WHO2006 class must supply the age in days. Supplying a non-integer day value (such a 4.5) will cause the value to be rounded to the nearest whole number to avoid interpolation. The only two indicators for the WHO 2006 Growth Standards that can accept decimal values are weight-for-length and weight-for-height. If a decimal value is supplied that is not found in the lookup table for these two indicators, then interpolation of the nearest L, M, and S values will occur.



The WHO 2007 and CDC 2000 data sets are indexed by age in months. Age-based inputs to their ```TryComputeZScore``` methods may supply either a whole-numbered month or a decimal month. Providing age in anything other than months will either generate the wrong output or return a ```false```. If a decimal month value is supplied and the decimal value is not found in the lookup table for that indicator, then interpolation of the nearest L, M, and S values will occur.



## Z-score recomputation



When using the WHO 2006 Growth Standards and the WHO 2007 Growth Reference, z-scores that are above 3 or below -3 will be recomputed per WHO guidelines \[1\] \[2\] \[3\]. This recomputation does not occur when generating z-scores using the CDC 2000 Growth Charts.



## Discrepancies versus WHO Anthro



There will be discrepancies when comparing z-scores computed using AnthStat.Statistics and those computed using the "WHO Anthro" software package (http://www.who.int/childgrowth/software/en/) under certain conditions. This occurs because WHO Anthro adds 0.7cm to a child's length when the child is < 24 months old and measured standing up, and subtracts 0.7cm from the child's height when they are >= 24 months old and measured lying down \[4\]. These adjustments are made internally by the WHO Anthro software and are not shown to the user, though they are documented in the WHO Anthro user manual. This adjusted height or length is used to compute all other length/height-based indicators, which include BMI-for-age, Weight-for-Age, Weight-for-Length, Weight-for-Height, and Height-for-Age.



AnthStat.Statistics does __not__ change the measurement inputs it is provided. It assumes that the caller has made a decision about whether and how to adjust the inputs before supplying them.



## Discrepancies versus Epi Info 7



CDC's Epi Info 7.2.1 for Windows Desktop software suite (see https://www.cdc.gov/epiinfo) uses a month-based set of L, M, and S data points for implementing the WHO 2006 Growth Standards. AnthStat.Statistics uses a day-based set of L, M, and S data points for implementing the WHO 2006 Growth Standards. AnthStat.Statistics is therefore more precise - it needs no interpolation when presented with specific age measurements that do not fall on whole-numbered month values.



# Quality Assurance



There are over 200 unit tests that check the software's computed z-scores against a set of hand-computed (using a calculator tool) z-scores for the same set of input measurements. The hand-computed z-scores relied on the WHO or CDC growth data files to obtain their L, M, and S values. The hand-computing process used L, M, and S values from the CDC and WHO websites, not from the software's source code; this was done in case the transformation from text files to C# was done incorrectly. Both interpolated and non-interpolated z-scores are checked under various conditions. Every indicator for each of the three growth data sets (WHO 2006, WHO 2007, and CDC 2000) are checked extensively. 



The WHO Anthro software was used as a second source of truth when deriving the expected z-score outputs for most of the WHO 2006 Growth Standards.



Performance testing shows that AnthStat.Statistics computes 1,000,000 z-scores from the CDC 2000 Growth Charts in about 470 milliseconds (interpolated) or 200 milliseconds (non-interpolated) on a modern desktop CPU using a single thread and the .NET Core runtime. Using .NET's Task Parallel Library and a ```Parallel.ForEach```, a quad-core desktop processor with hyperthreading sees a 4x performance boost when calculating z-scores for the same set of 1,000,000 records. An example of how to use a ```Parallel.ForEach``` loop to process z-scores can be found in the samples folder.



# References



\[1\] http://www.who.int/childgrowth/standards/Chap_7.pdf



\[2\] http://www.who.int/childgrowth/standards/second_set/tr2chap_7.pdf



\[3\] http://www.who.int/growthref/computation.pdf



\[4\] http://www.who.int/childgrowth/software/anthro_pc_manual_v322.pdf (pages 8-9)