Mercurial > hg > orthanc-book

comparison Sphinx/source/users/rest.rst @ 168:86e92d0cc53e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
information about images
author Sebastien Jodogne <s.jodogne@gmail.com>
date Fri, 12 Oct 2018 09:53:45 +0200
parents 498c9e42c99d
children 8239d44e0520
comparison
equal deleted inserted replaced
167:7ba16d90ed93 168:86e92d0cc53e
118 "Type" : "Patient" 118 "Type" : "Patient"
119 } 119 }
120 120
121 This is once again a JSON file. Note how Orthanc gives you a summary 121 This is once again a JSON file. Note how Orthanc gives you a summary
122 of the main DICOM tags that correspond to the patient level. 122 of the main DICOM tags that correspond to the patient level.
123
124
125 .. _browsing-hierarchy:
123 126
124 Browsing from the patient down to the instance 127 Browsing from the patient down to the instance
125 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 128 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
126 129
127 .. highlight:: bash 130 .. highlight:: bash
325 Downloading images 328 Downloading images
326 ^^^^^^^^^^^^^^^^^^ 329 ^^^^^^^^^^^^^^^^^^
327 330
328 .. highlight:: bash 331 .. highlight:: bash
329 332
330 It is also possible to download a preview PNG image that corresponds to some DICOM instance:: 333 As :ref:`explained above <browsing-hierarchy>`, the raw DICOM file
331 334 corresponding to a single instance can be retrieved as follows::
332 $ curl http://localhost:8042/instances/e668dcbf-8829a100-c0bd203b-41e404d9-c533f3d4/preview > Preview.png 335
333 336 $ curl http://localhost:8042/instances/609665c0-c5198aa2-8632476b-a00e0de0-e9075d94/file > Instance.dcm
334 The resulting image will be a standard graylevel PNG image that can be opened by any painting software. 337
335 338 It is also possible to download a preview PNG image that corresponds
336 339 to some DICOM instance::
340
341 $ curl http://localhost:8042/instances/609665c0-c5198aa2-8632476b-a00e0de0-e9075d94/preview > Preview.png
342
343 The resulting image will be a standard graylevel PNG image (with 8
344 bits per pixel) that can be opened by any painting software. The
345 dynamic range of the pixel data is stretched to the [0..255] range.
346 An equivalent JPEG image can be downloaded by setting the `HTTP header
347 <https://en.wikipedia.org/wiki/List_of_HTTP_header_fields>`__
348 ``Accept`` to ``image/jpeg``::
349
350 $ curl -H 'Accept: image/jpeg' http://localhost:8042/instances/609665c0-c5198aa2-8632476b-a00e0de0-e9075d94/preview > Preview.png
351
352 If you don't want to stretch the dynamic range, and create a 8bpp or
353 16bpp PNG image, you can use the following URIs::
354
355 $ curl http://localhost:8042/instances/609665c0-c5198aa2-8632476b-a00e0de0-e9075d94/image-uint8 > full-8.png
356 $ curl http://localhost:8042/instances/609665c0-c5198aa2-8632476b-a00e0de0-e9075d94/image-uint16 > full-16.png
357
358 In these images, the values are cropped to the maximal value that can
359 be encoded by the target image format. The
360 ``/instances/{...}/image-int16`` is available as well to download
361 signed DICOM pixel data.
362
363 Since Orthanc 1.4.2, it is also possible to download such images in
364 the generic `PAM format
365 <https://en.wikipedia.org/wiki/Netpbm#PAM_graphics_format>`__::
366
367 $ curl -H 'Accept: image/x-portable-arbitrarymap' http://localhost:8042/instances/609665c0-c5198aa2-8632476b-a00e0de0-e9075d94/image-uint16 > full-16.pam
368
369 Users of Matlab or Octave can find related information :ref:`in the
370 dedicated section <matlab>`.
371
372
337 .. _changes: 373 .. _changes:
338
339
340 374
341 Sending resources to remote modalities 375 Sending resources to remote modalities
342 -------------------------------------- 376 --------------------------------------
343 377
344 Orthanc can send its DICOM instances to remote DICOM modalities (C-Store SCU). This process 378 Orthanc can send its DICOM instances to remote DICOM modalities (C-Store SCU). This process