NUTRICALC N P K

NutriCalc Documentation

Complete guide to hydroponic nutrient formulation, mixing, and dosing

⚡

Quickstart

Get up and running in 5 minutes. Learn the basics of formula building and mixing.

📖

User Guide

Comprehensive manual covering all features, workflows, and advanced techniques.

📚

Reference

API documentation, presets, conversion tables, and nutrient data.

🔧

Troubleshooting

FAQs, common issues, error messages, and solutions.

🧠 Core Concepts

Understand the science and theory before diving into the application.

What is Electrical Conductivity (EC)?

EC measures the total dissolved nutrients (salts) in your solution. It's measured in millisiemens per centimeter (mS/cm).

Rule of thumb: Start low, increase gradually. It's easier to add than remove nutrients.

The NPK Macro-Triad

N-P-K are the three primary macronutrients your plants need most:

N-P-K ratios shift based on crop and growth stage. Vegetative stages want high N; flowering wants low N, high P-K.

Why A/B Split Solutions?

One core chemistry principle: calcium and sulfate cannot coexist in high concentrations without precipitating.

Chemistry: Ca²⁺ + SO₄²⁻ → CaSO₄↓ (insoluble, forms crystals)

To avoid this:

They're mixed separately in water, then combined only at final dilution (1:100 ratio).

Macronutrients vs. Micronutrients

Macronutrients (needed in large quantities):

Micronutrients (needed in tiny quantities):

pH and Nutrient Availability

Plant roots absorb nutrients best at specific pH ranges. Most hydroponic crops prefer pH 5.5–6.5:

Best practice: Measure pH; adjust with phosphoric acid (lower) or potassium hydroxide (raise).

Stock Concentration Ratios

NutriCalc assumes a 100× concentrate — meaning you mix concentrated solutions, then dilute 1:100 for the final reservoir:

Why concentrates?

You can adjust strength:

Compatibility & Precipitation Risks

NutriCalc warns about five major compatibility issues:

Risk Cause Solution
Ca²⁺ + SO₄²⁻ precipitation CaSO₄ crystals form Use A/B split (automatic)
Ca²⁺ + PO₄³⁻ precipitation Ca₃(PO₄)₂ crystals Reduce Ca or P slightly
Iron solubility loss Fe oxidizes at high pH Lower pH to 5.5; use chelated Fe
NH₄⁺ toxicity High ammonium > 10% of N Use nitrate-based nitrogen sources
Boric acid solubility Boric acid precipitates > 4.7 g/L Limit boron to 2.0 ppm or less

The NutriCalc Solver (How It Works)

Behind the scenes, NutriCalc uses Singular Value Decomposition (SVD) — a mathematical technique that:

  1. Takes your target nutrient levels (ppm)
  2. Looks at available chemicals in your library
  3. Solves a system of equations to find the exact quantities of each chemical
  4. Reports element deviations so you know accuracy

Why SVD? Because there's usually no exact solution — chemicals have multiple nutrients. SVD finds the best approximation.

Cost Optimization

NutriCalc tracks chemical costs to help you find the cheapest formulation that still meets your targets.

⚡ Quickstart Guide

Get your first formula mixed in 5 minutes.

Step 1: Set Your Target

Open the Formula Builder page and set your EC (Electrical Conductivity) target.

💡 Tip: Start with EC 1.8 mS/cm for leafy greens, EC 2.0 for tomatoes.

Step 2: Choose a Preset

Select a crop-specific formula from the Quick Presets:

Step 3: Fine-Tune Sliders

Adjust the nutrient sliders to customize the formula for your specific crop and growth stage:

ℹ️ Info: Adjust in small increments (±5-10%) to avoid major imbalances.

Step 4: Solve & Review

Click Solve to generate the formula. Review the results:

Step 5: Mix Your Batch

Go to the Production page to:

  1. View the Bill of Materials with chemical quantities
  2. Follow the Mixing Guide step-by-step
  3. Complete the Verification Checklist before using
⚠️ Important: Always follow the A/B split — mix Part A (Calcium) and Part B (Sulfate/Phosphate) separately to prevent precipitation.

Next Steps

📖 User Guide

Complete reference for NutriCalc features and workflows.

Overview

NutriCalc is a hydroponic nutrient calculator designed to help growers formulate precise, balanced solutions for any crop and growth stage. The tool combines:

Formula Builder

EC Target

Electrical Conductivity (EC) measures the total dissolved nutrients in your solution:

Nutrient Sliders

Adjust each element in ppm (parts per million):

Micronutrients

Boron, Iron, Manganese, Zinc, Copper, Molybdenum, Nickel. Start with standard levels and adjust only if symptoms appear.

Nutrient Profile

Radar Chart

Compares your formula to the target. All points should align with the outer circle.

Element Deviation

Shows percentage deviation from target:

Nutrient Ratio Analysis

Compares your formula to scientific reference frames (Bugbee, Hoagland). Slight deviations are OK for crop-specific optimization.

A/B Stock Split

Why split? Calcium (Ca²⁺) + Sulfate (SO₄²⁻) form insoluble calcium sulfate (CaSO₄) when mixed together. By keeping them in separate containers:

Mix Part A first in water, then Part B. Never pre-mix dry Part A + Part B together.

Production Workflow

Bill of Materials

Shows exact quantities of each chemical needed. Assumes a 100× concentrate (diluted 1:100 in final reservoir):

Mixing Guide

