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