instrument-data-to-allotrope

Convert laboratory instrument output files to Allotrope Simple Model JSON.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/ilove323/comlan-skills --skill instrument-data-to-allotrope-ilove323
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: instrument-data-to-allotrope
Source: https://github.com/ilove323/comlan-skills/tree/main/bio-research/skills/instrument-data-to-allotrope
Command: npx skills add https://github.com/ilove323/comlan-skills --skill instrument-data-to-allotrope-ilove323

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires allotropy, pandas, openpyxl, pdfplumber, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Converts laboratory instrument output files into Allotrope Simple Model (ASM) format to enable standardized data exchange, integration with LIMS/ELN, and downstream analytics across teams.

Core Features & Use Cases

  • Auto-detects common instrument output formats (CSV, Excel, TSV, PDF) and converts them to ASM JSON.
  • Produces multiple deliverables: ASM JSON, flattened CSV for easy import, and exportable Python parsers for data engineers.
  • Includes provenance metadata, versioning, and optional validation hooks to ensure reproducibility and audit readiness.
  • Use cases include standardizing instrument data for LIMS uploads, data lakes, and downstream analysis pipelines, or generating organization-ready parsing code.

Quick Start

Run the Python script python convert_to_asm.py <input_file> to convert instrument output to ASM and emit input_file.asm.json alongside optional artifacts.

Frequently Asked Questions about instrument-data-to-allotrope

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert instrument output files to Allotrope ASM format?

To convert instrument output files to Allotrope ASM format, run the Python script 'convert_to_asm.py' with your input file. The tool auto-detects CSV, Excel, TSV, and PDF formats, outputting ASM JSON alongside optional flattened CSV and exportable Python parsers.

What is the Allotrope Simple Model used for in laboratory data conversion?

The Allotrope Simple Model (ASM) is used for standardized data exchange and LIMS/ELN integration. Converting instrument outputs to ASM JSON enables consistent downstream analytics across teams by applying provenance metadata, versioning, and validation hooks for audit readiness.

Does the Allotrope data conversion support PDF and Excel instrument exports?

Yes, Allotrope data conversion supports PDF and Excel instrument exports natively. The tool auto-detects common output formats including CSV, Excel, TSV, and PDF, utilizing native allotropy parsing for supported formats and a safe fallback parser for unsupported ones.

Can I generate Python parsers from instrument data for LIMS integration?

Yes, you can generate exportable Python parsers from instrument data for LIMS integration. The conversion process produces multiple deliverables including ASM JSON, flattened CSV for easy import, and exportable Python parsing code for data engineers to use in pipelines.

What happens when instrument data parsing fails for unsupported formats?

When instrument data parsing fails for unsupported formats, the tool applies a safe fallback parser path. This ensures conversion continuity even when native allotropy parsing is unavailable, while still maintaining provenance metadata and versioning for the output ASM JSON.

Why does converting laboratory data to ASM improve downstream analytics?

Converting laboratory data to ASM improves downstream analytics by standardizing diverse instrument outputs into a uniform JSON format. This standardization, combined with provenance metadata and validation hooks, ensures reproducibility and enables seamless integration into data lakes and analysis pipelines.