growthcharts 0.1.0__tar.gz

growthcharts-0.1.0/LICENSE.txt

@@ -0,0 +1,12 @@
+MIT License
+
+Copyright (c) 2026 Dr Dehghani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+[... continues with full MIT license text ...]

growthcharts-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: growthcharts
+Version: 0.1.0
+Summary: Pediatric Growth Chart Analyzer
+Home-page: https://drdehghani.ir/
+Author: Javad Dehghani MD
+Author-email: j.dehghani@gmail.com
+Keywords: growth chart pediatric infant child BMI CDC
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Healthcare Industry
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: pandas
+Requires-Dist: matplotlib
+Requires-Dist: scipy
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+
+**GrowthCharts** is a pediatric growth chart analyzer for infants (0–2 years) and children (2–20 years).  
+It provides Z-score calculation, percentiles, and growth chart visualization based on CDC growth standards.
+
+---
+
+## Installation
+
+Install from PyPI (once uploaded):
+
+```bash
+pip install growthcharts
+Or install locally for development:
+
+pip install -e .
+Requirements:
+
+pandas
+
+matplotlib
+
+scipy
+
+Quickstart
+Infant example (0–24 months)
+from growthcharts import Infant
+
+# Create an Infant object
+baby = Infant(sex='m', age=6, wt=7.5, length=65.0, hc=42.0)
+
+# Plot growth charts
+baby.plot_wtage(title="Weight-for-Age")
+baby.plot_lenageinf(title="Length-for-Age")
+baby.plot_hcageinf(title="Head Circumference-for-Age")
+baby.plot_wtleninf(title="Weight-for-Length")
+
+# Calculate Z-scores and percentiles
+print(baby.analyze_wtageinf())   # Example output: {'Z': -0.23, 'Percentile': 41.0}
+print(baby.analyze_lenageinf())  # Example output: {'Z': 0.12, 'Percentile': 55.0}
+print(baby.analyze_hcageinf())   # Example output: {'Z': 0.30, 'Percentile': 62.0}
+print(baby.analyze_wtleninf())   # Example output: {'Z': -0.15, 'Percentile': 44.0}
+Child example (2–20 years)
+from growthcharts import Child
+
+# Create a Child object
+child = Child(sex='f', age=36, wt=15.5, length=95.0)
+
+# Plot growth charts
+child.plot_wtage(title="Weight-for-Age")
+child.plot_lenage(title="Height-for-Age")
+child.plot_bmiage(title="BMI-for-Age")
+
+# Calculate Z-scores and percentiles
+print(child.analyze_wtage())  # Example output: {'Z': 0.12, 'Percentile': 55.0}
+print(child.analyze_lenage())  # Example output: {'Z': -0.08, 'Percentile': 47.0}
+print(child.analyze_bmiage())  # Example output: {'Z': 0.05, 'Percentile': 52.0}
+Classes
+Patient
+Base class storing sex, age, weight, and length.
+
+Calculates BMI if both weight and length are provided.
+
+Infant(Patient)
+Handles infants 0–24 months:
+
+Plotting methods: plot_wtage, plot_lenageinf, plot_hcageinf, plot_wtleninf
+
+Analysis methods: analyze_wtageinf, analyze_lenageinf, analyze_hcageinf, analyze_wtleninf
+
+Child(Patient)
+Handles children 2–20 years:
+
+Plotting methods: plot_wtage, plot_lenage, plot_bmiage
+
+Analysis methods: analyze_wtage, analyze_lenage, analyze_bmiage
+
+Data
+CSV data files for growth standards are included with the package under the data/ folder.
+
+Infant: wtageinf.csv, lenageinf.csv, hcageinf.csv, wtleninf.csv
+
+Child: wtage.csv, lenage.csv, bmiage.csv
+
+These are loaded automatically by the classes and do not need separate downloading.
+
+## License
+
+This project is licensed under the MIT License. 

growthcharts-0.1.0/README.md

@@ -0,0 +1,88 @@
+
+**GrowthCharts** is a pediatric growth chart analyzer for infants (0–2 years) and children (2–20 years).  
+It provides Z-score calculation, percentiles, and growth chart visualization based on CDC growth standards.
+
+---
+
+## Installation
+
+Install from PyPI (once uploaded):
+
+```bash
+pip install growthcharts
+Or install locally for development:
+
+pip install -e .
+Requirements:
+
+pandas
+
+matplotlib
+
+scipy
+
+Quickstart
+Infant example (0–24 months)
+from growthcharts import Infant
+
+# Create an Infant object
+baby = Infant(sex='m', age=6, wt=7.5, length=65.0, hc=42.0)
+
+# Plot growth charts
+baby.plot_wtage(title="Weight-for-Age")
+baby.plot_lenageinf(title="Length-for-Age")
+baby.plot_hcageinf(title="Head Circumference-for-Age")
+baby.plot_wtleninf(title="Weight-for-Length")
+
+# Calculate Z-scores and percentiles
+print(baby.analyze_wtageinf())   # Example output: {'Z': -0.23, 'Percentile': 41.0}
+print(baby.analyze_lenageinf())  # Example output: {'Z': 0.12, 'Percentile': 55.0}
+print(baby.analyze_hcageinf())   # Example output: {'Z': 0.30, 'Percentile': 62.0}
+print(baby.analyze_wtleninf())   # Example output: {'Z': -0.15, 'Percentile': 44.0}
+Child example (2–20 years)
+from growthcharts import Child
+
+# Create a Child object
+child = Child(sex='f', age=36, wt=15.5, length=95.0)
+
+# Plot growth charts
+child.plot_wtage(title="Weight-for-Age")
+child.plot_lenage(title="Height-for-Age")
+child.plot_bmiage(title="BMI-for-Age")
+
+# Calculate Z-scores and percentiles
+print(child.analyze_wtage())  # Example output: {'Z': 0.12, 'Percentile': 55.0}
+print(child.analyze_lenage())  # Example output: {'Z': -0.08, 'Percentile': 47.0}
+print(child.analyze_bmiage())  # Example output: {'Z': 0.05, 'Percentile': 52.0}
+Classes
+Patient
+Base class storing sex, age, weight, and length.
+
+Calculates BMI if both weight and length are provided.
+
+Infant(Patient)
+Handles infants 0–24 months:
+
+Plotting methods: plot_wtage, plot_lenageinf, plot_hcageinf, plot_wtleninf
+
+Analysis methods: analyze_wtageinf, analyze_lenageinf, analyze_hcageinf, analyze_wtleninf
+
+Child(Patient)
+Handles children 2–20 years:
+
+Plotting methods: plot_wtage, plot_lenage, plot_bmiage
+
+Analysis methods: analyze_wtage, analyze_lenage, analyze_bmiage
+
+Data
+CSV data files for growth standards are included with the package under the data/ folder.
+
+Infant: wtageinf.csv, lenageinf.csv, hcageinf.csv, wtleninf.csv
+
+Child: wtage.csv, lenage.csv, bmiage.csv
+
+These are loaded automatically by the classes and do not need separate downloading.
+
+## License
+
+This project is licensed under the MIT License. 

