RoffIO

What it is and what it does

Roffio is a parser and writer for Roxar Open File Format (ROFF), a structured binary and ASCII file format used primarily in geoscience applications. It provides both eager and lazy reading modes: eager read loads the entire file into a nested dictionary structure keyed by tag and tag-key names, while lazy read iterates through tags and keys on-demand, useful for extracting specific values from large files without loading everything into memory.

The package handles ROFF's type system (int, float, double, bool, byte, char, and arrays thereof) and maps them to Python and numpy types. It supports files with duplicate tag names by returning lists of dictionaries when collisions occur. Binary ROFF files are automatically distinguished from ASCII variants, and endianness is managed through a filedata tag convention. The library depends on numpy for array handling and dataclasses for internal structure.

Use it for

• Extract specific values from large geoscience ROFF files without loading the entire file into memory using lazy read.
• Convert ROFF data to Python dictionaries for further processing or analysis in scientific workflows.
• Write structured geoscience data back to ROFF format, preserving type information and tag hierarchy.
• Parse binary ROFF files from legacy geoscience software and convert to modern formats.
• Handle ROFF files with repeated tag names by reading them as lists of dictionaries.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

roffio on PyPI

Before you install

Low install friction—pure Python wheel with only dataclasses and numpy as runtime dependencies. Active maintenance with recent commits; however, development status is marked as Planning, which may indicate the API is not yet stabilized.

License in practice

Licensed under LGPL-3.0 (copyleft). Any derivative work or modification must be distributed under the same license; static linking or closed-source distribution of modified versions is not permitted.

Quickstart

import roffio

# Read a ROFF file
contents = roffio.read("my/file.roff")
value = contents["tagname"]["keyname"]

# Write a ROFF file
roffio.write("my/file.roff", {"tagname": {"keyname": 1.0}})

# Lazy read to avoid loading entire file
with roffio.lazyread("my/file.roff") as contents:
    for tagname, tagkeys in contents:
        for keyname, value in tagkeys:
            print(tagname, keyname, value)

Package facts

Evidence: roffio-1.1.1-py3-none-any.whl

Tags

More Scientific/Engineering packages

See also binaryornot · fitsio · bincopy · dissect.cstruct · fabio · lasio · pyorc · hurry.filesize · linear-tsv · resfo