This package healthsciencecalculator.py is designed to provide tools for calculating and analyzing important health metrics. It aims to support health professionals, researchers, and fitness enthusiasts by offering reliable functions to convert relevant units, compute Total Daily Energy Expenditure (TDEE), Basal Metabolic Rate (BMR), and Body Mass Index (BMI).
The healthsciencecalculator.py package fits well within the broader Python ecosystem, complementing existing data science and health analysis libraries. There are several Python packages with similar functionalities, such as:
This package collects health indices like BMI and health indicators like birth rate
This package maintains personal health records in a text file that can be privately stored in your computer.
The healthsciencecalculator.py package is unique in that it performs health-related calculations with high accuracy and precision, tailored specifically for healthcare professionals and data analysts.
get_tdee
Description: Calculates Total Daily Energy Expenditure (TDEE) based on BMR and activity level.
Inputs: BMR and activity level.
get_bmi
Description: Calculates Body Mass Index (BMI) and provides category classification.
Inputs: Weight and height.
get_bmr
Description: Computes Basal Metabolic Rate (BMR) using the Harris-Benedict equation.
Inputs: Weight, height, age, and sex.
unit_convert
Description: convert between various health-related units such as weight (kg to lbs), temperature (Celsius to Fahrenheit), and length (cm to inches). This function simplifies converting clinical data for international research or patient records.
Inputs: numeric value to be converted, unit of input value, the desired unit
$ pip install healthsciencecalculatorAfter installation, you can start using the various functions provided by the package.
The get_bmi function calculates the Body Mass Index (BMI) and provides detailed classification information, including the BMI category and associated health risk level.
from healthsciencecalculator.healthsciencecalculator import get_bmi
# Example usage
weight = 70.0 # Weight in kilograms
height = 1.75 # Height in meters
# Calculate BMI
bmi_result = get_bmi(weight, height)
# Access BMI details
print(f"BMI: {bmi_result.bmi:.2f}")
print(f"Category: {bmi_result.category}")
print(f"Risk Level: {bmi_result.risk_level}")
The get_tdee function calculates the Total Daily Energy Expenditure (TDEE) based on the Basal Metabolic Rate (BMR) and an individual's activity level.
from healthsciencecalculator.healthsciencecalculator import get_tdee
# Example usage
bmr = 1500.0 # Basal Metabolic Rate in kilocalories
activity_level = 'moderately active' # Choose from: 'sedentary', 'lightly active', 'moderately active', 'very active', 'extra active'
# Calculate TDEE
tdee = get_tdee(bmr, activity_level)
# Display TDEE
print(f"TDEE: {tdee:.2f} kcal/day")
The unit_convert function converts a value from one unit to another. It supports various units for weight, length, temperature, concentration, and volume.
from healthsciencecalculator.healthsciencecalculator import unit_convert
# Example usage
# Convert 1 meter to centimeters
value_in_meters = 1.0
converted_value = unit_convert(value_in_meters, "m", "cm")
print(f"1 meter is {converted_value} centimeters.")
# Convert 70 kilograms to pounds
value_in_kg = 70.0
converted_value = unit_convert(value_in_kg, "kg", "lb")
print(f"70 kilograms is {converted_value:.2f} pounds.")
# Convert 100 degrees Celsius to Fahrenheit
value_in_celsius = 100.0
converted_value = unit_convert(value_in_celsius, "C", "F")
print(f"100 degrees Celsius is {converted_value:.2f} degrees Fahrenheit.")
# Convert 5 liters to milliliters
value_in_liters = 5.0
converted_value = unit_convert(value_in_liters, "L", "mL")
print(f"5 liters is {converted_value:.0f} milliliters.")
The get_bmr function calculates the Basal Metabolic Rate (BMR) using the Harris-Benedict equation. BMR represents the number of calories required for basic life-sustaining functions.
from healthsciencecalculator.healthsciencecalculator import bmr
# Example usage
# Calculate BMR for a male
weight_male = 70.0 # Weight in kilograms
height_male = 175.0 # Height in centimeters
age_male = 25 # Age in years
sex_male = "male"
bmr_value_male = get_bmr(weight_male, height_male, age_male, sex_male)
print(f"BMR for a 25-year-old male (70 kg, 175 cm): {bmr_value_male:.2f} calories/day")
# Calculate BMR for a female
weight_female = 60.0 # Weight in kilograms
height_female = 165.0 # Height in centimeters
age_female = 30 # Age in years
sex_female = "female"
bmr_value_female = get_bmr(weight_female, height_female, age_female, sex_female)
print(f"BMR for a 30-year-old female (60 kg, 165 cm): {bmr_value_female:.2f} calories/day")
Before running the tests, make sure you have the following installed:
Python 3.x – You can check if you have Python installed by running:
python --versionpytest – The test suite uses the pytest testing framework. You can install pytest using pip:
pip install pytest(Optional) pytest-cov – To check test coverage, you can install the pytest-cov plugin:
pip install pytest-covOnce the prerequisites are installed, navigate to the root directory of the project (where pytest is located), and run the following command in your terminal:
pytestThis will automatically discover and run all tests in files starting with test_ and containing functions starting with test_.
To run a specific test file, use:
pytest path/to/test_file.pyTo run a specific test function within a file, use:
pytest path/to/test_file.py::test_function_namepytest will show the test results in your terminal, indicating which tests passed and which failed. If a test fails, pytest will display an error message to help with debugging.
If you have pytest-cov installed, you can check the test coverage with the following command:
pytest --cov=healthsciencecalculatorThis will show you how much of your code is covered by tests and highlight areas that need more coverage.
Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.
healthsciencecalculator was created by Forgive Agbesi, Jiayi Li, Hala Arar, Tengwei Wang. It is licensed under the terms of the MIT license.
The healthsciencecalculator.py package is released under the MIT license to promote widespread adoption and improvement of standardized health metric calculations in the medical and research communities. This choice reflects our commitment to:
- Scientific transparency: By using the MIT license, we ensure that the algorithms and methodologies behind the health metric calculations are openly accessible. This allows researchers to replicate the calculations, fostering trust and credibility in the results.
- Healthcare integration: The open license allows healthcare providers and organizations to adapt the package to their systems, improving patient care and decision-making through easy customization and integration.
- Educational use: The MIT license makes the package freely available for use in educational settings, supporting learning and innovation in healthcare, data science, and research.
- Quality improvement: By allowing unrestricted modification and redistribution, the research community can collectively improve these this tool and features they want to use.
healthsciencecalculator was created with cookiecutter and the py-pkgs-cookiecutter template.
Forgive Agbesi, Hala Arar, Jiayi Li, Tengwei Wang