Sante DICOM Editor

Run the program from the command line

General syntax

<program> [input] [switches] [parameters]
e.g.: "Sante DICOM Editor64.exe" -f "C:\DICOM Images" --i jpeg
If a path or value contains spaces, enclose it in quotes.

Open a DICOM file, DICOMDIR or folder without switches

These commands open the user interface, but they do not use switches.

Open a DICOM file:
Command: <program> <DICOM file's full path>
e.g.: "Sante DICOM Editor64.exe" "C:\DICOM Images\CT - Aura CT - Secura\S2IM01.DCM"

Open a DICOMDIR file:
Command: <program> <DICOMDIR's full path>
e.g.: "Sante DICOM Editor64.exe" "C:\DICOM Images\CT - Aura CT - Secura\DICOMDIR"

Open a folder:
Command: <program> <folder's full path>
e.g.: "Sante DICOM Editor64.exe" "C:\DICOM Images\CT - Aura CT - Secura"
The program displays a dialog box that allows the user to select one or more studies/series to open.

Terminate the program.

command: <program> -stop
e.g.: "Sante DICOM Editor64.exe" -stop
This command terminates the program.

Command Line Switches

This topic describes the command line switches of Sante DICOM Editor.
The switches are separated into two groups: switches that open the user interface, and switches that run without opening the user interface.
With the switches that run without opening the user interface, the program operates as a command-line utility:
it does not load the user interface, executes the command specified by the switch, and then terminates.

Table of Switches

Open images from the database

1) Query, retrieve and open the studies of a specific patient name
command: <program> -P <patient name>
e.g.: "Sante DICOM Editor64.exe" -P "JOHN SMITH"
(if the patient name contains spaces use quotes, like the example).
In that case the program will open the studies of the patient with name JOHN SMITH

2) Query, retrieve and open the studies of a specific patient ID
command: <program> -I <patient ID>
e.g.: "Sante DICOM Editor64.exe" -I 009871845
In that case the program will open the studies of the patient with ID 009871845
3) Query, retrieve and open the studies of a specific accession number
command: <program> -N <accession number>
e.g.: "Sante DICOM Editor64.exe" -N 145
In that case the program will open the studies of the accession number 145

4) Query, retrieve and open the studies of a specific Study UID
command: <program> -S <study uid>
e.g.: "Sante DICOM Editor64.exe" -S 1.3.46.670589.10.1.1.215843
In that case the program will open the studies of the Study UID 1.3.46.670589.10.1.1.215843

5) Query, retrieve and open the studies of a specific Series UID
command: <program> -R <series uid>
e.g.: "Sante DICOM Editor64.exe" -R 1.3.46.670589.10.1.1.215842
In that case the program will open the studies of the Series UID 1.3.46.670589.10.1.1.215842

Integration with PACS Servers (query, retrieve and open studies from a DICOM Server)

Note: Before using the PACS query/retrieve switches, configure the network settings.
The AE Title, IP address and port of the DICOM Server must be known to the application.
If the received studies or series should open automatically, enable the option Open study/series when received in the network pane.

1) Query, retrieve and open the studies of a specific patient name from a DICOM Server with a specific AE Title
command: <program> -a <ae title> -p <patient name>
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -p "JOHN SMITH"
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -P "JOHN SMITH"
(if the patient name contains spaces use quotes, like the example).

In that case the program will query, retrieve and open the studies of the patient with name JOHN SMITH from the DICOM Server with AE Title SANTESRV1

If the uppercase switch -P is used, the program first queries the database of the program and if it does not find any result then it queries the remote server.
If the lowercase switch -p is used, the program queries only the remote server.

2) Query, retrieve and open the studies of a specific patient ID from a DICOM Server with a specific AE Title
command: <program> -a <ae title> -i <patient ID>
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -i 009871845
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -I 009871845

In that case the program will query, retrieve and open the studies of the patient with ID 009871845 from the DICOM Server with AE Title SANTESRV1

