This calculator function helps you calculate the nutrients in your food. Just enter the food items and get the nutrient information.

Calculate food nutrients

Purpose

The purpose of this function is to calculate and return the nutrient information of various foods based on user input.

Use Cases

• Users can input the names of different foods to retrieve their nutrient information.
• Users can specify if they want information for branded foods only.
• Users can set a minimum percentage match for the food names.

How to Use

1. Enter the names of the foods you want to calculate the nutrients for.
2. Optionally, specify if you only want information for branded foods.
3. Set a minimum percentage match for the food names.
4. Click on the 'Calculate' button to retrieve the nutrient information.

Input Values

1. Search Foods: Names of the foods you want to calculate the nutrients for.
2. Description: Enter the names of the foods separated by commas.
3. Branded: Select if you only want information for branded foods.
4. Description: Check the box if you want to include only branded foods.
5. Percent Match: Set a minimum percentage match for the food names.
6. Description: Enter a percentage value to filter the food names.

Output Values

1. Nutrient Data: Nutrient information of the selected foods.
2. Description: The function will return a table containing nutrient information such as calories, protein, fat, etc.

Any other Instruction

• Make sure to enter the correct names of the foods for accurate results.
• Adjust the percentage match to refine the search results.

Calculation Steps

1. Retrieve the Food Data Collection IDs (fdcIDs) based on the input food names.
2. If fdcIDs are found, retrieve the nutrient information using the fdcIDs.
3. Return the nutrient information in a table format.

Technical Parameters

• search_foods, separator, branded, percent_match

Return Values

• nutrient_df

Example Expressions

You can use the following expressions to directly evaluate in a non-interactive manner using eval():

1. Calculate nutrients for apples and oranges:

food('apple, orange')

1. Calculate nutrients for branded foods with a minimum 70% match:

food('apple, orange', branded=True, percent_match=70)

Click on Help icon to open the help page on a separate window.