|
0
|
1 .. highlight:: bash
|
|
|
2 .. _cookbook:
|
|
|
3
|
|
|
4 Quickstart
|
|
|
5 ==========
|
|
|
6
|
|
|
7 .. contents::
|
|
|
8 :depth: 2
|
|
|
9
|
|
|
10
|
|
|
11 Obtaining binaries
|
|
|
12 ------------------
|
|
|
13
|
|
|
14 To obtain the Orthanc binaries, you have several possibilities:
|
|
|
15
|
|
|
16 * :ref:`Compile Orthanc by yourself <compiling>`.
|
|
|
17 * `Download pre-compiled packages <http://www.orthanc-server.com/download.php>`__.
|
|
26
|
18 * `Use Docker <https://github.com/jodogne/OrthancDocker>`__.
|
|
|
19 * External contributors are also maintaining `Vagrant VM for Orthanc
|
|
|
20 <https://github.com/jodogne/OrthancContributed/blob/master/Links.md#vagrant>`__.
|
|
0
|
21
|
|
|
22
|
|
|
23 .. _orthanc-explorer:
|
|
|
24
|
|
|
25 Opening Orthanc Explorer
|
|
|
26 ------------------------
|
|
|
27
|
|
|
28 The most straightforward way to use Orthanc consists in opening
|
|
|
29 **Orthanc Explorer**, the embedded administrative interface of
|
|
|
30 Orthanc, with a Web browser. Once Orthanc is running, open the
|
|
|
31 following URL: http://localhost:8042/app/explorer.html. Please note
|
|
|
32 that:
|
|
|
33
|
|
|
34 * The port number 8042 depends on your :ref:`configuration
|
|
|
35 <configuration>`.
|
|
|
36 * Orthanc Explorer does not work with Microsoft Internet
|
|
|
37 Explorer. Please use Mozilla Firefox, Google Chrome, Apple Safari,
|
|
|
38 or `any WebKit-based Web browser <https://en.wikipedia.org/wiki/WebKit>`__.
|
|
|
39
|
|
|
40
|
|
|
41 Uploading DICOM files
|
|
|
42 ---------------------
|
|
|
43
|
|
|
44 The Orthanc Explorer interface contains a user-friendly page to upload
|
|
|
45 DICOM files. You can reach the upload page at
|
|
|
46 http://localhost:8042/app/explorer.html#upload. Then, you can drag and
|
|
|
47 drop your DICOM files and click on the Upload button.
|
|
|
48
|
|
|
49 You can `watch this video tutorial
|
|
|
50 <https://www.youtube.com/watch?v=4dOcXGMlcFo&hd=1>`__ that shows how
|
|
26
|
51 to upload files to Orthanc through Orthanc Explorer with Chromium.
|
|
|
52
|
|
|
53 **Important:** There is currently a `known issue
|
|
|
54 <https://bitbucket.org/sjodogne/orthanc/issues/21/dicom-files-missing-after-uploading-with>`__
|
|
|
55 that prevents Mozilla Firefox to correctly upload all DICOM files.
|
|
0
|
56
|
|
|
57
|
|
|
58 Uploading through the DICOM protocol
|
|
|
59 ------------------------------------
|
|
|
60
|
|
|
61 Once Orthanc is up and running, any imaging modality can send
|
|
|
62 instances to Orthanc through the DICOM protocol (with the C-Store
|
|
|
63 command).
|
|
|
64
|
|
|
65 You can use the standard command-line tool ``storescu`` from the
|
|
|
66 `DCMTK software <http://dicom.offis.de/dcmtk.php.en>`__ to
|
|
|
67 manually send DICOM images to Orthanc, for instance::
|
|
|
68
|
|
|
69 $ storescu -aec ORTHANC localhost 4242 *.dcm
|
|
|
70
|
|
|
71 will send all the files with ".dcm" extension to the instance of
|
|
|
72 Orthanc that is running on the ``localhost``, whose application entity
|
|
|
73 title (AET) is ``ORTHANC``, and whose DICOM port is
|
|
|
74 ``4242``. Obviously, all these parameters depend on your
|
|
|
75 :ref:`configuration <configuration>`. Please check the :ref:`FAQ
|
|
|
76 <dicom>` if you encounter any problem.
|
|
|
77
|
|
|
78
|
|
|
79 Next steps
|
|
|
80 ----------
|
|
|
81
|
|
|
82 1. Read the general introduction ":ref:`dicom-guide`".
|
|
|
83 2. Have a look at your :ref:`configuration file <configuration>`.
|
|
|
84 3. Drive Orthanc through its :ref:`REST API <rest>`.
|
|
|
85 4. Automate DICOM tasks with :ref:`Lua scripts <lua>`.
|
|
|
86
|
