Skip to content

bioepic-data/ecosim-agent / .agents/skills/ecosim-soil-mgmt

ecosim-soil-mgmt

Verified

Prepare, validate, inspect, and edit EcoSIM soil management inputs using soil_mgmt_in NetCDF, editable Excel workbooks, and optional JSON files. Use when checking fertilizer, tillage, or irrigation management data; converting soil-mngt NetCDF to Excel for editing; converting edited Excel back to JSON or NetCDF; decoding fertf/tillf/irrigf selector variables; or validating EcoSIM ReadManagementMod.F90 soil-management inputs.

EcoSIM Soil Management

Overview

Use this skill to build, inspect, validate, or edit EcoSIM soil_mgmt_in files. Soil management files use yearly selectors (fertf, tillf, irrigf) that point to event-table variables inside the same NetCDF file. Existing NetCDF files can be exported to Excel for editing, then converted back to JSON or NetCDF.

Read references/soil_mgmt_contract.md when you need exact NetCDF dimensions, Excel sheet columns, field order, units, or Fortran reader behavior.

Workflow

  1. Identify the EcoSIM branch/reader when possible. The canonical reader contract for this skill is f90src/IOutils/ReadManagementMod.F90.
  2. For an existing .nc, inspect it first:
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py inspect soil-mngt.nc
  1. Choose the editing path:
    • Existing NetCDF: export to Excel, edit the workbook, then convert the edited workbook back to JSON or NetCDF.
    • New file: create JSON directly or an Excel workbook matching the contract schema.
  2. In Excel, keep event-table names in the event_files sheet so empty but intentional variables are preserved during round trips.
  3. Keep selector strings short: fertf, tillf, and irrigf entries are fixed 10-character names. Use NO for inactive management.
  4. Fertilizer quantities are read as g m-2. Convert annual or field-rate values before writing: 1 g m-2 = 10 kg ha-1.
  5. Use actual calendar years in DDMMYYYY for year-specific schedules. The Fortran reader uses the year embedded in the event string for leap-year day-of-year conversion.
  6. After conversion, inspect the new file and check date-year mismatches, missing selector targets, nonzero nutrient totals, and whether expected tillage/irrigation events are present.
  7. Before accepting generated files or Excel roundtrips, perform the raw-byte selector check in references/soil_mgmt_contract.md under "Fixed-width string compatibility". Test every year/topographic unit, including default NO and short active names. Decoded string equality alone is insufficient.
  8. Evaluate against the consuming branch's ReadManagementMod.F90, FertilizerMod.F90, and DayMod.F90. Check irrigation-borne nutrients, same-day properties, daily-slot overwrites, and tillage mixing using the contract below. The bridge's inspect command currently summarizes fertilizer tables; it is not a complete irrigation or process-semantics validator.

Conversion Commands

Use the bundled bridge for NetCDF, Excel, and JSON conversions:

.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py nc-to-xlsx soil-mngt.nc soil-mngt.xlsx
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py xlsx-to-json soil-mngt.xlsx soil-mngt.json
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py xlsx-to-nc soil-mngt.xlsx soil-mngt-edited.nc --json-output soil-mngt-edited.json

JSON remains supported:

.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py nc-to-json soil-mngt.nc soil-mngt.json
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py json-to-nc soil-mngt.json soil-mngt.nc

Validation

For fertilizer-only files, verify that:

  • fertf selectors point to existing fertilizer variables for every active year.
  • tillf and irrigf are NO if there are no tillage or irrigation events.
  • Each fertilizer row has 27 fields.
  • Fertilizer dates are valid DDMMYYYY and match the selector year unless deliberately yearless.
  • Annual N and P totals are plausible for the site and management intensity.

For tillage and irrigation files, also verify row counts do not exceed reader limits: fertilizer <=12, scheduled irrigation <=24, and tillage <=367.

Check every configured forcing year and selector, not just the first/last year. Keep source schedules and record provenance when merging. Carry missing years forward only when authorized, rebase event dates to the target year, and label the originating year and assumptions. Recompute water and nutrient totals after NetCDF readback and Excel roundtrips. See the contract's process checks for the specific equations and reader limitations.

canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 197kUpdated Claude CodeCodexVerifiedInstall