Help online
 
  Main top toolbar
  Main bottom toolbar
  File manager
  Database
  Dropbox
  Measurement toolbar
  Image Processing toolbar
 
Histogram view
Filters view
Graph tools view
Video view
  DICOM network services
 
Networks Settings view
Echo view
Send Files view
Receive Files view
Query/Retrieve view
URL scheme
  Web browser
  Recognized gestures
   
   
Main top toolbar
Shows the file manager view, with it you can open or manage images or import files from web browser or from Dropbox storage.
Shows the database view, with it you can view and open the archived files in the classical hierarchy patient/study/series/images.
Opens previous image presents in the same folder or database search.
Opens next image presents in the same folder or database search.
Displays the zoom percentage, one tap on it sets the actual size of image.
Shows/hides a left side toolbar that allows you to change the image window center (brightness). This contains a slider control, a plus button and minus button that allow you to make changes with greater sensitivity, and a padlock button that allows you to block the brightness (if closed) when switching between images.
Shows/hides a right side toolbar that allows you to change the image window width (contrast). This contains a slider control, a plus button and minus button that allow you to make changes with greater sensitivity, and a padlock button that allows you to block (if closed) the contrast when switching between images.
Resets the default values of the image, such as window center and window width.
Saves the current frame as JPEG or PNG image, this can be chosen in the application preference.
Prepares an email with attached the current frame as image, some parameters of this email can be set in application preference.
Shows the header of DICOM image currently displayed.
Shows the main DICOM attributes in the order patient / study / series / image.
Shows/hides the measurements toolbar.
Shows/hides the image processing toolbar.
This button indicator show if there are files in downloading or in uploading, one tap show a view with downloaded files. The down arrow is highlighted if there are files in downloading, the up arrow is highlighted if there are files in uploading.
Shows this Help file.
   

Main bottom toolbar
Shows the current frame/total frames for a multiframes image. One tap on it shows a view with enumerated frames, you can select one to see.
Shows the current file/total files present in the same folder. One tap on it shows a view with enumerated files, you can select one to open it.

In slideshow between frames displays the first frame of the image. In slideshow between files displays first file presents in the folder.

In slideshow between frames displays the previous frame of the image. In slideshow between files displays previous file presents in the folder.

Pauses slideshow playback.
Slideshow playback.
In slideshow between frames displays the next frame of the image. In slideshow between files displays next file presents in the folder.
In slideshow between frames displays the last frame of the image. In slideshow between files displays last file presents in the folder.
Slider control to switch quickly between frames or files.
Shows buttons or slider control.
  Double state button, one tap to change the state. When the first icon is displayed then slideshow between frames is active, however when the second icon is displayed then slideshow between files is active.
   
  back to index

File manager
In this view you can manage all your DICOM files through the use of a simple file manager.
Opens the application preference view.
Opens the web browser and allow to download files from the web.
Allows to download files from your Dropbox accounts.
Open DICOM Echo view, allows to verify a connection to another DICOM application.
Open DICOM Send Files view, allows to send images to an other DICOM application.
Open DICOM Receive Files view, allows to receive images from an other DICOM application.
Open DICOM Query/Retrieve view, allows to build an interactive Query/Retrieve to download study/series/images from PACS system.
Toggle edit mode, when it's activated then the following additional commands are active at the bottom in the view.
Allows to add manually selected files or folder to database.
Uncompress the selected zip file and add all the files included into database, a possible password will be required (it is allows only standard Zip encryption).
Compress the selected files or folder in a new zip file, if you want you can specify a password.
Creates a new folder in the current folder.
Cuts the selected file.
Copy the selected file.
Pastes a previously cutted/copied file.
Renames the selected file.
Deletes the selected file.
   
  back to index

Database
In this view you can view and open the archived files in the classical hierarchy patient/study/series/images.

Note that all images retrieved with Q/R and StoreSCP services, download from Dropbox or from uncompress zip file are automatically archived in the database. Instead files copied through iTunes must be added manually to database.

You can also make a search specifing certain filters: Patient ID, Patient Name, Patient Birth Date, Study ID, Study Modality, Study Date From and Study Date To ( note that all dates are in the DICOM format, i.e. YYYYMMDD).

For Patients/studies the rows are displayed in the form:
  Patient Name Study Description
  Patiente Birth Date Study Date and Time

for series:
  Modality Series Number
  Series Description Series Date and Time

for images:
  Instance Number Image Type
  Rows x Columns Photometric Interpretation
   
Edits the search filters.
   
Toggle edit mode, when it's activated then the following additional commands are active at the bottom in the view.
Deletes the selected studies, series or images (note that operation imply also the removal of the files from file system).
   
  back to index

Dropbox
In this view you can download or upload files from or to your Dropbox account. Before upload one or more files, previously you must have selected and copied in edit mode in the file manager, if this was not done then it means that there are not files to upload and the upload button is deactivated. Note that an entire folder cannot be uploaded.
This button is visible in the upper right of the view if loDicom Viewer has not yet been connected to Dropbox.

If loDicom Viewer has been connected to Dropbox then you can disconnect from your account with this button, visible in the upper right of the view.

Download button allows to download files from Dropbox to local folder.

Upload button allows to upload files (previously selected and copied in edit mode in the file manager) to Dropbox folder.
   
  back to index

Measurement toolbar
This toolbar show all the measurement tools and other drawing elements such as cursor, mask and annotation texts. Note that when this toolbar is active the zoom, pan and autorotation are deactivated.
Show the Draw history view, here are displayed all drawn elements with their most important information in chronological order. You can select or delete every element.

Show the Color picker view, you can set the color of any drawing elements.

Erase all drawing elements.

Draw a cursor on touch, you can also move it.
Draw a modificable line, set an extreme with the first touch and set the other extreme with the second touch. On the second end is also displayed the length with calibration choosed. you can also move the extremes independently.
Draw a closed area with freehand tool and calculates the area. The first touch set the starting point, then area is drawn by moving the touch around interested region. The area measured is displayed near the last point with calibration choosed. You can also move entire area.
Draw an angle and automatically calculates the value in degrees. With the first touch set the first point of the angle, with second touch set the midpoint of the angle, and finally with third touch set the last point of the angle. The program automatically draws two lines between the first point and the midpoint and between this and the third point, then trace even an arch between the two lines to highlight the corner. Near the third point is displayed the angle in degrees.
Draw a rectangular area to mask part of the image, you can also move it.
Insert an annotation text. After writing the text in the view touch the screen touch where you must enter it, you can also move it.
Shows Text fonts view, you can choose the font for any annotation.
Shows Font size view, you can choose the font size for any annotation.
Shows Pixel Spacing view, you can set which attribute to activate. It is possible choose between Pixel Spacing (0028,0030) and Imager Pixel Spacing (0018,1114).
Shows US Region Calibration view, you can see all US region calibration and activate one, a red rectangle appears to limit it. You can also modify Physical Delta X and Physical Delta Y values.
   
  back to index

Image Processing toolbar
This toolbar show image enhancement tools, allows you to modify histogram and/or apply filters to enhance the images.
Show the Histogram view, it displays the histogram of image and offers some operations to modifiy the histogram.
Show the Filters view, offers a set of image enhancement filters that can be applied to the image.
Show the Graph tools view, offers a set of image manipolation functions that can be applied to the image.
Show the Video view, it allows to create a video from a multiframe DICOM file or from a series of DICOM images.
   
 
Histogram view
A histogram is a graphical representation of the frequency distributions of the intensity of each pixel. The intensity values range from 0 (darkest) to 255 (lightest) for a channel 8-bit color. The histogram is available for each channel Red, Green, Blue and for combination of each color, RGB. For each histogram are also some statistical data as the mean and variance, the first representing the value in average and the second is an index of dispersion from the mean.
   
   
Equalize Equalizes the image histogram, applying a linear function of the intensity values always with the goal of making the distribution as uniform as possible.
Level Adjusts the levels of an image by scaling the colors falling between specified black and white cursor (small black and white triangles) to the full available range, Tap and drag your finger to move the cursor. The black cursor specifies the darkest color in the image, colors darker before the black cursor position are set to zero. White cursor specifies the lightest color in the image, colors brighter after the white cursor position are set to the maximum value. You also can modifiy the gamma correction.
Gamma Applies a transformation of the image intensity by a power function.
Threshold Changes the value of individual pixels based on the intensity of each pixel compared to threshold. The result is a high-contrast, two color image. The threshold level can be changed by moving the black-white cursor, the pixels to left of cursor are set to black and the pixels to right of cursor are set white.
Threshold Black As Threshold but forces all pixels below the threshold into black while leaving all pixels above the threshold unchanged.
Threshold White As Threshold but forces all pixels above the threshold into white while leaving all pixels below the threshold unchanged.
   