If the uppercase switch -I is used, the program first queries the database of the program and if it does not find any result then it queries the remote server.
If the lowercase switch -i is used, the program queries only the remote server.

3) Query, retrieve and open the studies of a specific accession number from a DICOM Server with a specific AE Title
command: <program> -a <ae title> -n <accession number>
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -n 145
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -N 145

In that case the program will query, retrieve and open the studies of the accession number 145 from the DICOM Server with AE Title SANTESRV1

If the uppercase switch -n is used, the program first queries the database of the program and if it does not find any result then it queries the remote server.
If the lowercase switch -n is used, the program queries only the remote server.

4) Query, retrieve and open the studies of a specific Study UID from a DICOM Server with a specific AE Title
command: <program> -a <ae title> -s <study uid>
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -s 1.3.46.670589.10.1.1.215843
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -S 1.3.46.670589.10.1.1.215843

In that case the program will query, retrieve and open the studies of the Study UID 1.3.46.670589.10.1.1.215843 from the DICOM Server with AE Title SANTESRV1

If the uppercase switch -S is used, the program first queries the database of the program and if it does not find any result then it queries the remote server.
If the lowercase switch -s is used, the program queries only the remote server.

5) Query, retrieve and open the studies of a specific Series UID from a DICOM Server with a specific AE Title
command: <program> -a <ae title> -r <series uid>
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -r 1.3.46.670589.10.1.1.215842
e.g.: "Sante DICOM Editor64.exe" -a SANTESRV1 -R 1.3.46.670589.10.1.1.215842

In that case the program will query, retrieve and open the studies of the Series UID 1.3.46.670589.10.1.1.215842 from the DICOM Server with AE Title SANTESRV1

If the uppercase switch -R is used, the program first queries the database of the program and if it does not find any result then it queries the remote server.
If the lowercase switch -r is used, the program queries only the remote server.

Use the C-GET service for file transfers

The program by default uses the C-MOVE/C-STORE for file transfers. For C-GET transfers, the switch -g (without parameters) must be used. e.g.:
"Sante DICOM Editor64.exe" -a SANTESRV1 -p "JOHN SMITH" -g
"Sante DICOM Editor64.exe" -a SANTESRV1 -i 009871845 -g
"Sante DICOM Editor64.exe" -a SANTESRV1 -n 145 -g
"Sante DICOM Editor64.exe" -a SANTESRV1 -s 1.3.46.670589.10.1.1.215843 -g
"Sante DICOM Editor64.exe" -a SANTESRV1 -r 1.3.46.670589.10.1.1.215842 -g

Switches that do not open the user interface

These switches are intended for command line operations, batch processing, conversion, information output, or program control.

Create anonymized DICOM files and save them with different names

Command: <program> -f <folder or file> --a <parameter>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --a parameterfile.txt
Back to Table of Switches

Create anonymized DICOM files and replace the original files

Command: <program> -f <folder or file> --A <parameter>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --A parameterfile.txt
Back to Table of Switches

Create big endian DICOM files from little endian files and save them with different names

Command: <program> -f <folder or file> --b
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --b
Back to Table of Switches

Create big endian DICOM files from little endian files and replace the original files

Command: <program> -f <folder or file> --B
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --B
Back to Table of Switches

Display version and copyright information in the command line window

Command: <program> -f <folder or file> --c
e.g.: "Sante DICOM Editor64.exe" --c
Back to Table of Switches

Create a DICOMDIR and save it in the selected folder

Command: <program> -f <folder or file> --d
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --d
Back to Table of Switches

Create a DICOMDIR and save it in the parent folder

Command: <program> -f <folder or file> --D
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --D
Back to Table of Switches

Convert DICOM files to WMV and burn in image header information

Command: <program> -f <folder or file> --e <parameter>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --e
Back to Table of Switches

Convert DICOM files to WMV

Command: <program> -f <folder or file> --E <parameter>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --E
Back to Table of Switches

Display help text in the command line window

Command: <program> -f <folder or file> --h
e.g.: "Sante DICOM Editor64.exe" --h
Back to Table of Switches