growthcharts-0.1.0/growthcharts/__init__.py

@@ -0,0 +1,7 @@
+# growthcharts/__init__.py
+
+from .patient import Patient
+from .infant import Infant
+from .child import Child
+
+__all__ = ["Patient", "Infant", "Child"]

growthcharts-0.1.0/growthcharts/child.py

@@ -0,0 +1,269 @@
+import pandas as pd
+import matplotlib.pyplot as plt
+import math
+from scipy.stats import norm
+
+from .patient import Patient
+from pathlib import Path
+
+
+DATA_PATH = Path(__file__).parent / "data"
+
+
+class Child(Patient):
+    """
+    Represents a child patient (2–20 years) and provides growth chart analysis
+    and visualization based on CDC growth standards.
+
+    This class extends the Patient class and adds functionality for:
+    - Weight-for-age
+    - Length-for-age
+    - BMI-for-age
+
+    Supports plotting percentile curves and calculating Z-scores and percentiles
+    using the LMS method.
+    """
+
+    # Child 2 to 20 database
+    df_wtage = pd.read_csv(DATA_PATH /'wtage.csv', dtype={'Sex': str})
+    df_lenage = pd.read_csv(DATA_PATH /'lenage.csv', dtype={'Sex': str})
+    df_bmiage = pd.read_csv(DATA_PATH /'bmiage.csv', dtype={'Sex': str})
+
+    def __init__(self, sex: str, age: int, wt: float = None, length: float = None):
+        """
+        Initialize a Child object.
+
+        At least one anthropometric measurement must be provided.
+
+        Args:
+            sex (str): Child sex.
+            age (int): Age in months.
+            wt (float, optional): Weight in kilograms.
+            length (float, optional): Length/height in centimeters.
+
+        Raises:
+            ValueError: If both wt and length are None.
+        """
+        if wt is None and length is None:
+            raise ValueError("At least wt or length must be provided")
+
+        super().__init__(sex, age, wt, length)
+
+    def plot_wtage(self, title=None):
+        """
+        Plot weight-for-age growth chart with patient's measurement.
+
+        Args:
+            title (str, optional): Plot title.
+        """
+        df = self.df_wtage
+
+        self.sex = str(self.sex).lower()
+        if self.sex in ['m', '1']:
+            self.sex = '1'
+        elif self.sex in ['f', '2']:
+            self.sex = '2'
+        else:
+            raise TypeError('define sex as m or f')
+
+        data = df[df['Sex'] == self.sex]
+
+        plt.figure(figsize=(12, 7))
+        for i, col in enumerate(self.agecolumns[1:]):
+            if i in self.highlight_indices:
+                plt.plot(data['Agemos'], data[col],
+                         color='gray', linewidth=2, label=f'{title} {col}')
+            else:
+                plt.plot(data['Agemos'], data[col],
+                         color='lightgray', linewidth=1)
+
+        if self.wt is not None:
+            plt.scatter(self.age, self.wt, color='red', s=100, zorder=5)
+
+        plt.title(title)
+        plt.xlabel("age(month)")
+        plt.ylabel("Weight(Kg)")
+        plt.grid(True)
+        plt.legend()
+        plt.show()
+
+    def plot_lenage(self, title=None):
+        """
+        Plot length-for-age growth chart with patient's measurement.
+
+        Args:
+            title (str, optional): Plot title.
+        """
+        df = self.df_lenage
+
+        self.sex = str(self.sex).lower()
+        if self.sex in ['m', '1']:
+            self.sex = '1'
+        elif self.sex in ['f', '2']:
+            self.sex = '2'
+        else:
+            raise TypeError('define sex as m or f')
+
+        data = df[df['Sex'] == self.sex]
+
+        plt.figure(figsize=(14, 10))
+        for i, col in enumerate(self.agecolumns[1:]):
+            if i in self.highlight_indices:
+                plt.plot(data['Agemos'], data[col],
+                         color='gray', linewidth=2, label=f'{title} {col}')
+            else:
+                plt.plot(data['Agemos'], data[col],
+                         color='lightgray', linewidth=1)
+
+        if self.length is not None:
+            plt.scatter(self.age, self.length, color='red', s=100, zorder=5)
+
+        plt.title(title)
+        plt.xlabel("age(month)")
+        plt.ylabel("Length(cm)")
+        plt.grid(True)
+        plt.legend()
+        plt.show()
+
+    def plot_bmiage(self, title=None):
+        """
+        Plot BMI-for-age growth chart with patient's measurement.
+
+        Args:
+            title (str, optional): Plot title.
+        """
+        df = self.df_bmiage
+
+        self.sex = str(self.sex).lower()
+        if self.sex in ['m', '1']:
+            self.sex = '1'
+        elif self.sex in ['f', '2']:
+            self.sex = '2'
+        else:
+            raise TypeError('define sex as m or f')
+
+        data = df[df['Sex'] == self.sex]
+
+        plt.figure(figsize=(12, 7))
+        for i, col in enumerate(self.agecolumns[1:]):
+            if i in self.highlight_indices:
+                plt.plot(data['Agemos'], data[col],
+                         color='gray', linewidth=2, label=f'{title} {col}')
+            else:
+                plt.plot(data['Agemos'], data[col],
+                         color='lightgray', linewidth=1)
+
+        if self.wt is not None and self.length is not None and self.length > 0:
+            plt.scatter(self.age, self.bmi, color='red', s=100, zorder=5)
+
+        plt.title(title)
+        plt.xlabel("age(month)")
+        plt.ylabel("BMI")
+        plt.grid(True)
+        plt.legend()
+        plt.show()
+
+    def analyze_wtage(self):
+        """
+        Analyze weight-for-age using LMS method.
+
+        Returns:
+            dict: Z-score and percentile.
+        """
+        df = self.df_wtage
+        self.sex = str(self.sex).lower()
+        if self.sex in ['m', '1']:
+            self.sex = '1'
+        elif self.sex in ['f', '2']:
+            self.sex = '2'
+        else:
+            raise TypeError('define sex as m or f')
+
+        df2 = df[df['Sex'] == self.sex]
+        row = df2.iloc[(df2['Agemos'] - self.age).abs().argsort()[:1]]
+
+        L = float(row['L'].values[0])
+        M = float(row['M'].values[0])
+        S = float(row['S'].values[0])
+
+        if L != 0:
+            z = ((self.wt / M) ** L - 1) / (L * S)
+        else:
+            z = math.log(self.wt / M) / S
+
+        percentile = norm.cdf(z) * 100
+
+        return {
+            "Z": round(z, 2),
+            "Percentile": round(percentile, 2)
+        }
+
+    def analyze_lenage(self):
+        """
+        Analyze length-for-age using LMS method.
+
+        Returns:
+            dict: Z-score and percentile.
+        """
+        df = self.df_lenage
+        self.sex = str(self.sex).lower()
+        if self.sex in ['m', '1']:
+            self.sex = '1'
+        elif self.sex in ['f', '2']:
+            self.sex = '2'
+        else:
+            raise TypeError('define sex as m or f')
+
+        df2 = df[df['Sex'] == self.sex]
+        row = df2.iloc[(df2['Agemos'] - self.age).abs().argsort()[:1]]
+
+        L = float(row['L'].values[0])
+        M = float(row['M'].values[0])
+        S = float(row['S'].values[0])
+
+        if L != 0:
+            z = ((self.length / M) ** L - 1) / (L * S)
+        else:
+            z = math.log(self.length / M) / S
+
+        percentile = norm.cdf(z) * 100
+
+        return {
+            "Z": round(z, 2),
+            "Percentile": round(percentile, 2)
+        }
+
+    def analyze_bmiage(self):
+        """
+        Analyze BMI-for-age using LMS method.
+
+        Returns:
+            dict: Z-score and percentile.
+        """
+        df = self.df_bmiage
+        self.sex = str(self.sex).lower()
+        if self.sex in ['m', '1']:
+            self.sex = '1'
+        elif self.sex in ['f', '2']:
+            self.sex = '2'
+        else:
+            raise TypeError('define sex as m or f')
+
+        df2 = df[df['Sex'] == self.sex]
+        row = df2.iloc[(df2['Agemos'] - self.age).abs().argsort()[:1]]
+
+        L = float(row['L'].values[0])
+        M = float(row['M'].values[0])
+        S = float(row['S'].values[0])
+
+        if L != 0:
+            z = ((self.bmi / M) ** L - 1) / (L * S)
+        else:
+            z = math.log(self.bmi / M) / S
+
+        percentile = norm.cdf(z) * 100
+
+        return {
+            "Z": round(z, 2),
+            "Percentile": round(percentile, 2)
+        }