Filters view
Filtering consists in applying a transformation (called a filter) to the image to highlight some features or to identify non-obvious details.
   
   
Blur The blur filter is useful for noise reduction.
Gaussian Blur The gaussian blur filter is useful for noise reduction. It convolves the image with a gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma.
Sharpen Sharpens the image making it look crisper and making the edges in the image more distinct, this operation accentuates edges but also any noise.
Edge Enhance edges within the image with a convolution filter of the given radius. Use a radius of 0 selects a suitable radius for you.
Emboss Transform the image to grayscale image with a three-dimensional effect. it "rise" the main part of the image relative to its background. This filter locates contrast lines of the image and adds shadows to them to imitate "depressed" areas. The lighter is the area, the more "depressed" it will appear.
Negate Negates the colors in the reference image, you can apply this filter to make a positive grayscale or color image.
   
Graph tools view
In this view there are a few image manipulation functions.
   
   
Flip vertical This command is used to flip the image from top to bottom.
Flip horizontal This command is used to flip the image from left to right.
Rotation This command is used to rotate the image of a specified degree.
   
Video view
In this view you can create a video from a multiframe DICOM file or from a series of DICOM images present in the same folder, in the second case you must open the first image then the program automatically opens the next images and takes the first frame of each one.
   
   
Single file with multi frames Select this option if you want create a video from a single DICOM file with multi frames.
Multiple files with single frame Select this option if you want create a video from a multiple DICOM images with single frame.
MPEG1 video Select this option to use MPEG1 video codec.
MPEG2 video Select this option to use MPEG2 video codec.
Source file/folder This field show the filename/folder of displayed image. If the option Multiple files with single frame is active then it's specified the source folder.
Destination folder This field show the destination folder where store the video, you can change selecting a new destination through File manager view.
Filename In this field you can specifiy the name of video.
Frames per second Allows you to specifiy the frames per second of video.
Width You can set the width in pixel, alternatively the size can also be changed proportionally.
Height You can set the height in pixel, alternatively the size can also be changed proportionally.
Constrain properties With this switch active the width and height are constrained, so changing of one dimension affects the other.
   
  back to index

DICOM network services
The network services of DICOM are based on the client/server concept. In the case two DICOM applications want to exchange some information, it is necessary to establish a connection and an accord on the following parameters:

  1. who is the client and who is the server;
  2. what DICOM services must be used;
  3. in what format the data are transmitted (i.e. compressed or not compressed).

Only if both the applications agree on this whole parameters the connection can happen. Additionally to the most fundamental service DICOM, related to the transmission of images (or in terminology DICOM: "Storage Service Class"), a certain number of advanced services are available, for instance the service of images storage (Query/Retrieve Service Class) allows to seek images in a PACS archieve according to certain criterions (patient, image acquisition date/time, equipment, etc.) and to selectively download the images from this archieve.

In loDicomViewer the communications operations allowed are four, namely: the verification service (also known as echo in DICOM terminology); service to send images (Store SCU or Service Class User) to a remote server, the service of reception image (Store SCP or Service Class Provider) sent by another DICOM  application, and finally the query/retrieve service to a remote server for search and retrieval images.
Open DICOM Echo view, allows to verify a connection to another DICOM application.
Open DICOM Send Files view, allows to send images to an other DICOM application.
Open DICOM Receive Files view, allows to receive images from an other DICOM application.
Open DICOM Query/Retrieve view, allows to build an interactive Query/Retrieve to download study/series/images from PACS system.
   
All files transfer operations occur asynchronously, this means that the user can continue to work while the files are transfered to or from other DICOM applications.
   
DICOM Networks Settings view
A network service requires prior setting parameters in the DICOM network settings view:
   
   
Configuration Name of configuration.
IP IP address of your device.
   
Local AE title The name of the local Application Entity, must be unique in the DICOM network and are typically managed by a system administrator. They are case-sensitive and 16 bytes long.
Local port TCP/IP port for incoming association requests, any number between 1 and 65535 can be used.
File prefix Allows to rename file received. This work only at image level, the received file is renamed as prefix-InstanceNumber.
Folder Subdirectory where store the all received files.
   
Peer AE title The Application Entity title of the remote application, must be unique in the DICOM network and are typically managed by a system administrator. They are case-sensitive and 16 bytes long.
Peer host The IP address of the remote application.
Peer port TCP/IP port used by remote application, any number between 1 and 65535 can be used.
   
Timeout A countdown in seconds before stop automaticaly C-ECHO service.
   
