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")
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.
healthsciencecalculator was created with cookiecutter and the py-pkgs-cookiecutter template.
Forgive Agbesi Hala Arar Jiayi Li Tengwei Wang