Easy Ingredients Modulation

Plan & Token Requirements

Feature available in the following LogMeal Plans:

Accessible by the following User Types:

What It Does

Easy Modulation lets users tune a meal’s salt, sugar and oil with one action. Choose high, medium, low or none, and the platform modifies the recipe (e.g., adds/removes reference ingredients like salt/sugar/oil or scales them) and recomputes nutrients automatically. This is ideal to reflect real‑world preparation without editing every ingredient by hand in a fine-grained manner.

✕

✕

When to Use It / Outcomes

• You want a fast adjustment to match how a dish was actually prepared (more/less salt, sugar or oil).
• You’re building confirmation UIs where users fine‑tune the recognized dish without deep editing.
• Professionals need a consistent way to normalize intakes across populations.
• Output: JSON of the updated dish/ingredients and recomputed nutrition for the intake.

Feature-Specific Details

• Levels: high | medium | low | none for salt, sugar, oil.
• Reference ingredients: adjustments are applied using your account’s reference ingredients (e.g., table salt, white sugar, olive oil).
• Scaling rules: added/removed grams are balanced so the dish weight remains consistent.
• Personalization: for each newly submitted intake, the reference ingredients and reference levels will be used by default.
• Localization: labels for levels and reference ingredients can be localized via the standard language parameter.
• Compatibility: works with image‑based intakes, manual intakes, favorites, custom recipes and any other intakes inserted to into the user profile.

Related Endpoints

Use these endpoints to apply Easy Modulation or fetch required catalogs:

• GET /dataset/referenceIngredients → ⚫ 🔴 🔵 Retrieve reference ingredients used for modulation (salt/sugar/oil).
• POST /profile/modifyUserProfileInfo → 🔴 Allows users to customize their preferred reference ingredients levels (e.g. oil: low) and default ingredient for each reference type (e.g. reference oil: olive oil).

Typical Workflow

1. Retrieve reference ingredients:
   Use GET /dataset/referenceIngredients to get the default list of reference items used for Easy Modulation (e.g., salt, sugar, oil). These define the baseline for adjustments.

2. Set default preferences (optional):
   Allow the user to define preferred defaults for reference ingredients and their modulation levels (e.g., default oil = olive oil, default level = medium) using POST /profile/modifyUserProfileInfo.
   These preferences will automatically apply to new intakes.

3. Create or identify the intake:
   When a user logs or recognizes a dish (via image or manual input), obtain the corresponding intake using POST /intake/manualInput/{userId}.
   The dish is initialized with the user’s default modulation settings.

4. Adjust salt, sugar, and oil levels:
   Let the user select desired levels (high, medium, low, none) for each component. Apply these using POST /nutrition/confirm/quantity, which will update the ingredient levels and recompute the nutritional data accordingly.