User Manual
User Manual
User Manual
User’s Manual
Version 2.4
Revised 12/8/2018
RDI Technologies
10024 Investment Drive, Suite 150 • Knoxville, TN • 37932 • www.rditechnologies.com
Copyright © 2016-18 RDI Technologies Inc. All Rights Reserved
RDI Motion Amplification User Manual
Contents
1 Using the cameras ................................................................................................................................. 5
1.1 The Iris M Camera ........................................................................................................................ 5
1.2 The Iris MX Camera ..................................................................................................................... 5
1.3 Lenses ........................................................................................................................................... 7
2 Software ................................................................................................................................................ 8
2.1 Installation..................................................................................................................................... 8
2.2 Acquisition Software .................................................................................................................... 8
2.2.1 Firewall Access for Iris MX................................................................................................ 10
2.2.2 Recording Properties ........................................................................................................... 11
2.2.3 Recording Association ........................................................................................................ 11
2.2.4 Iris M Camera Properties .................................................................................................... 12
2.2.5 Iris MX Camera Properties ................................................................................................. 12
2.2.6 Image Properties ................................................................................................................. 13
2.2.7 Calculated Values ............................................................................................................... 13
2.2.8 Recording/Playback Bar ..................................................................................................... 14
2.2.9 Toolbar for Iris M Recordings ............................................................................................ 15
2.2.10 Toolbar for Iris MX Recordings ......................................................................................... 16
2.2.11 Image Viewer Window ....................................................................................................... 17
2.2.10.1 Focus Brightening ................................................................................................................. 18
2.2.12 Settings ................................................................................................................................ 18
2.2.13 Information ......................................................................................................................... 20
2.3 Managing your License............................................................................................................... 21
2.4 Motion Amplification Software .................................................................................................. 23
2.4.1 Opening a file ...................................................................................................................... 23
2.4.2 Toolbar ................................................................................................................................ 24
2.4.3 Playback Bar ....................................................................................................................... 28
2.4.4 Adjusting Amplification ..................................................................................................... 28
2.4.5 Determining Amplification Period ...................................................................................... 28
2.4.6 Playback Speed ................................................................................................................... 29
2.4.7 Exporting a Video ............................................................................................................... 29
2.4.8 Settings ................................................................................................................................ 30
2.4.9 Information ......................................................................................................................... 31
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
2
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
3
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
4
RDI Motion Amplification User Manual
GPIO connector
(for future use)
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
5
RDI Motion Amplification User Manual
Important: In order to download recordings from the Iris MX camera the network connection used to
communicate with the camera must be configured correctly. If the connection is not configured correctly,
the message below will be displayed when the acquisition application is launched.
In order to configure the network connection properly, please follow the steps below:
1) Open the Windows Network and Sharing Center
2) Click “Change Adapter Settings”
3) Right click the network connection that will be used to communicate with the Iris MX camera
and select “Properties”.
4) Under the Networking tab, click the Configure button for the network adapter.
5) Select the Advanced tab.
6) Select the “Jumbo Packet” item in the list and change it’s value to 9,104 bytes (or 9kB MTU). If
the only options for Jumbo Packets is “On” or “Off”, choose “On”.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
6
RDI Motion Amplification User Manual
1.3 Lenses
The types of lenses used with both the Iris M and MX cameras are C-Mount lenses. The lenses mount to
the front of the camera via a threaded interface. A standard kit may include several lenses. The focal length
of the lens determines the field of view (fov) and magnification. By changing lenses to double the focal
length, the magnification will double, while the fov will decrease by one half. By changing lenses to half
the focal length, the magnification will decrease by one half and the fov will double.
Aperture Ring – The aperture ring is a collar on the camera that can be rotated to increase or decrease the
aperture. The effect is letting more or less light in, respectively.
Focus Ring – The focus ring is a collar on the camera and changes the focus of the image.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
7
RDI Motion Amplification User Manual
2 Software
The suite of Motion Amplification software consists of four software applications: Acquisition, Motion
Amplification, Motion Explorer, and Motion Studio. These applications are all installed on the acquisition
device. An Analysis Only installation may be installed on another PC, and this installation will include
Motion Amplification, Motion Explorer, and Motion Studio. The Acquisition software records the data
while Motion Amplification software analyzes the data and amplifies the motion. Motion Explorer allows
the user to create an organizational hierarchy under which collected recordings can be found. Motion Studio
allows the user to create more complex MP4 videos.
2.1 Installation
If after installation and reboot an activation dialog is displayed, see the Managing your License.
It is important to select the appropriate line frequency for your location when recording indoors. This sets
the proper frame rate to ensure your camera is timed to take images at the same frequency as your lights
brighten and dim. See the Troubleshooting section on issues with selecting the wrong frame rate with AC
lighting.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
8
RDI Motion Amplification User Manual
The default settings for the Iris M camera are as follows. Values are for 60 Hz line frequency unless
noted.
Setting Value
Name “Current Date”
Distance 50 ft
Focal Length (mm) 50
Time (seconds) 3
Framerate (fps) 120 fps (100 for 50 Hz line frequency)
Brightness (%) 68.2 (57 for 50 Hz line frequency)
Gain (dB) 0.0
Width 1920
Height 1060 (1200 for 50 Hz line frequency)
Left 0
Top 0
The default settings for the Iris MX camera are as follows. Values are for 60 Hz line frequency unless
noted.
Setting Value
Name “Current Date”
Distance 50 ft
Focal Length (mm) 50
Time (seconds) 3
Framerate (fps) 120 fps (100 for 50 Hz line frequency)
Brightness (%) 68.2 (57 for 50 Hz line frequency)
Gain (dB) 0.0
Width 1920
Height 1060 (1200 for 50 Hz line frequency)
Left 0
Top 0
The Motion Amplification Software records video into a “.rdi” format. Each “.rdi” file has a corresponding
folder of the same name that also stores data. It is necessary for the “.rdi” file and the corresponding folder
to remain in the same directory.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
9
RDI Motion Amplification User Manual
The first time the RDI Acquisition application is run, the user should see a message from the Windows
Defender Firewall (or the currently installed firewall). The message is telling the user that Windows
Defender Firewall has blocked some of the features of the RDI Acquisition application.
The RDI Acquisition application talks to the Iris MX camera using an ethernet connection, so the user needs
to allow the camera to communicate with the acquisition application through the firewall. Simply check
both boxes in the displayed message (shown below) and press the “Allow Access” button. This should
allow the camera to properly communicate with the software.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
10
RDI Motion Amplification User Manual
Number of Images – If the duration type is set to “Number of Frames” this option will be visible. The
entered value specifies the length of the recording in terms of the number of images to collect. For example,
240 images recorded at 120 fps will give a 2 second recording. Note: The recording time for a given number
of frames can be seen in the “Calculated Values” section.
Duration – If the duration type is set to “Time(sec)” this option will be visible. The entered value specifies
the length of the recording in terms of the number of seconds to collect data at the specified framerate. The
number of frames that will be collected based on the specified time appears in the “Calculated Values”
section.
Asset – Determines the asset under which the recording will be associated. Assets cannot be created in the
acquisition software. See Section 0 for creating an asset in Motion Explorer.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
11
RDI Motion Amplification User Manual
Frame Rate Quality - A color indicator is directly to the right of the frame rate setting. This circle
informs the user if the software is receiving the requested frame rate. If the camera’s framerate drops below
the requested value, the circle turns red. This indicates the camera cannot sustain the requested
framerate. It is suggested the user reduce the vertical resolution of the camera to accommodate the requested
framerate or drop the frame rate until the circle turns green. The user can hover the mouse over the circle
to see what framerate the camera is achieving.
Brightness (%) – Adjusts the brightness of the image by changing the exposure time of the image. The
larger the brightness level the longer the exposure time. This value is scaled from 0 to 100 percent.
Gain – Adjusts the sensitivity of the camera’s sensor. By increasing the gain, you will brighten your image,
but you will introduce more noise and decrease the quality of the measurement. Sometimes this is necessary
when the image is too dark.
Image Rotation – Rotates the image in the Image Viewer Window. The image is permanently rotated and
appears the same when opened in Motion Amplification. The image can be rotated 90° Clockwise, 180°,
and 90° Counter Clockwise.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
12
RDI Motion Amplification User Manual
The image size and location can also be adjusted by drawing a Region of Interest (ROI) in the image. See
Section 2.2.11.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
13
RDI Motion Amplification User Manual
Note: The Iris M camera stores data on the acquisition computer as it is collected. The Iris MX camera
initially stores the captured data on the camera, and it is transferred to the acquisition computer when the
Save Recording button is pressed. This transfer process may take some time depending on the total size of
the recording.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
14
RDI Motion Amplification User Manual
Acquisition State – Displays information about the state of the system. Can be “Ready”, “Recording” or
in “Review”.
Images Collected – Displays the total number of images collected. This is the number of images written to
SSD and to RAM and accounts for all the images collected at the present time of display.
Images Stored – Displays the total number of images written to the SSD. This does not account for any
images that are written to RAM because the SSD could not keep up with saving the files.
Memory Available (%) – Displays the current percentage of free RAM accessible to the application. If
the SSD cannot keep up with storing image during acquisition this percentage will decrease as overflow
images are written to RAM. If system RAM reaches a critical state of 5% available, the recording stops.
The Recording /Playback bar displays the position of the recording indicated by where the slider is relative
to the bar. Green represents the number of images recorded to SSD and Yellow represents images recorded
to RAM. Once acquisition is complete the bar will progressively turn solid green as images are moved from
RAM to the SSD. The Save, Delete and Amplify buttons will also become active once recording completes.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
15
RDI Motion Amplification User Manual
Acquisition State – Displays information about the state of the system. Can be “Ready”, “Recording”,
“Review”, or “Downloading”.
Recording Images – Displays the total number of images collected that will be stored with the current
recording.
Captured Images – As mentioned above, the camera may need to capture more images than were requested
for the current recording. In this case, captured images will exceed recording images.
The Recording /Playback bar displays the position of the recording indicated by where the slider is relative
to the bar. Green represents the number of images collected relative to the number requested for the current
recording. Yellow represents any additional images that had to be captured by the camera due to the fact
that it acquires data in blocks of a certain size. The Save, Delete and Amplify buttons will also become
active once recording completes. Pressing Save or Amplify will initiate the transfer of the recording from
the Iris MX camera to the acquisition computer.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
16
RDI Motion Amplification User Manual
Image Information – Image information will be displayed when the mouse is placed on the image. The
information is: Percent of Full Brightness, Horizontal Pixel Location, Vertical Pixel Location. Pixel (0,0)
is located in the upper left corner.
Image Toolbar – The image toolbar above the Image Viewer Window allows the user to Zoom Out, Zoom
In, Reset Zoom to full view and Move the image. The Move Image buttons are only accessible if the image
is zoomed in. The Distance Pin icon allows the user to place a distance pin on the image and associate a
distance with that location. Multiple pins can be placed on an image. The Grid Lines button will display a
grid overlay in the Image Viewer Window.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
17
RDI Motion Amplification User Manual
Image Toolbar
The user can draw a Region of Interest (ROI) to change the dimension and location of the image in the field
of view. A Left Click + Drag will draw a red box on a portion of the image. When the user releases the
mouse the acquisition window will only be the portion of the image containing the ROI.
Note: If the user records at this point only the information in the ROI will be recorded. The user can go
back to the full field of view by pressing Reset under Image Properties.
2.2.12 Settings
The settings menu can be accessed by pressing the gear icon .
Storage Folder: The storage location of the acquisition application can be changed. This determines the
location where recordings are stored.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
18
RDI Motion Amplification User Manual
Default Recording Name: The default file naming convention can be chosen from three different options.
Line Frequency: An option to specify the line frequency is also available. The Line Frequency setting only
changes the default frame rate to be 2x line frequency to reduce flicker from indoor lighting.
Dynamic Range: This option determines the dynamic range used by the camera to collect and store a
recording. “Higher Sensitivity / Lower Framerate” is one option. This option uses the full dynamic range
of the camera, but the available framerate is not as high as if the option “Lower Sensitivity / Higher
Framerate” is chosen. This second option allows for higher framerates compared to the first option given
the same field of view, but the camera is not quite as sensitive. The default is higher sensitivity, but if there
are cases where higher framerate is needed for a given field of view the lower sensitivity option may be
used. This option is applicable to both the Iris M and the Iris MX cameras.
Iris MX Binning: The Iris MX camera supports a feature called binning. Binning is another way to achieve
higher framerates for a given field of view. Without binning, every pixel on the camera is treated separately.
In this case for every pixel of the camera sensor that has data collected, information for that individual pixel
is stored. If binning is enabled, 2x2 groups of pixels on the camera’s sensor are aggregated into a single
pixel in the stored image. So if the full field of view is used as an example, the full 2560x2048 sensor with
binning enabled will result in images that are 1280x1024 without a reduction in the field of view. The
images collect without binning and those collected with binning will have the same field of view. This
allows the camera to achieve higher framerates for a given field of view. Another way to achieve this effect
is to change to a different lens and only collect a portion of that lens’s field of view. An example would be
changing from a 50mm lens to a 25mm lens and only collecting a 1280x1024 recording. Higher framerates
would be possible with the 1280x1024 recording with the 25mm lens, but the field of view would be the
same as that of the 2560x2048 recording with the 50mm lens.
Frequency Units: This option determines whether frequency units are expressed in Hz or CPM. When in
displacement mode, Fmax is expressed in these terms. The frequency axis of spectrum plots displayed in
Motion Amplification is also expressed in these terms.
Disk Space Warning: This property can be set to display a warning when disk space falls below a certain
amount.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
19
RDI Motion Amplification User Manual
2.2.13 Information
Information about the software can be accessed by pressing the info icon .
The Information dialog provides access to information about the installed RDI Acquisition application. It
also provides access to the help system and the email address for RDI support. The Preference Factory
Reset option will return the application to the initial default values for all configurable items. The user may
also display the License Agreement that was accepted during the installation process. The manage license
button provides access to functionality such as activating and deactivating the license for the current
installation and informing the user of maintenance expiration dates.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
20
RDI Motion Amplification User Manual
If the computer is not connected to the Internet, you can use another computer’s internet connection. To
use another computer’s Internet connection, enter the License ID and Password provided as a part of your
purchase, select “Another computer’s internet connection” in the License Status dialog, and press the
“Next” button. In the “Begin Manual Request” dialog, you will then be prompted to save an activation
request file to your computer. You will then need to manually transfer that file to another computer and
double click the file once transferred. This will produce an activation response file using the other
computer’s Internet connection. That response file will need to be transferred back to the computer on
which the software was installed. When you press “Next” from the “Begin Manual Request” dialog, you
will be prompted to select the Activation response file. Selecting the proper response file and pressing the
next button will complete the activation sequence.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
21
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
22
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
23
RDI Motion Amplification User Manual
2.4.2 Toolbar
The Zoom In button allows the user to zoom into an area of interest in the amplified recording. Once
zoomed, the user can Zoom Out and Reset the Zoom position to full view. When the view has been zoomed,
the user can also move the current view in any direction using the Pan buttons.
A grid overlay is supported in Motion Amplification. If the Grid button is pressed, a grid will be shown in
the Motion Amplification window.
2.4.2.1 Annotations
The Add Annotation button allows the user to add Text, Lines, Rectangles, Ellipses, Polylines, Polygons,
Image Annotations, and Plot Annotations to the current recording.
• Text Annotations: Drawn by clicking the left mouse button to define their location. The
properties of the text annotation are then displayed, and these can be modified by the user.
• Line Annotations: Drawn by pressing the left mouse button at the desired start of the line and
then dragging the mouse (while still holding down the left mouse button) to release the mouse
button at the desired end of the line. The properties of the text annotation are then displayed, and
these can be modified by the user.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
24
RDI Motion Amplification User Manual
• Rectangle and Ellipse Annotations: Drawn by pressing the left mouse button at one corner and
then dragging the mouse and releasing the button at the opposite corner. The properties of the
text annotation are then displayed, and these can be modified by the user.
• Image Annotations: Drawn by pressing the left mouse button at one corner and then dragging the
mouse and releasing the button at the opposite corner. The user then must select an image file
that will be used to populate the space defined by the image annotation. BMP, JPEG, GIF, TIFF,
and PNG image file types are supported.
• Plot Annotations: Drawn by pressing the left mouse button at one corner and then dragging the
mouse and releasing the button at the opposite corner. The user then must select an ROI, plot
type, and orientation to be used for the plot annotation. Checking the Connect to ROI box will
draw a line between the ROI and the plot annotation. For waveform and orbit plot annotations,
Track Playback is enabled. This will show a marker on the plot that represents the current
playback location.
Annotations may be resized by dragging the white handles. The green handle may be used to rotate the
annotation.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
25
RDI Motion Amplification User Manual
The Delete All button will remove all of the currently displayed annotations.
2.4.2.2 Amplification Regions
With amplification regions the user can choose to amplify only specific regions of the image. The
Amplification Region Editor can be activated by pressing the Regions button on the toolbar.
The Default Amplification Behavior determines if the entire image is amplified by default or not. If Amplify
None is chosen, the shapes act to include amplification in regions they define. If Amplify All is chosen, the
shapes act to exclude regions they define. To help with this process, the image is color coded with red being
regions where amplification will not occur and green being regions where amplification will occur.
Three shapes can be chosen to define a region: a circle, a square and a polygon. The polygon can be created
by using the left mouse button to click and define the points of the polygon. To end the creation of the
polygon double click on the location of the last point, right click to define the last point, or press the escape
key.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
26
RDI Motion Amplification User Manual
The camera can show more levels of grey than the computer screen is capable of displaying. Applying a
Threshold to the image allows the user to choose which parts of the dynamic range of the camera will be
shown on the screen. By default, the entire range of values are shown but in less detail. The benefit is
making the shadows or highlights show better on the screen. The previous images shows the effect of
applying a Threshold. The image to the left is the default image. The image to the right is after applying a
threshold to highlight the dark areas of the image. The image below shows the Threshold Editor and the
settings that were applied.
The Threshold Editor graph plots the number of pixels vs intensity value. A high peak on the left hand side
as seen above indicates a large number of pixels have dark values. The green area indicates the range of
intensities that will be shown on the screen. To adjust the range, the blue triangles can be moved to indicate
the upper and lower intensity value for the image. In this case the user selected to show darker values to
make them appear better on the screen.
The brightness of the recording is typically controlled during acquisition, but it can be fine-tuned during
playback with the brightness slider to the right of the threshold window. The default, center position is no
adjustment. Moving the slider above the center position will increase the brightness of the amplified
playback. Moving the slider below the center position will decrease the brightness of the amplified
playback.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
27
RDI Motion Amplification User Manual
The portion of the recording to be exported is controlled by the green triangles shown on the playback bar.
Right click on the playback position indictor to set the current recording position such that it is the Export
Start or the Export End (see Section 2.4.7 Exporting a Video).
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
28
RDI Motion Amplification User Manual
triangle will appear above the bar at the current position indicating the ending point of the amplification
period.
Important: To apply amplification for this period of time right click and select Reamplify Recording.
Note: When a period less than the total length of the recoding is set as the Amplification region, only
the portion of the recording that is amplified will appear amplified on playback. The
remaining period outside of the amplification window will appear as normal video.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
29
RDI Motion Amplification User Manual
o The next available option is Plot Orientation. If Spectrum or Waveform were previously
selected, the options available include X, Y, and X & Y. If Spectrum & Waveform was
previously selected, the only two choices available are X and Y. If Orbit was selected
previously, this option is not enabled.
o Plot Layout is the next option available. If the previous selection result in more than one
plot being included in the export, then this option determines the layout of those plots
relative to each other.
o Layout of Plots and Video Content determines the layout between the video content and
the plot content.
• Include Company Logo will result in the logo specified in the user preferences dialog being
included in the generated plots.
• Include Export Description will include the description available on the main Motion Amplification
window in the exported video.
At the bottom of this dialog is a preview window. All of the options above will be reflected in the preview
window as they are changed. Pressing the OK button will produce the requested MP4 video.
2.4.8 Settings
The settings button in Motion Amplification provides access to options related to the grid and producing
an exported MP4 video.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
30
RDI Motion Amplification User Manual
The Grid Options section includes items that control the color for the grid lines and the grid size in pixels.
The Export Options section includes an option to specify the location for exported files to be written to the
user’s computer. An option to include a company logo is available. If selected the company logo will be
displayed in the lower right of every frame in the video. The last option is a browse button to select the
user’s own logo. The logo file needs to be either png, jpg, or bmp format. When displayed, the logo file
will be resized proportionally such that it is 100 pixels high. For better appearances use a logo that has
transparency set or a black backgound since the logo will be applied to the black bar region below the
video.
The Measurements Units section allows you to change units between Metric and Imperial with the
respective units being:
2.4.9 Information
The information dialog provides access to further information about the current recording and the installed
Motion Amplification application. It also provides access to the help system and the email address for RDI
support. The user may also display the License Agreement that was accepted during the installation process.
The manage license button provides access to functionality such as activating and deactivating the license
for the current installation.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
31
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
32
RDI Motion Amplification User Manual
Users can choose to rename recordings from the recording information window. To rename a recording
click the cursor text button in the upper right-hand corner of the window in the Filename field as seen
below. This will open a “Rename Recording” window, also shown below. Enter the new file name in the
field and select OK to accept. The “.rdi” file and all files associated with it will be renamed.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
33
RDI Motion Amplification User Manual
Below are the Time Waveform and Spectrum Windows when they are launched by clicking the respective
button. They remain blank until an ROI is drawn. The Orbit Window behaves in the same manner.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
34
RDI Motion Amplification User Manual
ROI
Once an ROI is drawn as shown above, a progress window will pop up as seen below. The software will
then calculate the displacement in the ROI. Once complete, the Time Waveform, Spectrum, and Orbit
windows will populate with the displacement data calculated from the ROI.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
35
RDI Motion Amplification User Manual
IMPORTANT
It is important to understand the basics of drawing an ROI to return an accurate time waveform. The ROI
should only be drawn over a region for which you are interested in measuring. If the ROI shares an area
with two different objects that are moving differently there is no guarantee which object the time waveform
represents. Therefore, care must be taken in drawing the ROI. The time waveform measurement cannot be
made over a uniform surface, some level of contrast must be present for the software to “see”. This means
some level of contrast must be present in the ROI for proper measurements and alternatively this makes it
possible to draw an ROI over an edge of an object that has a uniform background.
Examples
In the following image the ROI is drawn on a very small piece of machinery. It is suitable for the software
to select any location in the box to measure from.
OK
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
36
RDI Motion Amplification User Manual
In the following image the ROI is much bigger. This is undesirable because the software may choose any
location within the ROI from which to measure. There is uncertainty as to where the time waveform
originates.
Not
OK
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
37
RDI Motion Amplification User Manual
In the following image the ROI is drawn on the edge of the machine, however the background is uniform
while the machine has contrast. The user can be confident the software will measure on the machine.
OK
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
38
RDI Motion Amplification User Manual
In the following image the ROI is drawn on the edge of the machine but in this case there is contrast in the
background. This is undesirable as the software may measure the machine or background.
Not
OK
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
39
RDI Motion Amplification User Manual
Below are examples of the Time Waveform, Spectrum, and Orbit plots. The software measures both the X
and Y direction as seen from the camera. For the Time Waveform and Spectrum plots, the X direction is
shown in the top plot of each image while the Y direction is shown in the bottom plot of each image. The
Orbit plot includes measurements from both the X and Y directions.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
40
RDI Motion Amplification User Manual
Orbit Plot
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
41
RDI Motion Amplification User Manual
The Export option will send the data samples of the selected waveform to a “.csv” file. This file format
can be easily imported to Microsoft Excel or other software applications for further data manipulation.
Once this option is selected, a dialog is displayed that allows the user to specify the file name for the
exported data.
An option to Copy the current plot to the clipboard is also available in the plot’s context menu. When this
option is selected, a bitmap representing the current plot is placed in the Windows clipboard. Once the
plot is in the clipboard, the image can be pasted into many other applications such as Microsoft Paint or
Microsoft Word.
2.5.3.1 Waveform Amplitude Units
The Time Waveform plot can be shown in units of velocity by right clicking the graph. From the menu
select “Setup Options”. A configuration screen will display, shown below, that allows a choice between
displacement or velocity on both the Time Waveform and Spectrum. If velocity is selected the Time
Waveform is differentiated to determine velocity. Available units are inches per second (in/s) or millimeters
per second (mm/s). Imperial or metric units can be changed under the Settings menu in the upper right
corner of the Motion Amplification Software.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
42
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
43
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
44
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
45
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
46
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
47
RDI Motion Amplification User Manual
ROI #2
ROI #1
At times the user may want to make displacement readings for locations in the image that are at different
distances from the camera. It is important to know the distance from the camera to the object being
measured to ensure an accurate displacement. The user can load different distance measurements for
different locations in the image. To do so the user can click the Distance Pin in Motion Amplification.
This will launch a Define Locations Window as shown below that will allow the user to select different
active distances. Once a distance is selected all measurements will be made with that distance until it is
changed. All previous measurements are unaffected if a new distance is selected. This allows multiple
displacements measurements to be made at different distances. Distance can also be added in Motion
Amplification.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
48
RDI Motion Amplification User Manual
When multiple ROIs are drawn, each ROI has both an X and Y component. This can quickly fill the screen
with Time Waveform and Spectrum plots. Each plot is collapsible making it easy to keep plots from taking
up space on the screen. To collapse a plot simply click on the caret symbol “^” in upper right hand corner
of the plot.
Plots can be overlaid onto one another for comparison. This is done by right clicking and holding on a plot.
Then dragging the mouse until you are on the plot you would like to overlay onto. Then the user releases
the mouse and the initial plot you clicked on is now overlaid onto the plot you dragged it to. To remove the
plot simply right click and click “Clear Overlay” from the menu. Below are examples of the Time waveform
and Spectrum showing overlaid plots. This feature is available for Time Waveform, Spectrum, and Orbit
plots.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
49
RDI Motion Amplification User Manual
Zooming in and out of a plot can be achieved by scrolling forward and backward respectively with the
center mouse wheel to zoom in and out. The plot scaling can be reset at any time by right clicking and
choosing “Reset Scale” from the menu.
Sections of the plot can be zoomed to fill the entire plot region. This is accomplished by holding the shift
key while the mouse is on a plot. Then with the shift key held, the user left clicks and drags the mouse over
the region to zoom and fill the plot. The user then releases the mouse button and the plot zooms. The image
below shows the plot appearance as the user drags over a region to zoom. The shaded area shows the area
in which the plot will be zoomed.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
50
RDI Motion Amplification User Manual
3 Filtering
The Filtering functionality in the Motion Amplification software allows users to amplify certain frequencies
that are present in the vibration data extracted from a recording. If filtering is not applied to a recording
during the amplification process, all of the motion that is present is amplified. So assuming multiple
frequency components are present, the user may choose to amplify the motion of any specific frequency
that is present or the motion associated with multiple frequencies may be amplified. When filtering is
applied to a recording, the original recording is not altered. Instead a new recording is created.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
51
RDI Motion Amplification User Manual
ROI
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
52
RDI Motion Amplification User Manual
the Y direction for the current ROI. The spectrum plot provides a graphical means to specify filters
appropriately relative to the frequency content that is present and what is desired to be included in
amplification. The frequency content associated with the green portion of the spectrum will be included in
amplification. The red portion of the spectrum indicates that it is associated with the current or active filter
and will be excluded from amplification. To change the active filter, select a different filter in the list of
filters to apply. Gray portions of the spectrum are also excluded, but they are excluded because of a filter
other than the one currently active. Please see the next section for an example.
Cutoff frequencies for the active filter can be adjusted graphically by using a left mouse click and dragging
the cutoff frequency handle (shown circled in blue below) to the left or right. The cutoff frequency value
in the table of filters to apply will be updated when frequencies are adjusted graphically. To change the
active filter, select a different filter in the list of filters to apply.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
53
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
54
RDI Motion Amplification User Manual
Once the filtering process is complete, the new recording will be loaded. If the user looks at the recording
information, the filters that have been applied are listed. See the image below for an example.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
55
RDI Motion Amplification User Manual
4 Stabilization
Stabilization offers the ability to digitally stabilize rdi recordings if camera vibration has been introduced
into the video. Sometimes vibration makes it to the camera despite best attempts to eliminate it at the source.
Note: Passive methods of stabilization are preferred. Always use the vibration pads and avoid
vibrating surfaces as the first method of eliminating camera vibration. Digital stabilization is
designed to be used only in cases where other vibration methods are not possible.
This will bring up the “RDI Information” window. Next press the recording information button .
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
56
RDI Motion Amplification User Manual
This will bring up the “Recording Information” window giving details about the file. One of the properties
is “Stabilized”. This line indicates whether the recording has been stabilized.
Note: A recording can only be stabilized once.
If the recording has not been stabilized this line will read “No” and the tripod icon will be blue, indicating
the button is clickable. To stabilize the recording press the tripod icon.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
57
RDI Motion Amplification User Manual
After clicking the tripod icon, the “Stabilize Recording” window will be displayed.
When a file is stabilized, it creates a new stabilized .rdi file. The original file is not altered. The first entry
box is where the new filename is entered. The second dialog box allows a choice of stabilization types. The
user can choose between stabilizing the file based on the entire frame (default) or selecting a portion of the
frame for stabilization
If “Use Entire Frame” is selected the file will proceed to be stabilized. Now see Section 4.3 Completed
Stabilization.
If “Specify Portion of Frame” is selected see Section 4.2 Stabilize Based on a Portion of the Frame.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
58
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
59
RDI Motion Amplification User Manual
Once stabilization is complete a window will appear informing the user that stabilization is complete and
the new stabilized recording will be loaded in the software. The original un-stabilized recording will be
closed.
After closing the “Stabilization Complete” window the new stabilized file will be amplified.
Once the stabilized recording is amplified, it is now ready to be viewed. The “Recording Information”
window will still be open and must now be closed. Note: The Stabilized entry now reads “Yes” and the
stabilization tripod icon now appears grayed and inactive, indicating the file can no longer be stabilized.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
60
RDI Motion Amplification User Manual
5 Motion Explorer
Motion Explorer allows you to create a hierarchy of folders and assets and organize your recordings,
exported MP4 videos, and other files under the appropriate asset. Assets have one or more collections
associated, and these collections are where recordings and exported MP4 videos reside.
When the RDI Acquisition application collects a recording, it will automatically be associated with the
selected collection from the asset hierarchy. When Motion Amplification creates recordings as a result of
filtering or stabilization, these recordings will automatically be associated with the same collection as the
original recording. MP4 videos exported from Motion Amplification will also be associated with the same
collection as the source recording.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
61
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
62
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
63
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
64
RDI Motion Amplification User Manual
5.2.4.2 Cut/Copy/Paste
Items can be Cut and then Pasted to perform a move operation. Items can also be Copied and then Pasted
to perform a copy operation. Recordings, exported MP4’s, and other file type items cannot be copied from
within Motion Explorer.
5.2.4.3 Remove
Any item except the Company can be removed from the hierarchy.
Important: When an item is selected to be removed, a dialog will be displayed asking a question about
whether to A) remove the item and its children from the hierarchy OR b) remove the item and its children
from the hierarchy and DELETE any associated files. The recordings, exported MP4’s, and other files
associated with a collection are not actually stored in the RDI Hierarchy Database. They are stored
separately in the Windows File System and a link to their storage location is stored in the RDI Hierarchy
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
65
RDI Motion Amplification User Manual
Database. So you may choose to remove just the link to the file OR remove the link and delete the
associated files. If the files are deleted, they cannot be recovered.
5.2.4.4 Rename
Any item can be renamed with the Rename function available in the ribbon. When this option is selected,
the selected item in the left or middle pane will be shown in edit mode as seen in the following image. Use
the keyboard to rename the current item. Pressing the enter key or selecting another items commits the
change. Pressing the Escape key will cancel the change.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
66
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
67
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
68
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
69
RDI Motion Amplification User Manual
5.2.4.10 Export
The purpose for the Export functionality available within Motion Explorer is to allow you to move a group
of recordings (and their parent collections, assets, and folders) from one computer to another. For example,
every Iris M system comes with an Acquisition System license and an Analysis Only license. Export
provides an easy way to get a group of recordings from the Acquisition system computer to the Analysis
Only computer.
You need to answer four questions before an export operation can begin:
1) What would you like to export?
There are several options that attempt to help you export only the items that need to be moved (since moving
recordings is typically not an overly quick operation). The first option allows you to export any collection
that has not been previously exported. A collection is considered to have been exported if all of its contents
are exported. If an item is added to a collection, it is marked as not having been exported. The second
option allows you to specify a date range such that only recordings created within that date range are
exported. The third option simply allows you to manually specify what you want exported.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
70
RDI Motion Amplification User Manual
Once you make selections for these four options a confirmation screen will be displayed. This allows you
to change the items that are marked as to be exported. Once you click finish on this screen, the export
operation will begin and a progress bar will be displayed. Once the export has completed a file will be
created with the specified name and the extension “.exp”. There will also be a folder with the same name
as the export. This file and folder comprise the export package. Both must be available to perform an
import operation of the contents.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
71
RDI Motion Amplification User Manual
5.2.4.11 Import
Importing is the process of moving previously exported collections and files onto a different computer from
which they were exported. Importing involves selecting the “.exp” file created during the export process.
Once you select this file, a confirmation message will be displayed telling you how many assets, recordings,
and collection are contained in the export file. If you choose to continue the import, a progress bar will be
displayed.
Part of this process is to create the necessary folders and assets with which the collections and recordings
in the export file are associated. If a recording is imported that appears to be a duplicate, it is still imported
but with a new, incremented name. For example, if “recording.rdi” was imported but already exists, it
would still be imported but with the name “recording (2).rdi”.
5.2.4.12 Move Files
The move file function is intended to move one or more files from one storage location to another. For
example, from the Acquisition computer’s internal SSD to an external SSD. An important difference
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
72
RDI Motion Amplification User Manual
between move and export is that moved files will still be shown under their parent collection in Motion
Explorer. Their place in the hierarchy is not altered. They are just moved from one storage location to
another, most likely to increase available disk space.
This operation can be initiated from any level of the hierarchy. If it is initiated at a level in the hierarchy
above an individual file, all of the files below the selected item will be moved. Once a destination directory
is specified and you press “OK” a progress bar will be displayed.
When the Apply Filters options is selected, a confirmation dialog is shown (image included below). This
presents the filters that will be applied, and also the recordings to which they will be applied. The filters
to be applied may be disabled as well as the recordings to which they will be applied. At least one filter
and one recording must be enabled in order to perform the filtering operation.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
73
RDI Motion Amplification User Manual
5.2.5 Settings
The Settings button is found in the upper right corner of the Motion Explorer application. It provides access
to several settings that are configurable.
The default terms that are used in the asset hierarchy are Folder, Asset, and Collection. You may specify
different terms for these items in the hierarchy.
5.2.6 Information
In the upper right corner of the Motion Explorer application is an Information button. Press this button to
access information about the application, help, view the license agreement, and access license information.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
74
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
75
RDI Motion Amplification User Manual
6 Motion Studio
Motion Studio brings video editing capability into the RDI suite of software. It supports the building of a
movie project, where the movie project is composed of one or more various items. Title slides are one of
item types that can be added to a movie, and they can contain text, images, and other various annotations.
Previously created videos and images can also be added to a movie project. Annotations can be added to
any file type. Motion Studio supports trimming and fade effects. Once the movie project has been
completed, the user simply saves the movie and an MP4 is created that contains all the items contained
within the movie project.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
76
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
77
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
78
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
79
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
80
RDI Motion Amplification User Manual
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
81
RDI Motion Amplification User Manual
6.3.6 Cut/Copy/Paste
The Cut, Copy, and Paste items in the Ribbon Bar may be used to copy any item in the Movie Project.
Pasted items will be placed before the item currently selected when the Paste button is pressed.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
82
RDI Motion Amplification User Manual
Important: Pressing the Save Movie button will construct an MP4 movie based on the current
content of the Movie Project. This operation may take several minutes, and a progress bar will
be displayed to help estimate the amount of time remaining. Once the movie creation is complete,
the user is presented with a choice to play the movie, open Windows File Explorer to the location
where it was stored, or continue working in Motion Studio. Once the movie is saved, it can also be found
in Motion Explorer under the Collection with which the Movie Project is associated.
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
83
RDI Motion Amplification User Manual
7 Specification
Specification
Motion Amplification™
Available Lens 6mm, 12mm, 25mm, 50mm,
100mm
Acquisition System i7 processor, 16GB RAM, 500GB
SSD, dual batteries, lightweight,
MIL-STD-810G standard drop
protection, 3 yr accidental damage
protection
Iris M Sample Rate 120/100 fps default, up to 1,300 fps
at reduced resolution
Iris M Frequency Range US: Up to 3,600 cpm @ 120 fps
default
Int: Up to 3,000 cpm @ 100 fps
default
Maximum: 39,000 cpm @1,300
fps with reduced resolution
Iris MX Sample Rate 1,400 fps default, up to 29,000 fps
at reduced resolution
Iris MX Frequency Range Up to 42,000 cpm @ 1,400 fps
default
Maximum: 870,000 cpm @29,000
fps with reduced resolution
Minimum Displacement 0.1 mil (2.5 µm) at 3.3 ft (1m) with
50mm lens at max brightness
Motion Amplification Factor 1-50x
Vibration Pads 95% impulse absorption
Tripod Professional Grade with pistol grip
Case Watertight, dustproof, crushproof
USB3 Cable Length 16.4 ft. (3 m)
Features
Motion Amplification™
Export Format HD MP4 at 1920x1080 resolution
Video Annotations Text, shape and annotations
overlays with export to video
Playback/ Export Video
4x speed to 1/framerate
Speeds
Grid Overlay Configurable grid overlay (size,
color)
Export Options Side-by-side playback of original
and amplified video or amplified
video Only
Logo Export Ability to overlay custom logo
onto exported videos
Image Zoom Exported video shows only
zoomed region
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
84
RDI Motion Amplification User Manual
8 Troubleshooting
Lighting brightens and dims during playback/Motion Amplification.
For indoor recording, check the framerate (fps) during acquisition. If the frame rate is set at a frequency
other than 2x the line frequency a beating (beat frequency) between the frame rate and lighting may occur.
Motion Appears across the entire image.
It is possible the camera was shaking during acquisition. Ensure vibration reduction pads were used during
acquisition.
Motions seem too slow or stops when I adjust playback speed of the amplified video.
It is possible to select a playback speed that affects the way the motion appears in the video. This is the
classic “Wagon Wheel Effect”. For example, if a motion is at 30 Hz and you select a 30fps playback it may
appear stopped or without motion. To accommodate this, it is recommended to try multiple playback speeds
to see what works best for the specific motion you are trying to illustrate.
For more troubleshooting and general support see the RDI Technology Support page.
http://www.rdi-technologies.com/support
9 Revision History
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
85
RDI Motion Amplification User Manual
10 Index
Revised 12/20/2017
Copyright © 2016-17 RDI Technologies Inc.
86