Skip to main content

Write Chimera Map (CMAP) files

Project description

Cmapfile is a Python library and console script to write Chimera Map (CMAP) files, HDF5 files containing series of 3D XYZ datasets.

CMAP files can be created from numpy arrays and various file formats containing volume data, e.g. BIN, TIFF, LSM, OIF, and OIB.

CMAP files can be visualized using UCSF Chimera [2], a highly extensible program for interactive visualization and analysis of molecular structures and related data.

For command line usage run python -m cmapfile --help

Author:Christoph Gohlke
Organization:Laboratory for Fluorescence Dynamics. University of California, Irvine


  1. Thomas Goddard. [Chimera-users] reading in hdf5 files in chimera.
  2. UCSF Chimera, an extensible molecular modeling system.
  3. Globals for Images - SimFCS.


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


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)


Move into cmapfile package.
Initial release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for cmapfile, version 2018.10.18
Filename, size File type Python version Upload date Hashes
Filename, size cmapfile-2018.10.18-py2.py3-none-any.whl (11.8 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size cmapfile-2018.10.18.tar.gz (10.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page