Step-by-step instructions:

  1. Prepare: Clean containers, measure water temperature, gather chemicals
  2. Part A (Calcium): Dissolve in water first, stir until fully dissolved
  3. Part B (Sulfate/Phosphate): Dissolve in separate water, stir until fully dissolved
  4. Store: Label containers, keep in cool dark place
  5. Dilute: Add both parts to final reservoir at 1:100 ratio
⚠️ Critical: Never mix Part A and Part B dry chemicals together. Precipitation will ruin your solution.

Verification Checklist

Before using your solution, complete these tests:

  1. pH Test: Use calibrated pH meter; target is crop-specific (usually 5.5–6.5)
  2. EC Test: Confirm EC matches your target (±0.2 mS/cm tolerance)
  3. Appearance: No cloudiness, precipitate, or discoloration
  4. Smell: No unusual odor indicating decomposition
  5. Temperature: Room temperature (18–25°C); cold solutions reduce absorption

Chemical Alerts

NutriCalc checks for these compatibility issues:

Cost Tracking

NutriCalc estimates production cost per batch based on chemical prices. Prices come from:

Use cost comparison to find the cheapest blend without sacrificing quality.

Dosing & MQTT

For automated greenhouse control, configure MQTT (Message Queuing Telemetry Transport):

  1. Set broker address and port (usually localhost:1883 for local server)
  2. Map each compound to a physical pump number
  3. Click "Publish" to send dosing instructions to all pumps
ℹ️ Advanced: Requires MQTT-compatible pump controllers (e.g., ESP32 with PubSubClient).

📚 Reference

Technical data, presets, and lookup tables.

Preset Formulas

Scientific formulas based on published research (Bugbee, Hoagland, Steiner).

Lettuce — Seedling (EC 1.2)

N: 100 ppm | P: 30 | K: 120 | Ca: 60 | Mg: 45 | S: 30

Lettuce — Grow (EC 1.6)

N: 140 ppm | P: 35 | K: 160 | Ca: 80 | Mg: 50 | S: 35

Tomato — Vegetative (EC 1.8)

N: 160 ppm | P: 35 | K: 180 | Ca: 90 | Mg: 55 | S: 40

Tomato — Bloom/Fruit (EC 2.0)

N: 120 ppm | P: 45 | K: 220 | Ca: 100 | Mg: 60 | S: 45

EC Ranges by Crop

Crop Stage EC (mS/cm)
Lettuce, Spinach All 1.2–1.8
Tomato Vegetative 1.8–2.2
Tomato Bloom/Fruit 2.0–2.4
Cucumber All 1.8–2.2
Herbs All 1.0–1.6
Strawberry Bloom/Fruit 2.2–2.8

Micronutrient Standard Levels (ppm)

Nutrient Standard Range
Boron (B) 0.5 ppm 0.3–1.0
Iron (Fe) 2.0 ppm 1.0–5.0
Manganese (Mn) 0.5 ppm 0.3–1.0
Zinc (Zn) 0.05 ppm 0.02–0.1
Copper (Cu) 0.02 ppm 0.01–0.05
Molybdenum (Mo) 0.05 ppm 0.01–0.1
Nickel (Ni) 0.1 ppm 0.05–0.5

Common Chemical Sources

Nutrient Chemical Notes
Nitrogen Calcium Nitrate (CaNO₃) or KNO₃ Main N source; provides Ca or K simultaneously
Phosphorus Monopotassium Phosphate (MKP) Most common; soluble, stable
Potassium Potassium Sulfate (K₂SO₄) or KNO₃ K₂SO₄ is in Part B; KNO₃ in Part A
Calcium Calcium Nitrate (CaNO₃) Goes in Part A only (separate from sulfate)
Magnesium Magnesium Sulfate (MgSO₄) or Mg Nitrate MgSO₄ (Epsom salt) is cheap; goes in Part B
Micronutrients Multi-micronutrient mix or individual salts Use chelated forms (DTPA, EDTA) for stability

pH Target by Crop

Unit Conversion Table

From To Multiply By
grams ounces 0.03527
liters gallons (US) 0.2642
kg lbs 2.205

🔧 Troubleshooting

Common problems and solutions.

Formula Issues

❌ "Solver failed" or "No solution found"

Problem: NutriCalc cannot formulate your target with the selected chemicals.

Solutions:

❌ Element deviation is red (>±20%)

Problem: One or more elements miss the target significantly.

Solutions:

❌ "Chemical incompatibility warning"

Problem: Precipitation risk detected.

Solutions:

Mixing Issues

❌ Solution is cloudy (white/gray)

Problem: Precipitation has occurred.

Cause: Usually calcium sulfate (CaSO₄) — indicates A/B parts were mixed together before dilution.

Solution:

❌ EC is too high or too low

Problem: Measured EC doesn't match target.

Causes & solutions:

❌ pH is way off (too acidic or alkaline)

Problem: pH doesn't match target after mixing.

Solutions:

App Issues

❌ Formulas not saving

Problem: Click "Save" but formula doesn't appear in Saved Formulas.

Solutions:

❌ MQTT publish fails

Problem: "No ACK received" or publish times out.

Solutions:

❌ Prices not updating

Problem: Chemical prices are stuck or showing "—".

Solutions:

Crop-Specific Issues

Yellowing leaves (nitrogen deficiency)

Solution: Increase nitrogen slightly, re-solve, and remix.

Purple/dark leaves (phosphorus deficiency)

Solution: Increase phosphorus, re-solve, and remix.

Weak stems (potassium deficiency)

Solution: Increase potassium, re-solve, and remix.

Interveinal chlorosis (magnesium deficiency)

Solution: Increase magnesium, re-solve, and remix.

Still Stuck?

If you can't find a solution: