healthsciencecalculator.get_tdee
================================

.. py:module:: healthsciencecalculator.get_tdee


Functions
---------

.. autoapisummary::

   healthsciencecalculator.get_tdee.get_tdee


Module Contents
---------------

.. py:function:: get_tdee(bmr: float, activity_level: str) -> float

   Calculate the Total Daily Energy Expenditure (TDEE) based on BMR and activity level.

   :param bmr: The Basal Metabolic Rate (must be positive).
   :type bmr: float
   :param activity_level: The activity level (allowed values: 'sedentary', 'lightly active',
                          'moderately active', 'very active', 'extra active').
   :type activity_level: str

   :returns: The calculated TDEE (kcal/day).
   :rtype: float

   .. rubric:: Example

   >>> get_tdee(bmr = 1500.0, activity_level = 'sedentary')
   1800.0

   :raises ValueError: If bmr <= 0 or activity_level is not recognized.

   .. rubric:: Notes

   Sample multipliers (you may choose different ones if needed):
     - sedentary: 1.2
     - lightly active: 1.375
     - moderately active: 1.55
     - very active: 1.725
     - extra active: 1.9