Optimisation set

The optimisation set is the central data type in a relion tomography project, and it only contains paths to other files. It is usually named optimisation_set.star.

../../../_images/optimisation_set.svg

Specifically, it can point to the following data files:

  • A tomogram set listing all tomograms.

  • A particle set listing all particles.

  • A trajectory set describing the motion of all particles.

  • A manifold set listing all manifolds (e.g. spheres or blobs).

  • A pair of reference half maps.

  • The FSC corresponding to the reference maps.

  • A mask to be used with the reference maps.

All of those entries are optional, and different programs require different inputs. All programs take an optimisation set as input, and most of them also write one out. If a data file is created or updated by a program, it is added to the optimisation set that the program writes out. This frees the user from having to track which programs update which data files. For example, relion_tomo_refine_ctf will only update the tomogram set, because the defoci are only defined once for each tilt image, while relion_tomo_align will update the tomogram set, the particle set and the trajectory set.

When running a program, the input optimisation set is always specified with the --i argument. In addition, the individual data files can also be specified separately, in which case the individual files will override the ones listed in the optimisation set. This allows the user to easily perform the same procedure with specific data files exchanged. If all data files required by a program have been specified individually, then an optimisation set is not required at all. The input arguments for the individual data files are always named as follows:

  • --t   for the tomogram set

  • --p   for the particle set

  • --mot   for the trajectory set

  • --man   for the manifold set.

  • --ref<1/2>   for the respective reference map

  • --mask   for the reference mask

  • --fsc   for the reference FSC

There are 3 ways to create an initial optimisation set:

  • Use the utility program relion_tomo_make_optimisation_set.

  • Run any program and specify the individual data files. The program will then output a new optimisation set.

  • Write one manually.