FreeTools Labs Glossary
Protein needs
Learn how body weight, activity and goal context contribute to a model-based protein range and reference value.
FreeTools Labs Glossary
Learn how body weight, activity and goal context contribute to a model-based protein range and reference value.
The Protein Calculator derives a daily mathematical range from current body weight, an activity/training category and a goal. It uses neither age, sex, height, target weight nor fat-free mass. Its output is a range of the tool’s model, not an individual dietary or treatment recommendation.
Only body weight in kg, one of five activity categories and one of four goals are entered. Weight must be finite and between 35 and 250 kg; decimal values are accepted. Invalid weight produces no service result. The available activity values are `low`, `general`, `endurance`, `strength` and `intensive`; goals are `maintenance`, `weight-loss`, `muscle-gain` and `deficit-maintenance`.
From those three inputs, the tool shows lower and upper grams per day, the g/kg factor range and an orientation value rounded to 5 g. Age, training duration, energy intake, calorie deficit, conditions, target weight and body-fat or FFM estimates do not enter the calculation.
Activity and goal are application model categories. They do not record a training plan, measured load or personal dietary history.
The service defines the following project ranges: `low` 0.8–1.0 g/kg, `general` 0.9–1.2 g/kg, `endurance` 1.2–1.6 g/kg, `strength` 1.4–1.8 g/kg and `intensive` 1.6–2.0 g/kg.
Daily range
lower grams = round(body weight kg × lower factor); upper grams = round(body weight kg × upper factor)The current project documents no external assignment of these g/kg ranges to DGE, EFSA, ISSN, ACSM, WHO or another reference. They are therefore described as calculator model factors, not universal scientific recommendations.
`maintenance` leaves the base factors unchanged. `weight-loss` adds 0.1 g/kg to both limits. `muscle-gain` sets limits to at least 1.4 and 1.8 g/kg; a higher activity range remains higher. `deficit-maintenance` sets the lower limit to at least 1.6 g/kg and the upper limit to 2.0 g/kg.
Finally, the service clamps each factor to 0.8–2.0 g/kg, rounds it to one decimal and prevents an upper limit below the lower one. For `muscle-gain` with `low`, it also emits `MUSCLE_GAIN_REQUIRES_TRAINING`. That code describes only this tool combination; it does not assess individual training success.
Orientation value
round(((lower grams + upper grams) / 2) / 5) × 5The orientation value is calculated only after the limits have been rounded to whole grams and is always a multiple of 5 g. It does not replace the shown range or set a daily obligation.
For 80 kg, `low` and `maintenance`, the service uses 0.8–1.0 g/kg. It calculates round(80 × 0.8) = 64 g and round(80 × 1.0) = 80 g. Their midpoint is 72 g, which becomes the 5-g orientation value 70 g.
The service result is 64–80 g/day with orientation value 70 g. It illustrates the selected model category; it does not say that 70 g is necessary or optimal for a particular person.
For 80 kg, `strength` and `weight-loss`, the base range 1.4–1.8 gains 0.1 g/kg, becoming 1.5–1.9. The service returns round(80 × 1.5) = 120 g and round(80 × 1.9) = 152 g.
The midpoint of those rounded limits is 136 g; rounded to the nearest 5-g step, the orientation value is 135 g. The full result is thus 120–152 g/day and 135 g orientation. It is a calculation scenario, not a weight-loss plan or individual dietary instruction.
The protein range and food list are separate functions. The local list has 66 product-neutral entries in eight categories: eggs, dairy, meat, fish and seafood, legumes, plant alternatives, nuts and seeds, and grains/other plants. It filters by category, dietary form and name; the filters are `vegan`, `vegetarian`, `omnivore` and `all`.
Each entry stores protein per 100 g or 100 ml, state, typical portion, dietary label and source key. 56 entries use `USDA_FDC_SR`, 10 `ANSES_CIQUAL_2025`; 63 use g and 3 use ml as reference units. Values are local references rounded to one decimal and are not editable. Twenty-two manufacturer-dependent entries are marked variable in the interface.
Protein in a typical portion
protein g = protein per 100 g or ml × portion amount / 100For piece entries, the service uses edible mass stored in the data: one chicken egg is 50 g and one egg white 33 g. For example, 250 g low-fat quark at 12.2 g per 100 g calculates to 30.5 g protein. That is a derivation from the local table, not a statement about total need.
The comparison view divides the orientation value by one food’s protein value and shows the calculated quantity needed. For piece-based foods it also derives a number of pieces from edible mass. It expressly assumes all comparison protein would come from that one food; it is not a consumption recommendation.
In `My selection`, an added food starts with its typical portion. The service limits mathematically rounded portions to 0–20, sums portion results to one decimal and compares them with the orientation value. `near` is within ±5% of the orientation value, but at least ±5 g; below is `below`, above is `above`. It distributes no meals, energy or other nutrients.
The documented USDA and ANSES sources support local food and portion references, not the g/kg need factors. The module README records the food-selection data status as 26 July 2026. Variety, water content, state, preparation and manufacturer can change values; the data model keeps raw, cooked, drained, ready-to-eat, unsweetened, roasted and smoked states distinct.
The calculator assesses no protein quality, amino-acid profile, biological value, DIAAS/PDCAAS, meal distribution or complete diet. It makes no diagnosis and recommends no supplements or protein powders. According to the module, it is not intended for minors; pregnancy or lactation; known kidney, liver or relevant metabolic conditions; special therapeutic nutrition requirements; or professionally supervised elite sport.
A displayed gram range is a model value from selected inputs. It does not replace individual dietary counselling or medical nutrition therapy, and does not determine how much a person should eat.
Project source for 56 local food reference values; not used as a source for the g/kg factors.
Project source for the portion method documented in the README; not used as a source for the g/kg factors.
Project source for 10 local food reference values; not used as a source for the g/kg factors.