Parse, modify, validate, and patch simulator input files. Use when working with reservoir simulation input files, testing scenarios, or validating simulation configurations. This implementation supports reference format (.DATA); other simulators use different extensions (e.g., .afi, .DAT). Supports natural language modifications, keyword patching, and syntax validation.
Parse, modify, validate, and patch simulator input files. Use when working with reservoir simulation input files, testing scenarios, or validating simulation configurations. This implementation supports reference format (.DATA); other simulators use different extensions (e.g., .afi, .DAT). Supports natural language modifications, keyword patching, and syntax validation.
Requires simulator tools and Python environment with langchain, pydantic, and nvidia-ai-endpoints packages
DATA File Processing Skill
This skill provides tools for working with simulator input files. The reference format uses .DATA as the primary input extension; other simulators use different extensions.
Overview
The DATA File Processing skill enables agents to:
Parse simulator input files to understand their structure and sections
Modify simulator input files using natural language instructions
Validate simulator input files for syntax and consistency
Patch specific keyword blocks without rewriting entire files
Tools
parse_simulation_input_file
Parses a simulator input file and returns its structure (sections found). Reference format uses .DATA extension.
Returns: A string listing all sections found (e.g., "Sections found: HEADER, RUNSPEC, GRID, PROPS, SOLUTION, SUMMARY, SCHEDULE")
When to use: First step in scenario testing chain (TOOL_DECISION_TREE.md Section 2.4) or when user asks to parse/list sections of a simulator input file.
modify_simulation_input_file
Modifies a simulator input file based on natural language instructions. Can modify entire file or target specific keyword blocks.
file_path: Path to the simulator input file to modify
modifications: Natural language description of changes (e.g., "Increase water injection rate for well I1 to 55")
output_path: Where to save modified file (default: overwrite original)
llm_model: Optional model override for LLM-based modifications
manual_context: Optional simulator manual excerpt for the relevant keyword
example_context: Optional example DATA snippets for the relevant keyword
target_keyword: If set, only this keyword block is edited; rest of file is copied unchanged
Example:
modify_simulation_input_file(
file_path="SPE1CASE1.DATA",
modifications="Increase water injection rate for well I1 in WCONINJE to 55",
output_path="SPE1CASE1_AGENT_GENERATED.DATA",
target_keyword="WCONINJE"
)
When to use: In scenario test chain (Section 2.4) after parse_simulation_input_file → simulator_manual → simulator_examples, or when user requests modifications to a simulator input file.
patch_simulation_input_keyword
Patches a specific keyword block in a simulator input file without modifying other parts. Useful for auto-fixes.
