mat-xrd-digitizer

XRD Digitizer

Goal

To convert an image or screenshot of an X-Ray Diffraction (XRD) pattern into a digitized, numeric .xy data file, which can then be used by downstream analysis tools like mat-xrd-phase-analysis.

This skill leverages the AI Agent's built-in Vision/Language Model (VLM) capabilities. The Agent will visually parse the provided image to extract key peak positions (2-theta) and approximate relative intensities, and then use a provided script to mathematically generate a representative pseudo-Voigt profile.

Instructions

1. Extract Peaks Visually

Provide the agent with an image (e.g., screenshot) of the XRD plot. The agent will visually inspect the plot and identify the coordinates of the major peaks.

Handling Multiple Curves/Colors: If the image contains multiple XRD patterns, the user should specify which curve to digitize by its color, label, or position (e.g., "digitize the red curve" or "digitize the curve labeled 'sample A'"). The agent will then selectively extract peaks from only that specific curve.

Agent Action: The agent should:

1. Create a JSON file (e.g., peaks.json) containing the extracted peaks as an array of objects for the target curve. CRITICAL: You must ensure every single visible peak, including the tiny minor peaks, is reported and digitized to ensure accurate full-profile refinement downstream.
2. Save a copy of the original image (e.g., original_plot.png) in the same directory as the JSON file for future reference.

Example peaks.json format:

[
  {"2theta": 8.8, "intensity": 0.05, "fwhm": 0.3},
  {"2theta": 15.8, "intensity": 0.08, "fwhm": 0.3},
  {"2theta": 33.1, "intensity": 1.00, "fwhm": 0.3}
]

Note: intensity should be normalized between 0 and 1.0 (where the highest peak is 1.0). fwhm defaults to 0.3.

2. Generate the Digitized .xy File

Use the provided script to generate the experimental .xy file based on the extracted peaks.

# Env: base-agent
python .agents/skills/mat-xrd-digitizer/scripts/digitize_plot.py peaks.json --output digitized_plot.xy --min-x 5.0 --max-x 80.0