tomodrgn.commands.subtomo2chimerax.validate_starfile#

validate_starfile(ptcl_star: GenericStarfile | TomoParticlesStarfile, ptcl_block_name: str, star_angpix_override: float | None = None, tomo_id_col_override: str | None = None) tuple[list[str], list[str], float, str][source]#

Identify the star file particles data block and relevant columns within it which specify particle coordinates, angle, pixel size, and tomogram name.

Parameters:
  • ptcl_star – volume-series star file (each row refers to a unique particle)

  • ptcl_block_name – name of the star file data block containing per-particle data (e.g. data_particles)

  • star_angpix_override – optional override to pixel size detected in star file (default identified as first column containing Pixel substring)

  • tomo_id_col_override – optional override to column name specifying source tomogram for each particle (default: _rlnMicrographName)

Returns:

list of column names describing particle rotations, list of column names describing particle coordinates, pixel size of subtomogram coordinates, column name which names source tomogram