Requirements

• CPython >= 3.7

• Numpy 1.15

• Scipy 1.4

• H5py 2.10

• Tifffile 2019.8.25

• Oiffile 2020.9.18

References

1. Thomas Goddard. [Chimera-users] reading in hdf5 files in chimera. https://www.cgl.ucsf.edu/pipermail/chimera-users/2008-September/003052.html

2. UCSF Chimera, an extensible molecular modeling system. https://www.cgl.ucsf.edu/chimera/

3. Globals for Images - SimFCS. https://www.lfd.uci.edu/globals/

Examples

Convert a 5D LSM file to CMAP file:

python -m cmapfile "/my data directory/large.lsm"

Convert all BIN files in the current directory to test.cmap. The BIN files are known to contain 128x128x64 samples of 16 bit integers. The CMAP file will store float32 maps using subsampling up to 16:

python -m cmapfile --shape 128,128,64 --step 1,1,2 --dtype i2
                   --cmap test.cmap --subsample 16 --astype float32 *.bin

Change the step size in the CMAP file:

python -m cmapfile --step 1,1,1.5 test.cmap

Notes

The CMAP file format according to [1]:

Example of HDF format written by Chimera (Chimera map format) follows.
The Chimera map file reader will allow all fields to be missing (except
the 3D data).

/image (group, any name allowed)
 name "centriole" (attribute)
 step (1.2, 1.2, 1.2) (attribute)
 origin (-123.4, -522, 34.5) (attribute)
 cell_angles (90.0, 90.0, 90.0) (attribute)
 rotation_axis (0.0, 0.0, 1.0) (attribute)
 rotation_angle 45.0 (attribute, degrees)
 /data (3d array of uint8 (123,542,82)) (dataset, any name allowed)
 /data_x (3d array of uint8 (123,542,82), alternate chunk shape) (dataset)
 /data_2 (3d array of uint8 (61,271,41)) (dataset, any name allowed)
    subsample_spacing (2, 2, 2) (attribute)
 (more subsampled or alternate chunkshape versions of same data)

Revisions

2021.2.26

Fix LSM conversion with tifffile >= 2021.2.26. Remove support for Python 3.6 (NEP 29).

2020.1.1

Do not write name attribute. Remove support for Python 2.7 and 3.5. Update copyright.

2018.8.30

Move cmapfile.py into cmapfile package.

2014.10.10

Initial release.