This view present three buttons:
Add a new network configuration.
Save the current configuration.
Delete the current configuration.
   
   
DICOM Echo view
   
   
This view presents three buttons:
Sends a DICOM C-ECHO message to another DICOM Application that implements a Service Class Provider (SCP) and waits for a response.
Stop the service.
Opens the DICOM Network settings view.
   
   
DICOM Send Files view
   
   
This view presents two buttons:
Sends selected files to the DICOM application set in DICOM Network Settings.
Opens the DICOM Network settings view.
   
   
DICOM Receive Files view
   
This view presents three buttons:
Starts the receiving service, all incoming files are stored in folder specify in DICOM Network Settings view.
Note that this service can also answer to C-ECHO message coming from other DICOM application.
Stop the service.
Opens the DICOM Network settings view.
   
   
   
DICOM Query/Retrieve view
   
   
The search criteria or filters for retrieving the images from remote application server are:
Patient ID  
Patient Name  
Patient Birth Date  
Accession Number  
from Study Date  
to Study Date  
   
Note that all dates are in the DICOM format, i.e. YYYYMMDD.
   
This view presents three buttons:
Execute the query.
Stop the service.
Opens the DICOM Network settings view.
   
After the first query the program show a list with patients/studies retrieved, for every record are displayed the patient name, patient birth data, study description and study date.
   
   
This view presents three buttons:
After selected a patient/study execute the query to retrieve the series.
Stop the service.
Retrieve a complete selected study, if not exist the program creates a new folder named with StudyInstanceUID and saves all files named with Modality.SOPInstanceUID.
   
After selected a patient/study you can execute a second query to retrieve the series, for every record are displayed the modality, series description, series number and series date.
   
   
This view presents three buttons:
After selected a series execute the query to retrieve the images.
Stop the service.
Retrieve a complete selected study, if not exist the program creates a new folder named with SeriesInstanceUID and saves all files named with Modality.SOPInstanceUID.
   
After selected a series you can execute a third query to retrieve the images, for every record are displayed the Instance Number, Image Type and Columns x Rows.
   
   
This view presents two buttons:
After selected images execute the query to download the images. All files are named as Prefix-InstanceNumber if the field File prefix is specified in DICOM Network Settings, else the files are named as Modality.SOPInstanceUID.
Stop the service.
   
   
lodicom:// URL scheme
With iOS an application can launch another application using the URL scheme, this is one of the simplest and easiest mechanisms you have to interact with other applications.

To simply open the app use the schema lodicom://

For now are supported two types of services:
retrieve Allows to launch the program and make a query/retrieve to download a study, a series or an image.

Some examples:

lodicom://?Service=retrieve&Config=CONQUESTSRV1&SOPInstanceUID
=1.2.840.1136190195200.3.0.1.19970424140438


lodicom://?Service=retrieve&LocalAETitle=LODICOM&LocalPort
=11112&PeerAETitle=CONQUESTSRV1&PeerHost
=192.168.0.2&PeerPort=5678&SOPInstanceUID
=1.2.840.1136190195200.3.0.1.19970424140438


The parameters allowed in this scheme are:

Config Name of a configuration present in DICOM Network Settings,
  or you can specify alternative network parameters
LocalAETitle  
LocalPort  
PeerAETitle  
PeerHost  
PeerPort  
  then use one of following parameters
StudyInstanceUID to retrieve a complete study,
SeriesInstanceUID to retrieve a complete series,
SOPInstanceUID to retrieve a single image.
   
receiver Allows to launch the program and automatically start the DICOM Receive Files service.

Some examples:

lodicom://?Service=receiver&Config=CONQUESTSRV1

lodicom://?Service=receiver&LocalAETitle=LODICOM&LocalPort=11112

The parameters allowed in this scheme are:

Config Name of a configuration present in DICOM Network Settings,
  or you can specify alternative network parameters
LocalAETitle  
LocalPort  
PeerAETitle  
PeerHost  
PeerPort  
  back to index

Web browser
In this view you can download DICOM files from the web.
Closes the web browser.
  Double state command, one tap to change the state. When the first icon is displayed then a tap on a link load it on browser, but when the second icon is displayed the browser tries download the file from the link.
  Double state command, one tap to change the state. When the first icon is displayed then the basic authentication is disabled and you can't access protected url, when the second icon is displayed then you can access protected url with basic authentication. The username and password can set in application preference.
Goes to back page.
Goes to forward page.
Stop loading page.
Goes to on specified url.
   
  back to index

Recognized gestures
Shows/hides top and bottom toolbar.
Zoom out.
Zoom in.
Previous/next frame for multiframe image.
  back to index