annotate README @ 4403:ad646ff506d0

cont openapi
author Sebastien Jodogne <s.jodogne@gmail.com>
date Wed, 23 Dec 2020 18:32:13 +0100
parents 7822fa96f9c8
children 1f7ac929e788
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
57
4bc019d2f969 renaming
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 52
diff changeset
1 Orthanc - A Lightweight, RESTful DICOM Server
4bc019d2f969 renaming
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 52
diff changeset
2 =============================================
4bc019d2f969 renaming
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 52
diff changeset
3
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
5 General Information
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
6 -------------------
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
7
705
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 563
diff changeset
8 General information about this software can be found on its official
4131
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
9 Website, and in the Orthanc Book:
705
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 563
diff changeset
10 http://www.orthanc-server.com/
4131
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
11 http://book.orthanc-server.com/
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
12
4131
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
13 The instructions for building Orthanc can be found in the "./INSTALL"
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
14 file.
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
15
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
16
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
17 Supported Platforms
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
18 -------------------
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
19
2661
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2613
diff changeset
20 Currently, the officially validated platforms are:
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
21
2086
630606097798 GNU/Linux
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1403
diff changeset
22 * GNU/Linux (32bit and 64bit).
2661
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2613
diff changeset
23 * Windows (32bit and 64bit).
2086
630606097798 GNU/Linux
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1403
diff changeset
24 * Apple OS X (32bit and 64bit).
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
25
2661
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2613
diff changeset
26 Orthanc is known to work on other UNIX-like platforms (such as FreeBSD
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2613
diff changeset
27 and OpenBSD).
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2613
diff changeset
28
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
29
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
30 Supported Toolchains
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
31 --------------------
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
32
57
4bc019d2f969 renaming
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 52
diff changeset
33 Orthanc can currently be built using the following compiling
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
34 toolchains:
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
35
2086
630606097798 GNU/Linux
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1403
diff changeset
36 * Native GNU/Linux compilation, with gcc.
7
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 0
diff changeset
37 * Native Windows compilation, with Microsoft Visual Studio.
2086
630606097798 GNU/Linux
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1403
diff changeset
38 * Cross-compilation for Windows under GNU/Linux, with MinGW.
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
39
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
40
17
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
41 Licensing
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
42 ---------
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
43
136
fe180eae201d openssl exception
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 57
diff changeset
44 Orthanc is licensed under the GPLv3 license, with the OpenSSL
fe180eae201d openssl exception
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 57
diff changeset
45 exception:
fe180eae201d openssl exception
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 57
diff changeset
46 http://people.gnome.org/~markmc/openssl-and-the-gpl.html
fe180eae201d openssl exception
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 57
diff changeset
47
4345
7822fa96f9c8 fix travis
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4131
diff changeset
48 Full information about the licensing of the Orthanc ecosystem is
7822fa96f9c8 fix travis
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4131
diff changeset
49 available in the Orthanc Book:
7822fa96f9c8 fix travis
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4131
diff changeset
50 https://book.orthanc-server.com/faq/licensing.html
7822fa96f9c8 fix travis
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4131
diff changeset
51
1230
4f1ac0f2c39c Fix licensing terms according to FSF recommendations
s.jodogne@gmail.com
parents: 705
diff changeset
52 We also kindly ask scientific works and clinical studies that make
4f1ac0f2c39c Fix licensing terms according to FSF recommendations
s.jodogne@gmail.com
parents: 705
diff changeset
53 use of Orthanc to cite Orthanc in their associated publications.
4f1ac0f2c39c Fix licensing terms according to FSF recommendations
s.jodogne@gmail.com
parents: 705
diff changeset
54 Similarly, we ask open-source and closed-source products that make
4f1ac0f2c39c Fix licensing terms according to FSF recommendations
s.jodogne@gmail.com
parents: 705
diff changeset
55 use of Orthanc to warn us about this use. You can cite our work
4f1ac0f2c39c Fix licensing terms according to FSF recommendations
s.jodogne@gmail.com
parents: 705
diff changeset
56 using the following BibTeX entry:
17
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
57
2561
b2f57399b067 updated bibtex
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2086
diff changeset
58 @Article{Jodogne2018,
b2f57399b067 updated bibtex
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2086
diff changeset
59 author="Jodogne, S{\'e}bastien",
b2f57399b067 updated bibtex
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2086
diff changeset
60 title="The {O}rthanc Ecosystem for Medical Imaging",
b2f57399b067 updated bibtex
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2086
diff changeset
61 journal="Journal of Digital Imaging",
b2f57399b067 updated bibtex
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2086
diff changeset
62 year="2018",
2613
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2561
diff changeset
63 month="Jun",
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2561
diff changeset
64 day="01",
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2561
diff changeset
65 volume="31",
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2561
diff changeset
66 number="3",
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2561
diff changeset
67 pages="341--352",
2561
b2f57399b067 updated bibtex
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2086
diff changeset
68 issn="1618-727X",
b2f57399b067 updated bibtex
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2086
diff changeset
69 doi="10.1007/s10278-018-0082-y",
b2f57399b067 updated bibtex
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2086
diff changeset
70 url="https://doi.org/10.1007/s10278-018-0082-y"
449
694f06a84bf4 licensing notes
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 136
diff changeset
71 }
17
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
72
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
73
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
74 Licensing of special directories
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
75 --------------------------------
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
76
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
77 The following directories have separate licensing terms:
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
78
4131
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
79 * The files of the "./OrthancFramework/Sources/" directory are
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
80 licensed under the LGPLv3 (Lesser GPL) since Orthanc 1.7.2. The
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
81 related COPYING file can be found in "./OrthancFramework".
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
82
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
83 * The files of the "./OrthancFramework/Sources/SQLite/" directory are
4091
19a2f1d2b816 moved CMakeLists.txt for the server to the OrthancServer folder
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2661
diff changeset
84 licensed under the 3-clause BSD license, as they are derived from
19a2f1d2b816 moved CMakeLists.txt for the server to the OrthancServer folder
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2661
diff changeset
85 the Chromium project.
17
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
86
db4d996ea264 licensing of sqlite
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 13
diff changeset
87
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
88 Content
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
89 -------
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
90
4091
19a2f1d2b816 moved CMakeLists.txt for the server to the OrthancServer folder
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2661
diff changeset
91 This archive contains the following important directories:
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
92
4131
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
93 * ./OrthancFramework/Sources/ - The sources of the Orthanc framework
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
94 * ./OrthancFramework/UnitTestsSources/ - Unit tests of the Orthanc framework
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
95 * ./OrthancServer/OrthancExplorer/ - Code of the Orthanc Explorer (HTML5/Javascript)
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
96 * ./OrthancServer/Plugins/ - Code of the plugin framework
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
97 * ./OrthancServer/Resources/Samples/ - Samples
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
98 * ./OrthancServer/Sources/ - Code of the Orthanc server (depends on DCMTK)
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
99 * ./OrthancServer/UnitTestsSources/ - Unit tests of the Orthanc server
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
100
4091
19a2f1d2b816 moved CMakeLists.txt for the server to the OrthancServer folder
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2661
diff changeset
101 This archive contains the following important files:
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
102
4131
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
103 * ./AUTHORS - The list of the authors
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
104 * ./COPYING - The main GPLv3 license
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
105 * ./INSTALL - How to build Orthanc
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
106 * ./NEWS - The history of main changes between versions
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
107 * ./OrthancServer/CMakeLists.txt - The main build script of the Orthanc server
eea760f20ed2 Orthanc-1.7.2
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 4091
diff changeset
108 * ./README - This file
0
3959d33612cc initial commit
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
109
7
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 0
diff changeset
110 We have decided not to maintain a separate "ChangeLog" file. Each
57
4bc019d2f969 renaming
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 52
diff changeset
111 commit to the official Orthanc Mercurial repository should be
7
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 0
diff changeset
112 associated with a description of the changes.