query_series
Query DICOM series within a study using C-FIND. Filter by modality, series number, or description to locate specific series.
Instructions
Query series within a study from the DICOM node.
This tool performs a DICOM C-FIND operation at the SERIES level to find series within a specified study. The study_instance_uid is required, and additional parameters can be used to filter the results.
Args: study_instance_uid: Unique identifier for the study (required) modality: Filter by imaging modality, e.g., "CT", "MR", "US", "CR" series_number: Filter by series number series_description: Series description text with wildcards. IMPORTANT: Use wildcards on BOTH sides for substring matching, e.g., "AXIAL" to find "AXIAL 2.5MM RECON". Using "AXIAL*" only matches descriptions starting with "AXIAL". series_instance_uid: Unique identifier for a specific series limit: Maximum number of results to return (None = no limit) attribute_preset: Controls which attributes to include in results: - "none": No attributes, use with additional_attributes (default) - "custom": Our custom attributes additional_attributes: List of specific DICOM attributes to include beyond the preset exclude_attributes: List of DICOM attributes to exclude from the results
Returns: Dictionary containing query results and status metadata. The results list includes entries like: { "SeriesInstanceUID": "1.2.840.113619.2.1.1.322.1600364094.412.2005", "SeriesNumber": "2", "SeriesDescription": "AXIAL 2.5MM", "Modality": "CT", "NumberOfSeriesRelatedInstances": "120" }
Notes: Returns success False if the query fails.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| study_instance_uid | Yes | ||
| modality | No | ||
| series_number | No | ||
| series_description | No | ||
| series_instance_uid | No | ||
| limit | No | ||
| attribute_preset | No | none | |
| additional_attributes | No | ||
| exclude_attributes | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |