{"id":38795006,"url":"https://github.com/piotrrozentreter/dcmcreator","last_synced_at":"2026-02-11T13:03:38.384Z","repository":{"id":332109287,"uuid":"1116948557","full_name":"piotrrozentreter/dcmcreator","owner":"piotrrozentreter","description":"An application that allows creating and editing DICOM metadata and images, along with several testing tools.","archived":false,"fork":false,"pushed_at":"2026-02-02T14:17:24.000Z","size":60732,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-03T01:58:42.905Z","etag":null,"topics":["dcm","dicom","dicom-viewer","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/piotrrozentreter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-15T15:57:31.000Z","updated_at":"2026-02-02T14:17:03.000Z","dependencies_parsed_at":"2026-01-17T13:13:25.827Z","dependency_job_id":null,"html_url":"https://github.com/piotrrozentreter/dcmcreator","commit_stats":null,"previous_names":["piotrrozentreter/dcmcreator"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/piotrrozentreter/dcmcreator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrrozentreter%2Fdcmcreator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrrozentreter%2Fdcmcreator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrrozentreter%2Fdcmcreator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrrozentreter%2Fdcmcreator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/piotrrozentreter","download_url":"https://codeload.github.com/piotrrozentreter/dcmcreator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrrozentreter%2Fdcmcreator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29333155,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T12:42:24.625Z","status":"ssl_error","status_checked_at":"2026-02-11T12:41:23.344Z","response_time":97,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dcm","dicom","dicom-viewer","python3"],"created_at":"2026-01-17T12:41:38.265Z","updated_at":"2026-02-11T13:03:38.378Z","avatar_url":"https://github.com/piotrrozentreter.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DICOM Creator\n\nA professional DICOM file creation, editing, and transmission tool with comprehensive testing, validation, and performance analysis capabilities.\n\n![Version](https://img.shields.io/badge/version-0.6.1-blue.svg)\n![Python](https://img.shields.io/badge/python-3.9+-green.svg)\n![License](https://img.shields.io/badge/license-MIT-green.svg)\n![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)\n\n## Table of Contents\n\n- [Screenshots](#screenshots)\n- [Features](#features)\n- [What's New in v0.6.1](#whats-new-in-v061)\n- [What's New in v0.6.0](#whats-new-in-v060)\r\n- [Quick Start](#quick-start)\r\n- [Building Your Own EXE](#building-your-own-exe)\r\n- [Usage](#usage)\r\n- [Documentation](#documentation)\r\n- [System Requirements](#system-requirements)\r\n- [Version History](#version-history)\r\n- [Troubleshooting](#troubleshooting)\r\n- [License](#license)\r\n\r\n## Screenshots\r\n\r\n### Main Application Interface\r\n\r\n![Main Interface](pic1.png)\r\n\r\n![Pic2](pic2.png)\r\n\r\n![Pic 3](pic3.png)\r\n\r\n![Pic 4](pic4.png)\n\n## What's New in v0.6.1\n\n**Release Date**: February 2026\n\n### 🐛 Bug Fixes\n\n#### LazyImport Class Loading Enhancement\n- **Fixed**: ConnectionValidator failed to load correctly when CEchoValidator appeared first in module inspection\n- **Enhanced**: LazyImport now intelligently prioritizes main/public classes in modules with multiple class definitions\n- **Impact**: Connection Test tab now loads correctly and all LazyImport modules work reliably\n\n#### Improved Error Reporting\n- Better error messages when VRValidator or other modules fail to load\n- Detailed logging with full stack traces for debugging\n- User-friendly error dialogs with diagnostic information\n\n#### Enhanced Documentation\n- Added LazyImport usage guidelines to Copilot instructions\n- Improved inline documentation in import_helper.py\n- Updated docstrings for better code clarity\n\n### ✅ Compatibility\n- **100% backward compatible** with v0.6.0\n- All settings, presets, and data preserved\n- No dependency changes\n- Drop-in replacement upgrade\n\n### 📖 Full Details\nSee [CHANGELOG_v0.6.1.md](doc/CHANGELOG_v0.6.1.md) for complete release notes.\n\n---\n\n## What's New in v0.6.0\n\n**Release Date**: January 2025\n\n### Features\r\n\r\n### Core Features\r\n- **DICOM Metadata Management** - Create and edit patient, study, and series metadata\r\n- **Image Support** - Load and preview images (PNG, JPG, BMP) as DICOM pixel data\r\n- **DICOM File Operations** - Load, save, and organize DICOM files and folders\r\n- **Remote Transmission** - Send DICOM files to remote DICOM SCP servers using C-STORE\r\n- **Server Presets** - Save and manage server connection profiles\r\n- **DICOM Tag Viewer** - View all DICOM tags including private tags with search and export\r\n- **VR Validator** - Validate DICOM data against Value Representation specifications\r\n\r\n### Advanced Features (v0.3+)\r\n\r\n#### **Server Presets**\r\n- Save frequently used DICOM server configurations\r\n- Quick load and apply with one click\r\n- Persistent storage across sessions\r\n- Multi-server profile management\r\n\r\n#### **Connection Testing \u0026 Validation**\r\n- TCP connection validation to DICOM servers\r\n- Connection quality assessment\r\n- Latency variation analysis\r\n- Real-time network performance metrics\r\n\r\n#### **Stress Testing**\r\n- Load simulation and capacity planning\r\n- Configurable test parameters (files/sec, duration, file size)\r\n- Multi-worker support for parallel testing\r\n- Performance metrics collection\r\n\r\n#### **Transmission History \u0026 Analytics**\r\n- Track all DICOM transmissions with timestamps\r\n- Success/failure statistics and reporting\r\n- Throughput analysis\r\n- JSON export for external reporting\r\n\r\n#### **Performance Benchmarking**\r\n- File size performance analysis\r\n- Latency benchmarking\r\n- Throughput measurements\r\n- Performance trend visualization\r\n\r\n#### **Parallel Transmission**\r\n- Multi-threaded transmission manager\r\n- 1-10 configurable worker threads\r\n- 3-5x speed improvement over sequential sending\r\n- Real-time progress tracking\r\n\r\n#### **Test Data Generation**\r\n- Random DICOM Generator - Create test files with random metadata\r\n- Hierarchical generation (Patient → Study → Series → Instances)\r\n- Bulk generation with configurable sizes\r\n- Integrated testing workflow\r\n- Immediate test and send capabilities\r\n\r\n### What's New in v0.6.0\r\n\r\n**Enhanced Validation Features:**\r\n- **Real-time VR Validation** - Validate form data as you edit with comprehensive VR compliance checks\r\n- **Validation Dialogs** - Interactive validation reports with field-level error reporting\r\n- **Field-Level Validation** - Immediate feedback on individual DICOM data elements\r\n- **Load-Time Validation** - Automatic validation when loading DICOM files with warnings for issues\r\n- **Pre-Save Validation** - Prevent saving invalid DICOM files with detailed error messages\r\n- **Pre-Send Validation** - Validate before remote transmission to DICOM servers\r\n\r\n**UI Improvements:**\r\n- **Validation Report Dialog** - Detailed visual reporting of validation errors and warnings\r\n- **Enhanced Error Messages** - Clear descriptions of validation issues with remediation suggestions\r\n- **Tab Visibility Management** - Toggle test tabs on/off via View menu\r\n- **Improved Image Preview** - Better handling of various image formats and dimensions\r\n- **Enhanced Context Menus** - Right-click on instances to view images\r\n\r\n**DICOM Operations:**\r\n- **DICOMDIR Support** - Load and expand DICOMDIR files to reference datasets\r\n- **Private Tag Preservation** - Maintain private tags during save operations\r\n- **Group Length Cleanup** - Automatic removal of deprecated Group Length tags (DICOM 2008+ compliance)\r\n- **Enhanced Tag Verification** - Post-save verification of tag integrity\r\n\r\n**Testing Enhancements:**\r\n- **Connection Validator Improvements** - Better error detection and reporting\r\n- **Parallel Transmission** - Improved worker management and progress tracking\r\n- **Transmission History** - Enhanced session tracking and statistics\r\n\r\n**Developer \u0026 Admin Features:**\r\n- **Improved LazyImport** - Better handling of multi-class modules with explicit class selection\r\n- **Enhanced Logging** - Detailed debug information for troubleshooting\r\n- **Better Error Diagnostics** - Clear error messages for import and module loading issues\r\n\r\n**Documentation:**\r\n- Complete VR Validator documentation\r\n- Enhanced troubleshooting guides\r\n- New validation workflow documentation\r\n- Improved API documentation for developers\r\n\r\n## Quick Start\r\n\r\n### Option 1: Run as EXE (Windows, No Python Required)\r\n\r\n[![Download Badge](https://img.shields.io/badge/download-Windows%20EXE-blue.svg)](https://github.com/piotrrozentreter/dcmcreator/releases)\r\n\r\n**Download \u0026 Extract:**\r\n1. Get the `DICOM Creator` folder from `dist/`\r\n2. Extract anywhere on Windows\r\n3. Double-click `DICOM Creator.exe`\r\n\r\n**No installation required!** Everything is packaged inside.\r\n\r\n### Option 2: Run from Python Source\r\n\r\n**Requirements:**\r\n- Python 3.9 or higher\r\n- Windows, macOS, or Linux\r\n\r\n**Installation:**\r\n```bash\r\n# Clone the repository\r\ngit clone https://github.com/piotrrozentreter/dcmcreator\r\ncd dcmcreator\r\n\r\n# Create virtual environment (optional but recommended)\r\npython -m venv venv\r\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\r\n\r\n# Install dependencies\r\npip install -r requirements.txt\r\n\r\n# Run the application\r\npython src/app.py\r\n```\r\n\r\n**Dependencies:**\r\n- `pydicom` - DICOM file handling\r\n- `pynetdicom` \u003e= 2.0.0 - DICOM network communication\r\n- `pillow` (PIL) - Image processing\r\n- `numpy` - Numerical arrays\r\n\r\n## Building Your Own EXE\r\n\r\nWant to build a standalone executable yourself?\r\n\r\n### Build Requirements\r\n\r\nStarting with **v0.4.0+**, the build includes additional optional modules for testing. Make sure you have all dependencies:\r\n\r\n```bash\r\n# Install build dependencies (updated for v0.6.0)\r\npip install -r build-requirements.txt\r\n```\r\n\r\n**build-requirements.txt** now includes:\r\n- `PyInstaller\u003e=6.0.0` - EXE builder\r\n- `pillow\u003e=10.0.0` - Image processing\r\n- `pydicom\u003e=2.4.0` - DICOM library (analysis)\r\n- `pynetdicom\u003e=2.0.0` - Network DICOM (analysis)\r\n- `numpy\u003e=1.20.0` - Array processing (analysis)\r\n\r\n### Build Process\r\n\r\n```bash\r\n# Create icon (generates app.ico)\r\npython create_icon.py\r\n\r\n# Build the executable (includes all optional modules)\r\npython build.py\r\n```\r\nFor Windows, you can also run:\r\n```bat\r\nbuild.bat\r\n```\r\n\r\nYour standalone EXE will be created in `dist/DICOM Creator/` with:\r\n- All core DICOM features\r\n- All connection testing features\r\n- All stress testing features\r\n- All transmission history features\r\n- All performance benchmarking features\r\n- All parallel transmission features\r\n- Enhanced validation system (v0.6.0)\r\n- Improved LazyImport system (v0.6.0)\r\n\r\n**See [doc/BUILD_INSTRUCTIONS.md](doc/BUILD_INSTRUCTIONS.md) for detailed build guide.**\r\n\r\n### What's Bundled (v0.6.0)\r\n\r\nThe build now automatically includes:\r\n\r\n| Component | Size | Purpose |\r\n|-----------|------|---------|\r\n| PyDICOM | ~40 MB | DICOM file handling |\r\n| PyNetDICOM | ~30 MB | Network DICOM C-STORE |\r\n| NumPy | ~30 MB | Array processing |\r\n| PIL/Pillow | ~10 MB | Image processing |\r\n| Application | ~5 MB | GUI and logic |\r\n| **Total** | **150-200 MB** | Uncompressed |\r\n| **ZIP** | **60-70 MB** | Compressed distribution |\r\n\r\nAll optional test modules are automatically included in the build - no extra configuration needed!\r\n\r\n## Usage\r\n\r\n### Creating DICOM Files\r\n\r\n1. Fill in Patient, Study, Series metadata\r\n2. (Optional) Load an image via Image tab\r\n3. Click \"Validate\" from File menu to check your data (v0.6.0)\r\n4. Click \"Save\" to save as DICOM\r\n\r\n### Loading DICOM Files\r\n\r\n1. Go to \"Load DICOM\" tab\r\n2. Click \"Load DICOM File(s)\" or \"Load DICOM Folder\"\r\n3. Select studies/series from the tree\r\n4. Metadata auto-populates in the forms\r\n5. Any validation issues are reported (v0.6.0)\r\n\r\n### Sending to Remote Server\r\n\r\n1. Fill in Server IP/hostname and Port\r\n2. Optionally adjust AE Titles\r\n3. Validation is performed before sending (v0.6.0)\r\n4. Click \"Send All Loaded DICOM\"\r\n5. Monitor progress in Messages area\r\n\r\n#### Using Server Presets\r\n1. Go to \"Remote\" tab\r\n2. (Optional) Select a preset from dropdown to auto-load settings\r\n3. Or manually enter server details and click \"Save Current\" to save as preset\r\n4. Select preset and click \"Load\" or simply select and it auto-applies\r\n5. Click \"Send All Loaded DICOM\"\r\n\r\n### Data Validation \u0026 VR Compliance (v0.6.0)\r\n\r\n#### Validate Form Data\r\n- Go to \"File\" menu → \"Validate\" to check all form fields against VR specifications\r\n- View detailed validation report with specific error messages\r\n- Get remediation suggestions for invalid values\r\n- Optional: continue anyway if there are only warnings\r\n\r\n#### DICOM Data Inspection\r\n- Go to \"DICOM\" menu → \"View VRs\" to browse complete DICOM Value Representations\r\n- Go to \"DICOM\" menu → \"View All Tags\" to inspect all tags in a DICOM file:\r\n  - View all public and private tags\r\n  - Search and filter tags\r\n  - Export tags to text file\r\n  - View tag statistics\r\n  - Color-coded private tags\r\n\r\n#### Automatic Load Validation\r\n- When loading DICOM files, validation is performed automatically\r\n- Any errors or warnings are reported in a dialog\r\n- You can view the full validation report if needed\r\n\r\n### Testing \u0026 Validation\r\n\r\n#### Connection Testing\r\n- Go to \"Connection Test\" tab\r\n- Enter server details\r\n- Click \"Test Connection\" to validate\r\n- Review latency and connection quality metrics\r\n\r\n#### Stress Testing\r\n- Go to \"Stress Test\" tab\r\n- Configure test parameters (number of files, duration, worker threads)\r\n- Click \"Start Stress Test\"\r\n- Monitor real-time performance metrics\r\n\r\n#### Transmission History\r\n- Go to \"Transmission History\" tab\r\n- View all past transmissions\r\n- See success/failure rates\r\n- Export data as JSON\r\n\r\n#### Performance Benchmarking\r\n- Go to \"Performance Benchmark\" tab\r\n- Run benchmarks for file size and latency analysis\r\n- Review throughput trends\r\n\r\n#### Parallel Transmission\r\n- Go to \"Parallel Transmission\" tab\r\n- Configure number of worker threads (1-10)\r\n- Select files and destination\r\n- Transmit with improved performance\r\n\r\n### Loading Images\r\n1. Go to Image tab\r\n2. Click \"Load Image\"\r\n3. Select PNG, JPG, or BMP file\r\n4. Image converts to grayscale and displays preview\r\n\r\n## System Requirements\r\n\r\n### For EXE (Windows Only)\r\n- Windows 7 or newer (64-bit)\r\n- 100 MB disk space\r\n- 300 MB RAM minimum\r\n\r\n### For Python\r\n- Python 3.9+\r\n- Cross-platform: Windows, macOS, Linux\r\n- 500 MB disk space\r\n- 500 MB RAM minimum\r\n\r\n## Documentation\r\n\r\n### User Documentation\r\n- **[doc/INDEX.md](doc/INDEX.md)** - Complete documentation index and navigation\r\n- **[doc/QUICK_START_TAG_VIEWER.md](doc/QUICK_START_TAG_VIEWER.md)** - Tag Viewer quick start guide\r\n- **[doc/TAG_VIEWER_FEATURE.md](doc/TAG_VIEWER_FEATURE.md)** - Complete Tag Viewer documentation\r\n- **[doc/QUICK_START_PRESETS.md](doc/QUICK_START_PRESETS.md)** - Server Presets quick start guide\r\n- **[doc/SERVER_PRESETS.md](doc/SERVER_PRESETS.md)** - Comprehensive Server Presets documentation\r\n- **[doc/QUICK_START_RANDOM_DICOM.md](doc/QUICK_START_RANDOM_DICOM.md)** - Random DICOM generator quick start\r\n- **[doc/RANDOM_DICOM_GENERATOR.md](doc/RANDOM_DICOM_GENERATOR.md)** - Detailed DICOM generator guide\r\n\r\n### Advanced Testing Guides\r\n- **[doc/PARALLEL_TRANSMISSION_GUIDE.md](doc/PARALLEL_TRANSMISSION_GUIDE.md)** - Parallel transmission setup and tuning\r\n- **[doc/QUICK_TEST_EXECUTION_GUIDE.md](doc/QUICK_TEST_EXECUTION_GUIDE.md)** - Testing workflow guide\r\n- **[doc/COMPLETE_TEST_EXECUTION_REFERENCE.md](doc/COMPLETE_TEST_EXECUTION_REFERENCE.md)** - Complete testing reference\r\n- **[doc/HIERARCHICAL_GENERATION.md](doc/HIERARCHICAL_GENERATION.md)** - Hierarchical DICOM generation guide\r\n- **[test/README.md](test/README.md)** - Test scripts documentation\r\n\r\n### Running Tests\r\n```bash\r\n# Run all tests\r\npython test/run_all_tests.py\r\n\r\n# Run individual tests\r\npython test/test_hierarchical_generation.py\r\npython test/test_build.py\r\npython test/verify_build.py\r\n```\r\n\r\n### Developer Documentation\r\n- **[doc/DEVELOPER_GUIDE_PRESETS.md](doc/DEVELOPER_GUIDE_PRESETS.md)** - Developer guide for Server Presets\r\n- **[doc/EXTERNAL_SCRIPT_USAGE.md](doc/EXTERNAL_SCRIPT_USAGE.md)** - Using DICOM Creator as a library\r\n\r\n### Build \u0026 Deployment\r\n- **[doc/BUILD_INSTRUCTIONS.md](doc/BUILD_INSTRUCTIONS.md)** - Complete guide to building the EXE\r\n- **[doc/DISTRIBUTION_GUIDE.md](doc/DISTRIBUTION_GUIDE.md)** - Distribution and deployment guide\r\n\r\n### Additional Resources\n- **[examples/](examples/)** - Example scripts for common tasks\n- **[doc/CHANGELOG_v0.6.1.md](doc/CHANGELOG_v0.6.1.md)** - Release notes for v0.6.1 (Latest)\n- **[doc/CHANGELOG_v0.6.0.md](doc/CHANGELOG_v0.6.0.md)** - Release notes for v0.6.0\n- **[doc/CHANGELOG_v0.5.0.md](doc/CHANGELOG_v0.5.0.md)** - Release notes for v0.5.0\n- **[doc/CHANGELOG_v0.4.0.md](doc/CHANGELOG_v0.4.0.md)** - Release notes for v0.4.0\n- **[doc/CHANGELOG_v0.3.0.md](doc/CHANGELOG_v0.3.0.md)** - Release notes for v0.3.0+\n\n## Project Structure\n\n```\ndcmcreator/\n├── src/\n│   ├── app.py                      (Entry point)\n│   ├── appgui.py                   (Main GUI application - v0.6.1)\n│   ├── app_logic.py                (Core application logic)\n│   ├── import_helper.py            (Enhanced LazyImport - v0.6.1)\n│   ├── dcm.py                      (DICOM creation/loading)\n│   ├── remote.py                   (DICOM C-STORE sending)\n│   ├── presets.py                  (Server Presets management)\n│   ├── connection_validator.py     (Connection testing - v0.6.1 fix)\n│   ├── stress_tester.py            (Stress testing)\n│   ├── transmission_history.py     (Transmission tracking)\n│   ├── performance_benchmarking.py (Performance analysis)\n│   ├── parallel_transmission.py    (Multi-threaded sending)\n│   ├── random_dicom.py             (Test DICOM generator)\n│   ├── test_runner.py              (Testing framework)\n│   ├── vr_validator.py             (VR validation - v0.6.0)\n│   ├── validation_dialog.py        (Validation UI - v0.6.0)\n│   ├── tag_dialog.py               (Tag viewer UI)\n│   └── dcmlogger.py                (Logging setup)\n├── test/                           (Test scripts and verification)\n│   ├── test_build.py               (Build system test)\n│   ├── test_hierarchical_generation.py (Hierarchical DICOM test)\n│   ├── test_tag_viewer.py          (Tag viewer test)\n│   ├── verify_build.py             (Build verification)\n│   ├── run_all_tests.py            (Run all tests)\n│   └── README.md                   (Test documentation)\n├── examples/                       (Example scripts for features)\r\n├── doc/                            (Comprehensive documentation)\r\n├── dist/                           (Distribution EXE folder)\r\n├── build.py                        (Python build script)\r\n├── build.bat                       (Windows build script)\r\n├── dcmcreator.spec                 (PyInstaller configuration)\r\n├── create_icon.py                  (Icon generator)\r\n├── requirements.txt                (Runtime dependencies)\r\n├── build-requirements.txt          (Build dependencies)\r\n├── .github/copilot-instructions.md (Development guidelines)\r\n├── pic1.png                        (Screenshot - Main interface)\r\n├── pic2.png                        (Screenshot - DICOM tree/remote)\r\n├── pic3.png                        (Screenshot - Test generation)\r\n├── pic4.png                        (Screenshot - Connection testing)\r\n└── README.md                       (This file)\r\n```\r\n\r\n## Version History\n\n### Version 0.6.1 (Current)\n**Release Date**: February 2026\n\n**Bug Fixes:**\n- **LazyImport Class Loading** - Fixed ConnectionValidator loading when multiple classes exist in module\n- **Enhanced Error Reporting** - Better error messages for module loading failures\n- **Improved Logging** - Detailed class loading attempts with full context\n\n**Improvements:**\n- Intelligent class selection for modules with multiple classes\n- Enhanced documentation and Copilot instructions\n- Better fallback mechanisms for missing dependencies\n\n**Compatibility:**\n- 100% backward compatible with v0.6.0\n- All settings and data preserved\n- No dependency changes\n\n**Full Details:** See [CHANGELOG_v0.6.1.md](doc/CHANGELOG_v0.6.1.md)\n\n---\n\n### Version 0.6.0\n**Release Date**: January 2025\n\n**Major Features:**\n- **Real-time VR Validation System** - Comprehensive validation of DICOM data elements\n- **Validation Report Dialogs** - Interactive UI for viewing and understanding validation issues\n- **DICOM Load Validation** - Automatic validation when loading DICOM files with error reporting\n- **Pre-Send Validation** - Validate before remote transmission to ensure compliance\n- **DICOMDIR Support** - Load and reference DICOM dataset files\n- **Private Tag Preservation** - Maintain private tags during file operations\n- **Group Length Cleanup** - Automatic DICOM 2008+ compliance\n\n**Enhancements:**\n- Enhanced field-level validation with remediation suggestions\n- Improved context menus for DICOM instances\n- Better image preview handling for various formats\n- Improved error messages and diagnostics\n\n**UI Improvements:**\n- View menu for toggling test tabs on/off\n- Enhanced validation dialogs with detailed reporting\n- Better image preview resizing and display\n- Improved right-click context menus\n\n**Bug Fixes:**\n- Fixed validation dialog display issues\n- Improved error handling for missing dependencies\n- Better handling of edge cases in image preview\n\n**Full Details:** See [CHANGELOG_v0.6.0.md](doc/CHANGELOG_v0.6.0.md)\n\n---\r\n\r\n### Version 0.5.0\r\n**Release Date**: January 2025\r\n\r\n**New Features:**\r\n- Enhanced LazyImport system with improved class detection\r\n- Better handling of modules with multiple classes\r\n- Improved module loading reliability\r\n\r\n**Improvements:**\r\n- Better error diagnostics for module loading\r\n- Enhanced logging for troubleshooting\r\n- Performance optimizations\r\n\r\n**Bug Fixes:**\r\n- Fixed ConnectionValidator class loading issue\r\n- Improved module import reliability\r\n- Better handling of missing optional dependencies\r\n\r\n### Version 0.4.0\r\n**Release Date**: December 2024\r\n\r\n**Major Features:**\r\n- Connection testing and validation\r\n- Stress testing capabilities\r\n- Transmission history tracking\r\n- Performance benchmarking\r\n- Parallel transmission manager\r\n\r\n### Version 0.3.0\r\n**Release Date**: November 2024\r\n\r\n**Major Features:**\r\n- Server Presets management\r\n- Tag Viewer with search and export\r\n- VR Validator\r\n- Random DICOM Generator\r\n\r\n### Version 0.2.0\r\n**Release Date**: October 2024\r\n\r\n**Major Features:**\r\n- Remote DICOM transmission (C-STORE)\r\n- DICOM file loading and organization\r\n- Image loading and preview\r\n\r\n### Version 0.1.0\r\n**Release Date**: September 2024\r\n\r\n**Initial Release:**\r\n- Basic DICOM creation\r\n- Patient/Study/Series metadata management\r\n- Save DICOM files\r\n\r\n## Author\r\n\r\nWritten by **Piotr Rozentreter**\r\n\r\n## License\r\n\r\nMIT License. See `LICENSE` for details.\r\n\r\n## Support \u0026 Contributing\r\n\r\n- **GitHub**: https://github.com/piotrrozentreter/dcmcreator\r\n- **Issues**: Report bugs via GitHub Issues\r\n- **Internal Support**: Contact development team\r\n\r\n## Troubleshooting\r\n\r\n### EXE Won't Start\r\n- Windows may block unsigned executables - click \"More info\" -\u003e \"Run anyway\"\r\n- Check antivirus software settings\r\n- Run from command line for error messages: `\"DICOM Creator.exe\"`\r\n\r\n### Slow Startup\r\n- First run takes 15-30 seconds (unpacking files)\r\n- Subsequent runs are faster (5-10 seconds)\r\n- Normal behavior for PyInstaller executables\r\n\r\n### Dependencies Missing\r\n- Ensure Python 3.9+ is installed\r\n- Run `pip install -r requirements.txt` to install dependencies\r\n- Check that pydicom and pynetdicom are properly installed\r\n\r\n### Connection Issues\r\n- Use \"Connection Test\" tab to validate server connectivity\r\n- Check firewall and network settings\r\n- Verify server IP and port are correct\r\n- Try saving and loading a Server Preset\r\n\r\n### Module Loading Issues (v0.5.0+)\r\n- Check log files for detailed error messages\r\n- Verify all dependencies are installed\r\n- Try reinstalling with `pip install -r requirements.txt --force-reinstall`\r\n- Contact support if LazyImport errors persist\r\n\r\n### Validation Issues (v0.6.0)\r\n- Check that `src/VR.xml` exists in your installation\r\n- VR Validator requires the complete DICOM dictionary\r\n- Review validation error messages for specific remediation steps\r\n- Fields marked with warnings can still be saved if needed\r\n\r\n### Common Error Messages\r\n\r\n#### \"VRValidator not available\"\r\n- VR.xml file missing from installation\r\n- Check that `src/VR.xml` exists\r\n- Rebuild or reinstall the application\r\n\r\n#### \"Connection Validator could not be loaded\"\r\n- Fixed in v0.5.0 with enhanced LazyImport\r\n- Update to latest version\r\n- Check that `connection_validator.py` is present\r\n\r\n#### \"Validation errors found\"\r\n- Review the validation report dialog (v0.6.0)\r\n- Common issues: incorrect date format (YYYYMMDD), invalid VR values\r\n- Fix issues or click \"Continue\" if warnings only\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrrozentreter%2Fdcmcreator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiotrrozentreter%2Fdcmcreator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrrozentreter%2Fdcmcreator/lists"}