Analysis: The Telepresence Add-In The Telepresence Add-In
Analysis: The Telepresence Add-In The Telepresence Add-In
Analysis: The Telepresence Add-In The Telepresence Add-In
The
The
telePresence
telePresence
Add-in
Add-in
Any copyrights relating to this manual shall belong to Olympus Soft Imaging Solutions GmbH. We at Olympus
Soft Imaging Solutions GmbH have tried to make the information contained in this manual as accurate and
reliable as possible. Nevertheless, Olympus Soft Imaging Solutions GmbH disclaims any warranty of any kind,
whether expressed or implied, as to any matter whatsoever relating to this manual, including without limitation
the merchantability or fitness for any particular purpose. Olympus Soft Imaging Solutions GmbH will from time
to time revise the software described in this manual and reserves the right to make such changes without
obligation to notify the purchaser. In no event shall Olympus Soft Imaging Solutions GmbH be liable for any
indirect, special, incidental, or consequential damages arising out of purchase or use of this manual or the
information contained herein.
No part of this document may be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without the prior written permission of
Olympus Soft Imaging Solutions GmbH.
Windows, Word, Excel and Access are trademarks of Microsoft Corporation which can be registered in various
countries. Adobe and Acrobat are trademarks of Adobe Systems Incorporated which can be registered in
various countries.
Olympus Soft Imaging Solutions GmbH, Johann-Krane-Weg 39, D-48149 Münster, Tel. (+49)251/79800-0, Fax: (+49)251/79800-6060
The telePresence Add-in
What is telePresence? 2
telePresence
Installation 5
Conditions ............................................................................5
Installing Server Software ....................................................5
Installing Client Software .....................................................6
Installation Results ...............................................................7
Configure telePresence Input Channel (client) ....................9
Connecting .........................................................................13
Acquiring and Transferring Images ....................................20
Questions and Answers about Synchronized Image Buffers 21
The Discussion Mode ........................................................22
Viewing the Status of a Connection ...................................23
Transferring Files ...............................................................25
Using the Automatic Stage Controls ..................................26
Controlling the Microscope ................................................27
e_teleP092003
The telePresence Add-in • What is telePresence?
What is telePresence?
The analySIS® telePresence add-in enables two analySIS® workplaces,
connected by a network, to communicate and exchange data. One com-
puter is the server and the other the client. Live-Images and acquired
images can be transferred from the Server to the Client and vice versa. In
addition to that, the client can also remote control the microscope as long as
the microscope supports this.
For the most part, two scenarios are possible between the server and the
client:
• The Server is a "normal" analySIS® workplace which would like to com-
municate with another analySIS® workplace.
• The Server consists of a PC which is not always occupied and can be
remote controlled by the client.
In the first scenario, telePresence enables two experts to discuss and share
their opinions via live-images and acquired images worldwide.
freeze live-images
discussion mode
2
transfer files
disconnect
telePresence
connect telePresence
Server Client
acquire images
disconnect
Forwarding Errors Dealing with error messages in telePresence was tailored for the following
scenario: software messages in the telePresence-Server are automatically
sent to the client, should the server not have reacted to the message for a
period longer than 10 seconds. The client can answer the message for the
server. This avoids that no one reacts to an error message, which would
block the client.
The telePresence Add-in • What is telePresence?
Software-Solutions telePresence is a pure software-solution which does not require any special
hardware or infrastructure (excluding a network).
Installation and The installation of the software does not differentiate itself from a "normal"
Dialup analySIS® installation. The "telePresence" add-in is installed on the Server.
No special analySIS® version is necessary for the client since each version
can adopt the functions of a telePresence client.
An electronic address book within telePresence administers the accessible
telePresence-server. The connection is created, based on TCP/IP-Internet
technology, which offers variable speeds based on the internet connection
and/or the LAN. telePresence automatically selects the server's IP-Address,
which the client requires for dial-up. This address can be sent to the client
via E-Mail and inserted into the address book. Should the client try to create
a connection when the server is not operating, a predefined e-mail will auto-
matically be sent to the previously setup address.
Image Acquisition When making an image acquisition, the camera connected to the micro-
and Transfer scope acquires an image (live image or snapshot). While doing this, the set-
tings made for the selected input channel in the server are taken into con-
sideration.
The acquired image is then transferred via network connection. The most
input channel settings made by the server also influence the way in which
the image's are shown to the client. However the client can make additional
settings in his telePresence input channel. The client can, for example, com-
press the image in order to achieve the best transfer rate.
telePresence has been optimized for FireWire™ digital cameras by Soft
Imaging System and all cameras which can be connected to a GrabBit on
the telePresence server. These can be video cameras as well as digital
cameras.
Microscope and The most important microscope functions can be controlled by the software,
Stage Control as long as the microscope supports it. This holds true both for light-optical
microscopes as well as electron microscopes. In addition, all motorized
stages which are frequently used can also be controlled.
Discussion Mode The telePresence discussion mode enables the images being viewed by
both users to be synchronized. Both users can place their pointers on the
4
Installation
The installation description only refers to the telePresence software. For
installing additional software and hardware (i.e. digital cameras), please
consult the appropriate documentation hereto.
Conditions
Software telePresence Server:
Windows 2000 Professional Operating System / 2000 Server / XP
analySIS® 3.2 including the telePresence add-in
telePresence Client:
Windows 2000 Professional operating system / 2000 Server / XP
analySIS® 3.2 (all versions beginning with Build 757 possible)
Hardware telePresence Server:
ISDN card (recommended AVM C2 or C4) or network card
At least one ISDN-line (a LAN-connection is recommended)
Dongle for the analySIS-Software including the telePresence add-in
telePresence Client:
ISDN card (recommended AVM C2 or C4) or network card
At least one ISDN-line (a LAN-connection is recommended)
5
Software installation is as follows:
1) Insert the analySIS®-CD into the your computer's CD-ROM drive.
> The setup window should open. Should this not be the case, or if
you have closed the window, you can restart it any time by clicking
the Setup.exe on the CD-ROM.
2) Select the analySIS 3.2 menu entry to install the software.
3) Follow the steps in the installation program.
4) When starting the software for the first time after the installation, you
will see the following message:
The telePresence Add-in • Installing Client Software
The restart is necessary because telePresence makes entries into the Win-
dows registry file, which only come into effect after the restart.
5) Restart your computer.
6) When starting the software for the first time after the installation, you
will see the following message:
Installation Results
For information about the After starting, both the client and the server see the Telepresence button
7
Telepresence button bar bar. Only the first two commands will be available, since no connection to
commands during the server has been made yet.
connection, go to page 19
The image window has also changed its appearance. The following new but-
tons are now available:
For settings to this tab, Go Additionally, you will see the new Telepresence tab, when calling up the
to page 16 Extras>Settings command.
8
Configure telePresence Input Channel (client)
3) Select a tab and make the desired changes to the preset parameters
using the comments below.
4) Close the dialog box by clicking OK.
Integrating Macros
You can integrate macros via the Macro tab which are automatically carried
out either before or after image acquisition. One example is the use of a
sharpness filter. This results in two images always being written to the image
buffer: the acquired original image and the image after the use of the filter.
The telePresence client and telePresence server can have different inte-
grated macros. These settings made on the server have no effect on the
client.
Only the original image will always be automatically synchronized. The sec-
ond image buffer can be manually synchronized, if one of the two partici-
pants, for example through the automatic integration of a filter as a postpro-
cessing step, creates two images rather than one image during acquisition.
Note Should you not be familiar with the analySIS® Imaging C macro language,
do the following: acquire a macro with the Macro recorder (Special>Record
Macro) and copy the text from the field via the Windows clipboard respec-
tively into the Preprocessing Steps or Postprocessing Steps field.
10
Macros will only be executed if the Enabled check box has been selected!
Data Compression
The Input tab enables you, amongst other things, to carry out settings for
data compression. This is useful if the data transfer without compression is
too slow. However, it is important to note that compression results in loss of
image details and generates artefacts (faulty display of image information).
16-bit images, for example, are changed to 8-bit images when compressed.
You can choose whether or not you want to compress only live images or to
compress the transferred snapshots as well. We recommend that you first
compress only the live image. Do not compress the snapshots because only
then do all of the image details remain unchanged. Should the snapshot
transfer still be too slow, compress the snapshots as well.
Configure telePresence Input Channel (client)
JPG and JPG2000 are available for you as a means of compressing. The
rate of compression with JPG2000 is higher. However, the compression
lasts longer and so a quicker transfer of data does not necessarily mean that
you actually gain time.
Note The client has yet a second possibility to speed-up the live image transfer:
the size of its image window. The larger the image window, the more data
has to be transferred with live images. Therefore, it makes sense to reduce
the image window by half, should the desired data transfer speed not be
adequate. This step must be made before the live-image acquisition has
taken place, since the size of the image window cannot be altered during
transmission.
Setting Up a Fixed A fixed connection is when a connection is automatically created to the
Connection server if the client has selected the telePresence input channel and has
clicked the Acquisition or Snapshot button. Should the server have the
11
choice of numerous channels, the connection to the input channel selected
when setting up the fixed connection will be used.
Changing the Server´s If a connection to a server exists, you will see the server's input channels in
Input Channel the Channel field as a "sub-channel". This enables you to quickly change to
another input channel.
An even quicker way is if you right click on the camera entry located in the
status bar and select another input channel in the small window. This can be
useful if you installed a room camera onto your server to which you would
often like to switch.
Selecting an input channel
on the server. The server's
input channels appear
indented (entries 2-4 in the
illustration).
The client's input channels
appear left-justified (entry 1
in the illustration) and are
located at the top of the list.
The telePresence Add-in • Configure telePresence Input Channel (client)
Note When you have set-up a fixed connection, you cannot change the server´s
input channels. This can be done via Images>Configure Input> Input.
Additional Settings
On the Display tab, you can look at the image scaling which is set by the
server. However, it cannot be altered. Furthermore, you can adjust whether
or not the image's online histogram and scan rate should also be transferred
(see below).
Transfer Online If you activate this option, the Histogram window will be shown when viewing
Histogram a live image. The online histogram enables you to control a live image's
gray-value distribution during acquisition. In other words, the number of
pixels for each possible gray value (0-4095 at 12 bit) is shown.
12
13
Single Work-Station Single Work-Station The telePresence client should be able to dial-on to the
telePresence server via VPN or ISDN (i.e. via routing
and RAS service)
Note When the telePresence server and client are not running together in one
network, we recommend creating a VPN connection (Virtual Private Net-
work) between the client and the server. Hence, the problem of existing Fire-
walls hindering the communication between the two computers, can be
avoided. A VPN allows the network administrator to make the connection as
safe as necessary.
Should the client confirm with Yes, a pre-defined e-mail will be generated by
his e-mail program:
14
15
the telePresence ID card is valid over a long period of time.
We recommend contacting the client should this not be possible. He/She will
then be able to check this as a first error source during a failed connection.
4) The Related person group enables you to enter further information
about the server. This information is not necessarily vital for making a
connection. The server's e-mail address, or the person responsible, will
however be needed should the client like to automatically send an e-
mail after a failed connection.
The telePresence Add-in • Connecting
You still have two further settings possibilities for a connection located on
the Telepresence tab. These settings are not part of the telePresence ID
card and can be changed at any time.
Connecting
Automatically accept calls: if this check box is selected, the client can make
a connection any time. The changed Telepresence button bar and the
changed cursor shows the server that a successful connection has been
made.
If the Do not disturb check box has been selected, the client will receive the
message "The server refuses any connection at the moment" when trying to
make a connection. He/She then has to contact the server and request the
clearing of the check box.
Limit Datarate: You can limit the amount of data which is transmitted per
second. Thus, it will be prevented that you use a too much of the available
capacity for data transmission for telePresence, resulting in a limited trans-
fer of data available for other participants in the network. Of course, this will
17
result in a slower transmission. You can set the values between 1,000 and
100,000 kBits/second.
Making a Connection
A connection can only be made from the client. At least one entry must be
available in the address book. Before making a connection, you can use the
Ping button to check to see if the network connection is available.
Note Should your image buffer not be empty before making a connection, we rec-
ommend that you save important pictures from the image buffer and then to
empty it afterwards. You then retain an overview, reducing the risk of having
images overwritten during synchronization.
1) Click on the telephone symbol located in the Telepresence button bar
and select the desired participants from the list:
18
Connecting
2) Click Connect.
> The Connect button changes to Disconnect when the connection
has been made. In addition to that, the Telepresence button bar
also changes (see below).
3) Close the dialog box by clicking the Close button. The connection
remains intact and you can work with telePresence. Click the Discon-
nect if you want to immediately disconnect.
Note You can combine steps 2 and 3 by simply double-clicking on the desired
entry in the address book.
See page 15 for information You will get an appropriate message, should a failed connection occur due
about connection errors due to the server being connected to another client.
to dynamic IP-addresses
The cursor and the Telepresence button bar when actively
connected:
When actively connected, the form of the cursor changes both for the client
and the server. Hence, the server immediately knows that the client has cre-
ated a connection.
Furthermore, the Telepresence button bar also changes on both of the com-
puters.
The telephone symbol changes by showing the receiver "off the hook". This
button enables you to disconnect a current connection any time. In addition,
the audio/video communication is now enabled. This button enables you to
also transfer speech and images between the two computers via the existing
connection. (the images from a camera installed to the computer and not the
images from analySIS®, which will be transferred anyway!) To do this, the
Netmeeting software must be installed.
Disconnect
Accessing Control Panel
Audio/Video Communication
Disconnect 19
Both the server and the client are able to disconnect at any time.
1) To do this, simply click on the symbol of the telephone with the receiver
"off-the-hook" located in the Telepresence symbol bar.
> The connection is disconnected without any further queries. The
Telepresence button bar once again returns to its disabled status.
Furthermore, connections will be automatically disconnected when a partic-
ipant ends analySIS®.
The telePresence Add-in • Acquiring and Transferring Images
21
image via the use of a filter? tion image buffer. This image buffer must be manually
synchronized if the other participants also wants to see
the altered image.
What happens if a participant wants to de- The other participant receives an information box which
lete an image buffer which is write protected says that his/her write-protected image buffer will be over-
by another participant? written. He/She, however, can only answer with "yes",
which means that a write protection is ineffective.
The telePresence Add-in • The Discussion Mode
The colors - red for the server and blue for the client - are predefined and
cannot be changed. The overlay is transferred and synchronized separately
from the image, in order to reduce the files to be transferred.
The discussion mode does not function during a live image transfer.
Example of an image in
discussion mode (detail)
Placing a pointer:
1) First, click on the button located on the left hand side in the image win-
dow's button bar. Then click on a section of interest on the image where
the pointer is to be positioned.
> The pointer is displayed in red for the server and blue for the client.
> The image buffer is synchronized so that the other participants also
22
Delete Overlay:
1) Click the button shown in the illustration on the left.
> Not only the last entry, but the entire overlay is deleted.
> The image buffer is synchronized.
Viewing the Status of a Connection
What is the difference between the overlay which is created with the
Standard button bar in analySIS® and the overlay which is created with
the buttons located in the image window during a telePresence
session?
The only difference is that the button in the image window showing a pencil
has preset colors - red for the server and blue for the client - so that the origin
of the markings can clearly be identified. In addition, the pointer can only be
placed using this button. The telePresence buttons located on the left can
either be used alternatively or together with the buttons of the standard over-
lay. Therefore, you can, for example, place a pointer into the image and then
insert a text.
23
The telePresence Add-in • Viewing the Status of a Connection
Field Meaning
Server Name of the server, when calling the dialog box from the client, or the name of the
client, when calling from the server.
Status Here you will see whether or not an existing connection is a uni-directional or a bi-di-
rectional one, whereby these settings cannot be altered. Otherwise, you will see the
text, "You are currently not connected".
Duration Duration of the current connection. This value cannot be reset with the Reset button.
24
Response Here you will see how much time the server needs to react to the client's demand.
The server, on the other hand, sees how much time the client needs to react. These
values can vary based on the amount of traffic in the net.
Data rate The amount of Kbits that are transferred per second. This amount can vary based on
the amount of traffic in the net.
Data The amount of data which has been transferred since last starting the connection or
since the last reset.
Snapshots Amount of transferred images. These can be either frozen live-images or other im-
ages.
Live Images The live-image is constantly being transferred in regular intervals, not depending on
whether the image has changed or not. Here you can see the amount of snapshots
which have been transferred since starting the live image.
Transferring Files
Transferring Files
During a telePresence session, you can also use the existing connection of
the two computers to transfer files. This can be useful, for example, if you
have made notes in a word-processing program during a telePresence ses-
sion and you want to send these to the other participant. These files are no
longer available after a session has ended. Here is what you do:
Transferring Files
1) Click the Control panel symbol located in the Telepresence button bar.
2) Switch to the File Transfer tab and click Add....
3) Select the file to be attached. More than one file can be transferred.
4) Close the dialog box by clicking the cross in the upper right corner.
> The file will now be transferred to the other participant.
> Inform the other participant that you have transferred him/her a file.
Viewing and saving
transferred files
1) Click on the Control Panel.
2) Switch to the File Transfer tab and select one file when there are
numerous files.
3) Open the file (if you have the appropriate program to display) or save
the file.
4) Repeat this step with additional files, if need be. Only one file can be
selected.
5) Remove... enables you to remove files from the dialog box. This step,
however, is not absolutely necessary since the files are automatically
removed from the dialog box after the connection has been ended.
6) Close the dialog box by clicking the cross in the upper right corner.
25
The telePresence Add-in • Using the Automatic Stage Controls
The stage can be moved in all directions. The buttons with the white arrows
move the stage on the X/Y axis, which means left, right, forwards, back-
wards or diagonally.
The XY-Increment determines by what percent the view is to be moved. The
26
setting of 10% moves the current view 10% in the desired direction. Hence,
the image remains, in general, very similar. When using a large increment
of let's say 90%, the view changes very drastically; you see a new section
of the sample.
The buttons with the gray arrows enable you to move the stage on the Z-
axis, which means up or down. Since the microscope has a certain focal dis-
tance, this movement also enables you to influence the sharpness of the
image. The boldly outlined arrows are for large movements and the thinly
outlined arrows are for fine movements.
Controlling the Microscope
27
Installation 4
A Integrating Macros 10
Address Book 4 intX (intelligent exposure) and telePresence 20
Automatically accept incoming calls 17
L
C Limiting the data rate 17
Clean-room 3
Compress Images 4
Compressing Data 10 M
Controlling Microscope Functions 4 Macro Recorder 10
Creating Overview Images 27 Making a connection from the client 18
Manually Synchronizing Image Buffer 20
Moving pointer 22
D
Definite (fixed) IP address 15
Delete Overlay 22 O
Difference between standard overlay and Online Histogram 12
telePresence overlay 23
Disconnect 19
Discussion Mode 4, 22
Dongle 5
P
Double-Arrow Symbol 20 Ping 17
Dynamic IP addresses 15 Positioning the pointer 22
E R
Electronic Address Book 4 Reset 23
Error Restarting the client after installation 7
failed connection 15 Restarting the server after Installation 6
29
Error Messages from the Server 3 Room Camera 11
F S
Firewalls 13 Scan Rate 12
Fixed Connection 11 Server
Forwarding the server's error messages 3 IP-Address 4
Server's IP-Address 4
Server’s IP-Address 15
I Setup.exe 5
Software version for the telePresence client 4
ID-Cards 14 Stage 6
Image Device (digitizer) 6 Synchronizing Image Buffer Manually 10
Image Scaling 12 Synchronizing the Overlay 22
Image Transfer 4
Image Transmission Speed 9
Imaging C 10
Index
T
Telepresence Button Bar 7
telePresence ID Cards 14
Transferring Files 25
V
Viewing Connection Data 23
Virtual Private Network 13
W
Warning for failed connections 19
Work in the clean-room 3
Write-Protected Image Buffers 21
30