omni_soil_lime_requirement_cce
Calculates agricultural limestone tons per acre and total field lime required to raise acidic soil pH from buffer pH and lime CCE, helping correct soil acidity and improve nutrient uptake.
Instructions
Agricultural Soil Lime Requirement & CCE Neutralization Calculator. Calculate tons of agricultural limestone needed per acre to raise acid soil pH based on Sikora / Woodruff buffer pH and Calcium Carbonate Equivalent (CCE). Discipline: AGRICULTURE. Governing mathematical model / formula: Pure Lime Needed (tons/ac) = Buffer pH Deficit × Soil Factor | Adjusted Lime = Pure Lime / (CCE% / 100).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of recommended_lime_tons_acre (Recommended Ag Lime Rate), total_lime_for_field (Field Total Lime Delivery (80 Acres)), soil_acidity_category (Acidity Severity Tier), fertilizer_efficiency_boost (Nutrient Efficiency Recovered) using current_water_ph (Soil Water pH (Current Acid Test)), buffer_ph_value (Buffer pH (Sikora or SMP Buffer)), target_soil_ph (Target Desired Soil pH), limestone_cce_pct (Lime Quality (CCE %) in %). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Agricultural Soil Lime Requirement & CCE Neutralization Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "soil-lime-requirement-cce"
category (string): "agriculture"
name (string): "Agricultural Soil Lime Requirement & CCE Neutralization Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.recommended_lime_tons_acre (Recommended Ag Lime Rate): Formatted display string (e.g. '2.35 Tons / Acre')
metrics.total_lime_for_field (Field Total Lime Delivery (80 Acres)): Formatted display string (e.g. '188.0 Tons Bulk')
metrics.soil_acidity_category (Acidity Severity Tier): Formatted display string (e.g. 'Moderately Acidic (Yield Limiting)')
metrics.fertilizer_efficiency_boost (Nutrient Efficiency Recovered): Formatted display string (e.g. '+29% N-P-K Fertilizer Uptake')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_soil_lime_requirement_cce"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target_soil_ph | No | Target Desired Soil pH. Target pH: Corn/Soy 6.5, Alfalfa 6.8. Default: 6.5. Min: 6. Max: 7. | |
| buffer_ph_value | No | Buffer pH (Sikora or SMP Buffer). Measures soil reserve exchangeable acidity (buffering capacity). Default: 6.2. Min: 5.2. Max: 7. | |
| current_water_ph | No | Soil Water pH (Current Acid Test). Current soil test pH (ideal for corn/soy is 6.5 - 6.8). Default: 5.4. Min: 4. Max: 7.5. | |
| limestone_cce_pct | No | Lime Quality (CCE %) (%). Calcium Carbonate Equivalent (standard ag lime = 80-90%, pell-lime = 95%). Default: 85. Min: 60. Max: 110. |