Convert DICOM files to image format (jpeg,jpeg2000,bmp,tiff,png) and burn in image header information

Command: <program> -f <folder or file> --i <parameter>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --i jpeg
Back to Table of Switches

Convert DICOM files to image format (jpeg,jpeg2000,bmp,tiff,png)

Command: <program> -f <folder or file> --I <parameter>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --I jpeg
Back to Table of Switches

Merge many single-frame DICOM files to one multi-frame DICOM file

Command: <program> -f <folder or file> --j
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --j
Back to Table of Switches

Create little endian DICOM files from big endian files and save them with different names

Command: <program> -f <folder or file> --l
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --l
Back to Table of Switches

Create little endian DICOM files from big endian files and replace the original files

Command: <program> -f <folder or file> --L
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --L
Back to Table of Switches

Create modified DICOM files and save them with different names

Command: <program> -f <folder or file> --m <parameter>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --m parameterfile.txt
Back to Table of Switches

Create modified DICOM files and replace the original files

Command: <program> -f <folder or file> --M <parameter>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --M parameterfile.txt
Back to Table of Switches

Create NEMA2 files from DICOM 3 Part 10 files and save them with different names

Command: <program> -f <folder or file> --n
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --n
Back to Table of Switches

Create NEMA2 files from DICOM 3 Part 10 files and replace the original files

Command: <program> -f <folder or file> --N
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --N
Back to Table of Switches

Create DICOM 3 Part 10 files from NEMA2 files and save them with different names

Command: <program> -f <folder or file> --p
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --p
Back to Table of Switches

Create DICOM 3 Part 10 files from NEMA2 files and replace the original files

Command: <program> -f <folder or file> --P
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --P
Back to Table of Switches

Display registration information in the command line window

Command: <program> -f <folder or file> --r
e.g.: "Sante DICOM Editor64.exe" --r
Back to Table of Switches

Split multi-frame DICOM files to many single-frame DICOM files

Command: <program> -f <folder or file> --s
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --s
Back to Table of Switches

Export the header of every DICOM file in a folder to a text file

Command: <program> -f <folder or file> --t
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --t
Back to Table of Switches

Create uncompressed DICOM files from compressed files and save them with different names

Command: <program> -f <folder or file> --u
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --u
Back to Table of Switches

Create uncompressed DICOM files from compressed files and replace the original files

Command: <program> -f <folder or file> --U
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --U
Back to Table of Switches

Create compressed DICOM files from video files in a folder

Command: <program> -f <folder or file> --v
e.g.: "Sante DICOM Editor64.exe" -f C:\Video_Files --v
Back to Table of Switches

Create a DICOM file for every image file in a folder

Command: <program> -f <folder or file> --w
e.g.: "Sante DICOM Editor64.exe" -f C:\Image_Files --w
Back to Table of Switches

Create a single multi-frame DICOM file that contains all images of a folder

Command: <program> -f <folder or file> --W
e.g.: "Sante DICOM Editor64.exe" -f C:\Image_Files --W
Back to Table of Switches

Create JPEG lossless compressed DICOM files and save them with different names

Command: <program> -f <folder or file> --x
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --x
Back to Table of Switches

Create JPEG lossless compressed DICOM files and replace the original files

Command: <program> -f <folder or file> --X
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --X
Back to Table of Switches

Create DICOM files with modified UIDs and save them with different names

Command: <program> -f <folder or file> --y
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --y
Back to Table of Switches

Create DICOM files with modified UIDs and replace the original files

Command: <program> -f <folder or file> --Y
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --Y
Back to Table of Switches

Create JPEG lossy compressed DICOM files and save them with different names

Command: <program> -f <folder or file> --z <parameter> -q <file quality (1-100)>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --z -q 75
Back to Table of Switches

Create JPEG lossy compressed DICOM files and replace the original files

Command: <program> -f <folder or file> --Z <parameter> -q <file quality (1-100)>
e.g.: "Sante DICOM Editor64.exe" -f C:\Dicom_Images --Z -q 75
Back to Table of Switches