parse_cells_file#

CELLS_COLUMNS = ['ID', 'TICK', 'PARENT', 'POPULATION', 'AGE', 'DIVISIONS', 'STATE', 'PHASE', 'NUM_VOXELS']#: Column names for cells data parsed into tidy data format.

parse_cells_file(tar: tarfile.TarFile, regions: list[str]) → pd.DataFrame[source]#

Parse simulation cells data into tidy data format.

Parameters:

tar – Tar archive containing locations data.
regions – List of regions.

Returns:

Parsed cells data.

parse_cell_tick(tick: int, cell: dict, regions: list[str]) → list[source]#

Parse cell data for a single simulation tick.

Original data is formatted as:

{
    "id": cell_id,
    "parent": parent_id,
    "pop": population,
    "age": age,
    "divisions": divisions,
    "state": state,
    "phase": phase,
    "voxels": voxels,
    "criticals": [critical_volume, critical_height],
    "regions": [
        {
            "region": region_name,
            "voxels": region_voxels,
            "criticals": [critical_region_volume, critical_region_height]
        },
        ...
    ]
}

Parsed data is formatted as:

[ cell_id, tick, parent_id, population, age, divisions, state, phase, voxels ]

When regions are specified, each list also contains the number of voxels for the corresponding regions.

Parameters:

tick – Simulation tick.
cell – Original cell data.
regions – List of regions.

Returns:

Parsed cell data.