Mercurial > hg > orthanc-book
annotate Sphinx/source/users/cookbook.rst @ 660:a6e371768a70
dicom-as-json
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Thu, 29 Apr 2021 12:41:31 +0200 |
parents | a6ed2c3f2a56 |
children | d5a646b2b421 |
rev | line source |
---|---|
0 | 1 .. highlight:: bash |
2 .. _cookbook: | |
3 | |
4 Quickstart | |
5 ========== | |
6 | |
7 .. contents:: | |
8 :depth: 2 | |
9 | |
10 | |
31
93bbfaf0e62c
worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
28
diff
changeset
|
11 .. _binaries: |
28 | 12 |
0 | 13 Obtaining binaries |
14 ------------------ | |
15 | |
16 To obtain the Orthanc binaries, you have several possibilities: | |
17 | |
358
011b01ccf52d
fixing external hyperlinks
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
292
diff
changeset
|
18 * `Download pre-compiled packages <https://www.orthanc-server.com/download.php>`__. |
54
bd0fbf1f0143
docker documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
31
diff
changeset
|
19 * :ref:`Use Docker <docker>`. |
572 | 20 * On GNU/Linux, use precompiled packages for :ref:`Debian/Ubuntu |
573 | 21 <debian-packages>`, or for `openSUSE |
22 <https://software.opensuse.org/search?q=orthanc>`__ (courtesy of | |
23 Axel Braun). | |
574 | 24 * On GNU/Linux, use our `LSB binaries |
25 <https://lsb.orthanc-server.com/>`__ (Linux Standard Base), that | |
26 should easily and immediately run on most distributions. Those | |
27 binaries are statically linked together with all their third-party | |
28 dependencies. | |
292
8aa416899db4
added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
54
diff
changeset
|
29 * :ref:`Compile Orthanc by yourself <compiling>`. |
26 | 30 * External contributors are also maintaining `Vagrant VM for Orthanc |
358
011b01ccf52d
fixing external hyperlinks
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
292
diff
changeset
|
31 <https://github.com/jodogne/OrthancContributed/blob/master/Links.md#user-content-vagrant>`__. |
0 | 32 |
33 | |
34 .. _orthanc-explorer: | |
35 | |
36 Opening Orthanc Explorer | |
37 ------------------------ | |
38 | |
39 The most straightforward way to use Orthanc consists in opening | |
40 **Orthanc Explorer**, the embedded administrative interface of | |
41 Orthanc, with a Web browser. Once Orthanc is running, open the | |
42 following URL: http://localhost:8042/app/explorer.html. Please note | |
43 that: | |
44 | |
45 * The port number 8042 depends on your :ref:`configuration | |
46 <configuration>`. | |
47 * Orthanc Explorer does not work with Microsoft Internet | |
48 Explorer. Please use Mozilla Firefox, Google Chrome, Apple Safari, | |
49 or `any WebKit-based Web browser <https://en.wikipedia.org/wiki/WebKit>`__. | |
50 | |
51 | |
52 Uploading DICOM files | |
53 --------------------- | |
54 | |
55 The Orthanc Explorer interface contains a user-friendly page to upload | |
56 DICOM files. You can reach the upload page at | |
57 http://localhost:8042/app/explorer.html#upload. Then, you can drag and | |
58 drop your DICOM files and click on the Upload button. | |
59 | |
60 You can `watch this video tutorial | |
61 <https://www.youtube.com/watch?v=4dOcXGMlcFo&hd=1>`__ that shows how | |
26 | 62 to upload files to Orthanc through Orthanc Explorer with Chromium. |
63 | |
64 **Important:** There is currently a `known issue | |
445
987fbbc2b59e
leaving bitbucket wrt. bug tracker
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
358
diff
changeset
|
65 <https://bugs.orthanc-server.com/show_bug.cgi?id=21>`__ that might |
987fbbc2b59e
leaving bitbucket wrt. bug tracker
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
358
diff
changeset
|
66 prevent Mozilla Firefox to correctly upload all DICOM files if using |
987fbbc2b59e
leaving bitbucket wrt. bug tracker
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
358
diff
changeset
|
67 drag-and-drop. |
0 | 68 |
69 | |
70 Uploading through the DICOM protocol | |
71 ------------------------------------ | |
72 | |
73 Once Orthanc is up and running, any imaging modality can send | |
74 instances to Orthanc through the DICOM protocol (with the C-Store | |
292
8aa416899db4
added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
54
diff
changeset
|
75 command). Check :ref:`this tutorial <configure-modality>` to |
8aa416899db4
added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
54
diff
changeset
|
76 connect your modality to Orthanc. |
0 | 77 |
292
8aa416899db4
added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
54
diff
changeset
|
78 You can also use the standard command-line tool ``storescu`` from the |
358
011b01ccf52d
fixing external hyperlinks
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
292
diff
changeset
|
79 `DCMTK software <https://dicom.offis.de/dcmtk.php.en>`__ to manually |
011b01ccf52d
fixing external hyperlinks
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
292
diff
changeset
|
80 send DICOM images to Orthanc, for instance:: |
0 | 81 |
82 $ storescu -aec ORTHANC localhost 4242 *.dcm | |
83 | |
84 will send all the files with ".dcm" extension to the instance of | |
85 Orthanc that is running on the ``localhost``, whose application entity | |
86 title (AET) is ``ORTHANC``, and whose DICOM port is | |
87 ``4242``. Obviously, all these parameters depend on your | |
88 :ref:`configuration <configuration>`. Please check the :ref:`FAQ | |
89 <dicom>` if you encounter any problem. | |
90 | |
91 | |
92 Next steps | |
93 ---------- | |
94 | |
95 1. Read the general introduction ":ref:`dicom-guide`". | |
96 2. Have a look at your :ref:`configuration file <configuration>`. | |
97 3. Drive Orthanc through its :ref:`REST API <rest>`. | |
98 4. Automate DICOM tasks with :ref:`Lua scripts <lua>`. | |
99 |