{"id":46822,"library":"wsidicom","title":"wsidicom","description":"Library for reading and writing DICOM Whole Slide Images (WSI). Current version 0.30.0, released irregularly. Supports Python >=3.10.","status":"active","version":"0.30.0","language":"python","source_language":"en","source_url":"https://github.com/imi-bigpicture/wsidicom","tags":["dicom","wsi","whole-slide-imaging"],"install":[{"cmd":"pip install wsidicom","lang":"bash","label":"pip install"}],"dependencies":[],"imports":[{"note":"","wrong":"","symbol":"WsiDicom","correct":"from wsidicom import WsiDicom"}],"quickstart":{"code":"from wsidicom import WsiDicom\n\nwith WsiDicom.open('slide.dcm') as wsi:\n    level = wsi.read_level(0)\n    print(level.shape)","lang":"python","description":"Open a DICOM WSI file and read the highest resolution level."},"warnings":[{"fix":"Use Python 3.10+ or pin to wsidicom <0.30.0.","message":"Python 3.9 support dropped; requires Python >=3.10 in 0.30.0.","severity":"breaking","affected_versions":">=0.30.0"},{"fix":"Validate output with a DICOM validator before clinical use.","message":"The library can read large WSIs, but writing is experimental and may produce non-conformant DICOM instances.","severity":"gotcha","affected_versions":"all"},{"fix":"Always use 'with WsiDicom.open(...)'.","message":"Opening a slide without a context manager may leave file handles open on errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'0.30.0':14 '3.10':19 'current':12 'dicom':7,20 'imag':10,25 'irregular':16 'librari':2 'python':18 'read':4 'releas':15 'slide':9,24 'support':17 'version':13 'whole':8,23 'whole-slide-imag':22 'write':6 'wsi':11,21 'wsidicom':1","created_at":"2026-06-07T13:01:48.204871+00:00","updated_at":"2026-06-07T13:01:48.204871+00:00","problems":[{"fix":"Run 'pip install wsidicom' in the same Python environment.","cause":"wsidicom not installed or installed in the wrong environment.","error":"ModuleNotFoundError: No module named 'wsidicom'"},{"fix":"Ensure the input file is a valid DICOM WSI. Some vendors may not adhere to the standard.","cause":"The DICOM file is missing required tags for WSI metadata.","error":"KeyError: 'instance_number'"},{"fix":"Verify the file is a DICOM WSI. Use 'dcmdump' or similar tool to inspect.","cause":"File is not DICOM or is corrupted.","error":"ValueError: Invalid DICOM file"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/imi-bigpicture/wsidicom","github":"https://github.com/imi-bigpicture/wsidicom","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["storage"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}