{"library":"mrcfile","title":"MRC File I/O Library","description":"mrcfile is a pure Python library designed for reading and writing MRC2014 file format data, commonly used in structural biology for image and volume data. It provides a simple API to expose file headers and data as NumPy arrays. The library is actively maintained, with frequent updates to support new Python and NumPy versions, and to enhance features like large file handling and validation.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install mrcfile"],"cli":null},"imports":["import mrcfile","import numpy as np"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import mrcfile\nimport numpy as np\nimport os\n\n# Define a filename for the MRC file\nfilename = 'example.mrc'\n\n# Create a new MRC file with some dummy data\ndata = np.random.rand(10, 20, 30).astype(np.float32)\nwith mrcfile.new(filename, data=data) as mrc:\n    mrc.voxel_size = 1.5 # Set a custom voxel size\n    print(f\"Created {filename} with shape {mrc.data.shape} and voxel size {mrc.voxel_size}\")\n\n# Open an existing MRC file in read mode\nwith mrcfile.open(filename) as mrc:\n    print(f\"Opened {filename}. Data shape: {mrc.data.shape}, dtype: {mrc.data.dtype}\")\n    print(f\"Header map ID: {mrc.header.map.decode('ascii')}\")\n    # Accessing a slice of data\n    first_slice = mrc.data[0, :, :]\n    print(f\"First slice min/max: {first_slice.min()}/{first_slice.max()}\")\n\n# Clean up the created file\nos.remove(filename)","lang":"python","description":"This quickstart demonstrates how to create a new MRC file with random data and then open it to inspect its header and data. It uses `mrcfile.new()` for creation and `mrcfile.open()` for reading, both utilizing Python's `with` statement for proper file handling. NumPy is used for data generation and manipulation.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":"1.5.4","pypi_latest":"1.5.4","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":3.8,"avg_import_s":0.27,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.24,"mem_mb":7.4,"disk_size":"89.6M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.8,"import_time_s":0.19,"mem_mb":7.4,"disk_size":"86M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.36,"mem_mb":8.4,"disk_size":"97.2M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.6,"import_time_s":0.29,"mem_mb":8.4,"disk_size":"93M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.28,"mem_mb":8,"disk_size":"85.6M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.5,"import_time_s":0.33,"mem_mb":8,"disk_size":"81M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.25,"mem_mb":8.5,"disk_size":"85.1M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.5,"import_time_s":0.31,"mem_mb":8.5,"disk_size":"81M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.22,"mem_mb":7.1,"disk_size":"97.4M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"mrcfile","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":4.4,"import_time_s":0.26,"mem_mb":7.1,"disk_size":"96M"}]}}