معرفی شرکت ها
dicom-parser-1.2.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
DICOM files parser meant to facilitate data access.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | dicom-parser-1.2.3 |
| نام | dicom-parser |
| نسخه کتابخانه | 1.2.3 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Zvi Baratz |
| ایمیل نویسنده | z.baratz@gmail.com |
| آدرس صفحه اصلی | https://github.com/ZviBaratz/dicom_parser |
| آدرس اینترنتی | https://pypi.org/project/dicom-parser/ |
| مجوز | MIT |
# dicom_parser
| Documentation | [](http://dicom-parser.readthedocs.io/?badge=latest) |
|:---:|:---|
| Code | [](https://www.python.org/) [](https://github.com/psf/black) [](https://pycqa.github.io/isort/)<br />[](https://github.com/pre-commit/pre-commit) |
| Testing | [](https://github.com/open-dicom/dicom_parser/actions/workflows/tests.yml) [](https://codecov.io/github/open-dicom/dicom_parser?branch=main)<br />[](https://www.codacy.com/gh/open-dicom/dicom_parser/dashboard?utm_source=github.com&utm_medium=referral&utm_content=open-dicom/dicom_parser&utm_campaign=Badge_Grade)[](https://lgtm.com/projects/g/open-dicom/dicom_parser/context:python)<br />[](https://libraries.io/github/open-dicom/dicom_parser) |
| Packaging | [](https://pypi.python.org/pypi/dicom-parser/) [](https://pypi.python.org/pypi/dicom-parser/) [](https://pypi.org/project/dicom-parser)<br />[](https://pypi.org/project/dicom-parser) [](https://pypi.org/project/dicom-parser) |
| Usage | [](https://github.com/open-dicom/dicom_parser/blob/main/LICENSE) [](https://zenodo.org/badge/latestdoi/241392223) [](https://pypi.python.org/pypi/ansicolortags/) |
*dicom_parser* is a utility python package meant to facilitate access to
[DICOM](https://www.dicomstandard.org/) header information by extending the
functionality of *[pydicom][]*.
Essentially, *dicom_parser* uses DICOM's
[data-element](https://northstar-www.dartmouth.edu/doc/idl/html_6.2/DICOM_Attributes.html)
[value-representation (VR)](http://dicom.nema.org/medical/dicom/current/output/chtml/part05/sect_6.2.html),
as well as prior knowledge on vendor-specific private tags or encoding schemes,
in order to transform them to more "pythonic" data structures when possible.
* [Installation](#installation)
* [Quickstart](#quickstart)
* [Documentation](#documentation)
* [Tests](#tests)
For more information, please see [the documentation site][].
---
## Installation
To install the latest stable release of `dicom_parser`, simply run:
```bash
pip install dicom_parser
```
Or, to install the latest development version:
```bash
pip install https://github.com/open-dicom/dicom_parser/archive/main.zip
```
---
## Quickstart
The most basic usage case is reading a single DICOM image (*.dcm* file) as
an [Image](https://dicom-parser.readthedocs.io/en/latest/modules/dicom_parser.html#dicom_parser.image.Image)
instance.
```python
>>> from dicom_parser import Image
>>> image = Image('/path/to/dicom/file.dcm')
```
### Coversion to Python's native types
*dicom_parser* provides *dict*-like access to the parsed values of the
[header](https://dcm4che.atlassian.net/wiki/spaces/d2/pages/1835038/A+Very+Basic+DICOM+Introduction)'s
data-elements. The raw values as read by *[pydicom][]* remain accessible
through the *raw* attribute.
#### Examples
Decimal String (DS) to *float* using the [`Header`][header] class's
[get](https://dicom-parser.readthedocs.io/en/latest/modules/dicom_parser.html#dicom_parser.header.Header.get)
method:
```python
>>> raw_value = image.header.raw['ImagingFrequency'].value
>>> raw_value
"123.25993"
>>> type(raw_value)
str
>>> parsed_value = image.header.get('ImagingFrequency')
>>> parsed_value
123.25993
>>> type(parsed_value)
float
```
Age String (AS) to *float*:
```python
>>> raw_value = image.header.raw['PatientAge'].value
>>> raw_value
"027Y"
>>> type(raw_value)
str
>>> parsed_value = image.header.get('PatientAge')
>>> parsed_value
27.0
>>> type(parsed_value)
float
```
Date String (DA) to [`datetime.date`][datetime.date] using the
[`Header`][header] class's indexing operator/subscript notation:
```python
>>> raw_value = image.header.raw['PatientBirthDate'].value
>>> raw_value
"19901214"
>>> type(raw_value)
str
>>> parsed_value = image.header['PatientBirthDate']
>>> parsed_value
datetime.date(1990, 12, 14)
>>> type(parsed_value)
datetime.date
```
Code String (CS) to a verbose value or set of values:
```python
>>> raw_value = image.header.raw['SequenceVariant'].value
>>> raw_value
['SP', 'OSP']
>>> type(raw_value)
pydicom.multival.MultiValue
>>> parsed_value = image.header['SequenceVariant']
>>> parsed_value
{'Oversampling Phase', 'Spoiled'}
>>> type(parsed_value)
set
```
Et cetera.
> The *dict*-like functionality also includes safe getting:
>
> ```python
> >>> image.header.get('MissingKey')
> None
> >>> image.header.get('MissingKey', 'DefaultValue')
> 'DefaultValue'
> ```
>
> As well as raising a KeyError for missing keys with the indexing operator:
>
> ```python
> >>> image.header['MissingKey']
> KeyError: "The keyword: 'MissingKey' does not exist in the header!"
> ```
### Read DICOM series directory as a `Series`
Another useful class this package offers is the `Series` class:
```python
>>> from dicom_parser import Series
>>> series = Series('/some/dicom/series/')
```
The `Series` instance allows us to easily query the underlying images' headers
using its `get` method:
```python
# Single value
>>> series.get('EchoTime')
3.04
# Multiple values
>>> series.get('InstanceNumber')
[1, 2, 3]
# No value
>>> series.get('MissingKey')
None
# Default value
>>> series.get('MissingKey', 'default_value')
'default_value'
```
Similarly to the `Image` class, we can also use the indexing operator:
```python
# Single value
>>> series['RepetitionTime']
7.6
# Multiple values
>>> series['SOPInstanceUID']
["1.123.1241.123124124.12.1",
"1.123.1241.123124124.12.2",
"1.123.1241.123124124.12.3"]
# No value
>>> series['MissingKey']
KeyError: "The keyword: 'MissingKey' does not exist in the header!"
```
Another useful feature of the indexing operator is for querying an `Image`
instance based on its index in the series:
```python
>>> series[6]
dicom_parser.image.Image
>>> series[6].header['InstanceNumber]
7 # InstanceNumber is 1-indexed
```
The `data` property returns a stacked volume of the images' data:
```python
>>> type(series.data)
numpy.ndarray
>>> series.data.shape
(224, 224, 208)
```
#### Siemens 4D data
Reading Siemens 4D data
[encoded as mosaics](https://nipy.org/nibabel/dicom/dicom_mosaic.html)
is also supported:
```python
>>> fmri_series = Series('/path/to/dicom/fmri/')
>>> fmri_series.data.shape
(96, 96, 64, 200)
```
---
## Documentation
### Dependencies
The [documentation site][the documentation site] is built using
[Sphinx][sphinx], to build the HTML pages locally, make sure you
have the required dependencies by using the *docs* modifier for
the installation. Assuming you have cloned the repository and
created a virtual environment, run:
```bash
pip install -e .[docs]
```
from within your cloned project's root.
### Build
Build the site by running:
```bash
make html
```
from within the *\<root\>/docs/* directory.
The generated HTML will be found under *\<root\>/docs/_build/html*. Open
*index.html* in your browser to view the site.
---
## Tests
### Dependencies
Tests are executed using [pytest][] and [tox][], and coverage is measured using
the [coverage][] package. Make sure you have the required dependencies by
using the *test* modifier for the installation. Assuming you have cloned the
repository and created a virtual environment, run:
```bash
pip install -e .[test]
```
from within your cloned project's root.
### Execution
#### pytest
To run the tests within your virtual environment, run:
```bash
pytest tests
```
#### tox
To run the tests in a number of dedicated virtual environments, simply execute
the `tox` command from within the project's root directory. This will test all
supported Python versions, and therefore will only be successful in an
environment in which all supported Python versions are installed.
Use `tox -p` to run the tests in parallel, and `tox -e py3?,py3?` to run a
subset of environments (replace `?` with the desired version number).
### Coverage
To check code coverage using `coverage`, simply run:
```bash
coverage run && coverage html
```
Open *\<root\>/htmlcov/index.html* in the browser to view the report.
[coverage]: https://coverage.readthedocs.io/
[datetime.date]: https://docs.python.org/3/library/datetime.html#available-types
[header]: https://dicom-parser.readthedocs.io/en/latest/modules/dicom_parser.html#dicom_parser.header.Header
[pydicom]: https://pydicom.github.io/
[pytest]: https://docs.pytest.org/
[sphinx]: https://www.sphinx-doc.org/en/master/
[the documentation site]: http://dicom-parser.readthedocs.io/?badge=latest
[tox]: https://tox.readthedocs.io/
نیازمندی
| مقدار | نام |
|---|---|
| <2.4,>=2.1 | pydicom |
| - | numpy |
| ~=1.21 | numpy |
| ~=22.1 | black |
| ~=0.10 | doc8 |
| ~=4.0 | flake8 |
| - | ipython |
| ~=5.10 | isort |
| - | pre-commit |
| - | pre-commit-hooks |
| ~=4.4 | sphinx |
| ~=1.0 | sphinx-rtd-theme |
| >=6.2 | coverage[toml] |
| ~=7.0 | pytest |
| ~=3.24 | tox |
| - | build |
| - | twine |
| - | jinja2 |
| - | pandas |
| ~=0.4 | python-magic |
| ~=0.0 | pickle5 |
| ~=22.1 | black |
| ~=0.10 | doc8 |
| ~=4.0 | flake8 |
| - | ipython |
| ~=5.10 | isort |
| - | pre-commit |
| - | pre-commit-hooks |
| ~=4.4 | sphinx |
| ~=1.0 | sphinx-rtd-theme |
| >=6.2 | coverage[toml] |
| ~=7.0 | pytest |
| ~=3.24 | tox |
| ~=0.4 | python-magic |
| ~=0.0 | pickle5 |
| - | build |
| - | twine |
| ~=4.4 | sphinx |
| ~=1.0 | sphinx-rtd-theme |
| ~=0.4 | python-magic |
| - | jinja2 |
| - | pandas |
| >=6.2 | coverage[toml] |
| ~=7.0 | pytest |
| ~=3.24 | tox |
| ~=0.4 | python-magic |
| ~=0.0 | pickle5 |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| <4,>=3.6 | Python |
نحوه نصب
نصب پکیج whl dicom-parser-1.2.3:
pip install dicom-parser-1.2.3.whl
نصب پکیج tar.gz dicom-parser-1.2.3:
pip install dicom-parser-1.2.3.tar.gz