Mercurial > hg > orthanc-book

annotate Sphinx/source/integrations/modality.rst @ 292:8aa416899db4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
added a tuto to connect a modality to Orthanc
author Alain Mazy <alain@mazy.be>
date Mon, 16 Dec 2019 10:09:42 +0100
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
292
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
1 .. _configure-modality:
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
2 .. highlight:: json
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
3
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
4
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
5 Connect your modality to Orthanc
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
6 ================================
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
7
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
8 This section explains how to connect a modality to an Orthanc server.
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
9
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
10 First, retrieve the IP address of your Orthanc Server. Make sure
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
11 to retrieve the IP address of the correct network interface
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
12 (in this case ``123.124.125.126``).
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
13 You should also make sure that your firewall enables incoming traffic
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
14 on the DICOM port for that network interface (``4242`` by default).
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
15
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
16 Then, start Orthanc without specifying a
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
17 configuration file (i.e. using its default configuration). On your modality,
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
18 search for "settings/network settings" (exact naming is platform dependent).
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
19 You should find this kind of information
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
20
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
21 .. image:: ../images/ConfigureModality1.png
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
22 :align: center
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
23 :width: 500px
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
24
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
25
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
26 Write down the AET, IP and DICOM port of the modality (in this case,
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
27 respectively ``ECHO1``, ``123.124.125.10`` and ``104``).
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
28
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
29 Then, still in your modality network settings, you should find a panel
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
30 in which you can configure a PACS or a target DICOM Server. Enter
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
31 the following information (adapt it with the IP address of your
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
32 Orthanc Server):
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
33
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
34 .. image:: ../images/ConfigureModality2.png
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
35 :align: center
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
36 :width: 500px
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
37
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
38
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
39 Once you've entered this configuration in your modality, you might
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
40 have access to a "*Test connection/C-ECHO*" button to validate that
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
41 the modality can reach the Orthanc Server.
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
42
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
43 Then, stop Orthanc, update you :ref:`configuration file
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
44 <configuration>`, and declare your modality in the ``DicomModalities``
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
45 section, given the parameters you wrote down above::
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
46
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
47 // The list of the known DICOM modalities
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
48 "DicomModalities" : {
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
49 "echo1" : [ "ECHO1", "123.124.125.10", 104 ]
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
50 },
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
51
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
52 Restart Orthanc using this newly created configuration file, and
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
53 you will be able to send data from your modality to your Orthanc Server.
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
54
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
55 Further readings:
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
56
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
57 * :ref:`dicom`
8aa416899db4 added a tuto to connect a modality to Orthanc
Alain Mazy <alain@mazy.be>
parents:
diff changeset
58 * :ref:`troubleshooting`