Articles in this section

See more

Setting up the acquisition agent

Avatar
GW - Technical Writer
Updated
Follow

Because Dentrix Ascend Imaging is a web-based application, it is available immediately for use once you have purchased it and it is enabled by Henry Schein One. However, for each computer that you want to acquire images from, you must install the following on that computer:

  • Drivers - The drivers for the intraoral and/or extraoral acquisition devices that you want to use. For the complete list of acquisition devices that are supported by Dentrix Ascend Imaging, see "Supported Acquisition Devices."

  • Acquisition agent - A small application that runs in the background and handles the communication between your acquisition devices and Dentrix Ascend Imaging. You do not need to install the acquisition agent on computers that you will be using to only view images.

    Note: During the installation of the acquisition agent, a security certificate is installed automatically to allow for secure communication between the browser running Dentrix Ascend Imaging and the acquisition agent.

Setting up the acquisition agent consists of the following three tasks:

  • Downloading

  • Installing

  • Configuring

Downloading

You can download the acquisition agent installer by attempting to acquire an image on a computer that you want to use to acquire images. A message will appear and provide you with a link to download the acquisition agent installer.

Note: Alternatively, you can access the link to download the acquisition agent installer in Dentrix Ascend. On a computer that does not have the acquisition agent installed, open the Document Manager while viewing any patient's record, and then click (or tap) Scan.

To download the acquisition agent

  1. Attempt to acquire an image (see "Acquiring Images").

    If the acquisition agent is not installed, the Acquisition Activation dialog box appears.

  2. Click (or tap) the Click here link to download the acquisition agent installer.

  3. Click (or tap) Done.

  4. When the download is complete, you can install the acquisition agent.

Installing

You must install the acquisition agent on each computer that you want to use to acquire images. Complete the steps that correspond to the operating system of the computer that you are installing the acquisition agent on: Windows or Macintosh.

Notes:

  • (Windows only) Prior to installing the acquisition agent, verify that the Microsoft .NET 4.0 framework is installed. If .NET 4.0 is not installed, you must install it before you attempt to install the acquisition agent.

  • Before attempting to install the acquisition agent, you should be logged on to your operating system (Windows or Macintosh) as a local administrator (not as a domain administrator).

To install the acquisition agent (Windows)

  1. Run Acquisition Agent Installer.exe.

  2. On the welcome screen, click (or tap) Next.

  3. On the Choose Components screen, leave Acquisition Agent selected, and then click (or tap) Next.

  4. On the Choose Install Location screen, leave the default Destination Folder selected, or click (or tap) Browse to select a different location. Then, click (or tap) Install.

  5. On the completion screen, click (or tap) Finish.

  6. After installing the acquisition agent, you can install the drivers for your acquisition devices and change the default settings of the acquisition agent (even though the defaults should suffice).

To install the acquisition agent (Macintosh)

  1. Run Acquisition Agent Installer.pkg.

    Troubleshooting: If an error with the message "Acquisition Agent Installer.pkg can't be opened because Apple cannot check it for malicious software." appears, complete the following steps:

    1. With the error message still open, open the System Preferences.

    2. Select Security & Privacy.

    3. On the General tab, click the lock icon.

    4. If you are prompted to do so, enter your MacOS User Name and Password, and then click Unlock.

    5. Under Allow apps downloaded from, select App Store and identified developers.

      Note: The error message needs to be open to see this option.

    6. Click Open Anyway, follow the prompts, and eventually the acquisition agent installer should start.

  2. On the Introduction screen, click Continue.

  3. If the Destination Select screen appears, select the disk where you want to install the program. Then, click Continue.

  4. On the Installation Type screen, click Install.

  5. If the system prompts you to do so, to allow the installer to install the program, enter your MacOS User Name and Password, and then, click Install Software.

  6. On the Summary screen, click (or tap) Close.

    Note: After installation, the acquisition agent starts automatically. The first time the acquisition agent starts, it will need 90-120 seconds to finish its configuration. When acquisition agent icon stops bouncing, the configuration is complete.

  7. After the initial configuration is complete, right-click the Acquisition Agent icon on the dock, point to Options, and then select Open at Login if the option does not already have a check mark next to it.

  8. Restart the computer to finish the required setup.

  9. After installing the acquisition agent, you can install the drivers for your acquisition devices and change the default settings of the acquisition agent (even though the defaults should suffice).

Configuring

If you need to change the default settings of the acquisition agent (even though the defaults should suffice), after you complete the installation, configure the acquisition agent's options as needed. Complete the steps that correspond to the operating system of the computer that you are configuring the acquisition agent on: Windows or Macintosh.

To configure the acquisition agent (Windows)

  1. Click (or tap) the Acquisition Agent icon in the notification area of the Windows taskbar, and then click (or tap) Preferences.

    The Preferences dialog box appears.

  2. Set up any of the options on the following tabs as needed:

    • General

      General tab

      • Joystick - If you use a "Generic" intraoral camera with a joystick button interface instead of proprietary buttons, select the Use Joystick with Generic Camera check box. The camera button will use a specific joystick number. This is typically zero if no other joysticks are installed on the computer. Enter a number from 0 - 10 for Joy Number.

        Note: If you use a Digital Doc camera, and it has been installed to use a port other than zero, you must specify the appropriate joystick number.

      • Still Pin - If you use a "Generic" intraoral camera with a still pin to initiate captures, you must install still pin support for that camera. Make sure that the camera is plugged in and that all the necessary drivers for that device are installed before you attempt to install still pin support. Click (or tap) Install Still Pin Support, click (or tap) OK on the message that appears, select the camera that you want to install still pin support for, and then press the Enter key when the installation is complete. The Use still pin with Generic Camera check box is selected automatically, but you can clear the check box if at any time you decide that you do not want to use a still pin camera.

      • Grayscale JPEG Compression - Dentrix Ascend Imaging can use JPEG lossy compression or PNG lossless compression for grayscale images (intraoral and extraoral X-ray images). To specify the compression method for a device, select that Device, and then select or clear the Use JPEG Compression check box. By default, this check box is selected for every acquisition device. With this check box selected, Dentrix Ascend Imaging uses a JPEG lossy compression (which has been optimized for grayscale images and uses a Q factor of 96) to obtain near-perfect-quality images. With this check box clear, Dentrix Ascend Imaging uses PNG lossless compression (which may produce larger file sizes and negatively impact the performance of uploading and downloading images). Repeat this process as needed for any other devices.

      • Alternate Button Workflow - For the following intraoral cameras, you can specify whether you want to use an alternative functionality for the capture button or use the standard functionality: generic cameras, DEXcam 3 and 4 cameras, Sopro cameras, and Digital Doc Iris and Iris HD cameras. With the alternative button functionality enabled for a camera, after you push the button once to freeze the video stream, you either push once to capture the image or push twice to not capture it. The standard functionality does not support pushing the button twice to not capture the video frame. To specify the button functionality for a camera, select that Device, and then select or clear the Use Pause/Capture Workflow check box. Repeat this as needed for any other devices.

      • Show Log Files - The acquisition agent logs actions that it performs for debugging, troubleshooting, and performance monitoring. To view the log, click (or tap) Show Log Files.

    • Digital Sensor

      Digital Sensor tab

      • DEXIS:

        • Use Binned Acquisition - In the Dexis imaging software (versions 9 and 10), "binned" is the default operating mode for Dexis sensors, so this check box is selected by default for Dentrix Ascend Imaging.

        • Correction Path - This is the location of the calibration files for Dexis sensors. The default is C:\Dexis\Flashdir.

      • Hamamatsu Correction Path - This is the location of the calibration files for Hamamatsu sensors. The default is C:\Program Files (x86)\Acquisition Agent\Correction Files.

      • e2v Correction Path - This is the location of the calibration files for e2v sensors. The default is C:\Program Files (x86)\Acquisition Agent\Correction Files.

      • Hamamatsu - The Gamma correction value defines the relationship between a pixel's numerical value and its actual luminance; use it to redistribute the tonal levels of a raw image to be closer to how human eyes perceive them (on a standard monitor). The Integration Time, Incidence Threshold, and Integration End Threshold options determine how Dentrix Ascend Imaging control the integration timing and triggering of sensors. You may want to change these settings if, for example, you use a low-dose, portable X-ray machine.

      • Planmeca - For Planmeca sensors, "binned" is the default operating mode, so the Use Binned Acquisition check box is selected by default for Dentrix Ascend Imaging.

      • e2v Settings - Click (or tap) the button to configure the following settings for e2v sensors:

        • Size 1, Size 2 - Configure the settings for size 1 sensors separately from those of size 2 sensors:

          • Use Binned Acquisition - Controls whether "binned" operating mode is on or off.

          • Sensor Gain - Controls the output signal strength from sensors.

          • Integration Time - Determines how Dentrix Ascend Imaging controls the integration timing of sensors. You may want to change this if, for example, you use a low-dose, portable X-ray machine.

          • Triggering Level - Determines how Dentrix Ascend Imaging controls the triggering of sensors. You may want to change this if, for example, you use a low-dose, portable X-ray machine.

          • Gamma Level - Defines the relationship between a pixel's numerical value and its actual luminance; use it to redistribute the tonal levels of a raw image to be closer to how human eyes perceive them (on a standard monitor).

        • Do Not Use Sensor Calibration Files - Controls whether the sensor calibration files are used or not.

        • Rotate Size 2 Image (XDR) - Controls whether images that are captured using size 2 sensors are rotated or not.

      • Schick Settings - Click (or tap) the button to configure the following settings for Schick sensors:

        • Xray (the availability of these options may vary):

          • Hardware Type - To automatically detect and select either the sensor that is currently connected or the sensor that was most recently connected, select the Use CDR Autodetect check box. To manually select the sensor, clear the Use CDR Autodetect check box, and then select the correct device from the list of recognized devices.

          • Exposure Timeout - Controls the amount of time (in seconds) to wait for exposure before timing out. This applies only if the "AutoTake" acquisition mode is off.

          • Integrate Phoenix - Displays the amount of time (in tenths of a second) that an APS sensor will spend in "integrate" mode.

          • Integrate Time - Controls the amount of time (in tenths of a second) that an image is accumulated.

          • Reset Duration - Displays the amount of time (in milliseconds) that an APS sensor will spend between triggering and acquisition.

          • Trigger Thresh - Indicates the threshold when an image has been acquired (also called AUTO_THRESH).

          • Trigger Count - Indicates the count when an image has been acquired (also called AUTO_COUNT).

          • IO Port - Displays the I/O address that was used by the interface board of previous sensors.

          • Initial Rampup - Displays the time (in seconds) that is required by the sensor before the first X-ray exposure.

          • Second Rampup - Displays the time (in seconds) that is required by the sensor after the first X-ray exposure and between subsequent exposures.

          • Use Perfect Shot - (If available) Indicates that a filter to correct slightly under- and over-exposed images and to display changes in tooth density will be applied automatically.

          • Calibrate Image - With this check box selected, the calibration file for the connected sensor is used. With this check box clear, the calibration file, which is unique to the sensor, is not used, which may result in artifacts that would be otherwise removed on captured images.

          • Auto Accept Image - With this check box selected, the Accept / Reject / Retake window does not open, and the acquired image is presented in the Exam or Zoom window, depending on other user options. With this check box clear, the Accept / Reject / Retake window does open. This applies only if the "AutoTake" acquisition mode is off.

          • Equalize Image - Indicates that images will be equalized automatically.

          • Apply Spot Remover - Indictaes that a function to eliminate random noise artifacts in images will be applied automatically.

          • Subtract dark image - Controls whether subtraction will be used to eliminate noise caused by the sensor's dark signal or not.

          • Acquire 12 bit image - With this check box selected, images will be acquired using the entire 12-bit grayscale range (which is recommended for the DICOM image format). With this check box clear, images will be acquired using an 8-bit grayscale.

          • Automatic Exposure Control - Indicates that slightly under- or over-exposed images will be corrected automatically. This applies whenever the Perfect Shot filter is applied.

          • Mapping - Indicates that a particular mapping will be applied to show more image detail: Nonlinear (Traditional), in mid-range pixel values; Arcsine, in upper and lower pixel values; or Linear, when pixel values are mapped exactly to the image values that can be displayed.

        • Calibration:

          • Calibration File Path - The default path where the calibration files are located. To change the path, click (or tap) Change Path, select a folder, and then click (or tap) OK.

          • Calibration File List - The calibration files that are available on the computer. To Install a new calibration file, click (or tap) Install New Calibration File, locate and select the correct calibration file (a .cor file), and then click (or tap) Open.

        • Sensor:

          • Sensor Type - The type of sensor that is connected currently.

          • Sensor Serial # - Displays the serial number of the sensor that is connected currently..

          • Sensor Size - Displays the size (0, 1, or 2) of the sensor that is connected currently.

          Note: To refresh the sensor type, serial number, and size, click (or tap) the Recheck button.

        • Elite/Schick 33 Image:

          • Schick Elite - Controls whether enhancements will be applied automatically to images that are captured using Schick Elite sensors. To have enhancements be applied, select the Apply Image Enhancement check box, and then select a level of enhancement from the Level list: Edge High, Edge Low, Edge Pro, or Smooth. To not have enhancements be applied, clear the check box.

          • Schick 33 - Controls the resolution of images that are captured using Schick 33 sensors and whether an enhancement is applied or not. Set up the following options:

            • Resolution - From the list select a resolution: High, to acquire images in unbinned mode (15 microns/pixel) with a practical resolution of 28 lp/mm (line pairs per millimeter); or Standard, to acquire images in binned mode (30 microns/pixel) with a practical resolution of approximately 24 lp/mm.

            • Apply Fixed Enhancement - Controls whether the enhancement will be applied or not.

        • AE Image - To control the level of sharpening that will be applied to images for the various types of filtering, move the slider to the left or right to decrease or increase the percentage. To see how the specified sharpness level will affect images for the various types of filtering, from the Task list, select each option (General Dentistry, Endodontic, Restorative, and Periodontic) in turn.

    • Phosphor Plate

      Phosphor Plate tab

      • ScanX - These are filters to use with a ScanX phosphor plate scanner. The Gamma correction value defines the relationship between a pixel's numerical value and its actual luminance; use it to redistribute the tonal levels of a raw image to be closer to how human eyes perceive them (on a standard monitor). The Intraoral Mode, Panoramic Mode, and Cephalometric Mode values indicate the scanning modes being used for intraoral, panoramic, and cephalometric images, respectively. The mode affects image resolution.

      • Optime Settings - Click (or tap) the button to configure the IAM settings for an Optime scanner.

      • OP30 Settings - Click (or tap) the button to configure the IAM settings for an OP30 scanner.

      • VistaScan - The Device Type (the default is IMDA) and the Registered Device of a VistaScan scanner. You can leave the Registered Device box blank to use the first device found that matches the specified type.

    • TWAIN

      TWAIN tab

      • TWAIN - The Use Buffered TWAIN Transfer option is selected by default as the transfer method for images from acquisition devices that use a TWAIN driver. If there are issues with TWAIN sources delivering images properly to the acquisition agent, clear this check box to use the native transfer mode, which some TWAIN sources require or recommend.

      • TWAIN Categories - For each TWAIN source, you can specify the applicable acquisition types. Select a TWAIN source from the Device list, and then select the applicable acquisition types (Digital Sensor or Phosphor Plate, Panoramic, Cephalometric, and/or Intraoral Camera). The selected TWAIN source will only be available for selection in the device list when someone is acquiring images for one of the selected acquisition types. Repeat this as needed for any other TWAIN sources.

      • TWAIN Rotation - For each TWAIN source, you can specify the default orientation (rotation and/or flip) to apply to images by acquisition type prior to those images being delivered to Dentrix Ascend Imaging. Select a TWAIN source from the Device list, select an acquisition type (Digital Sensor, Phosphor Plate, Panoramic, Cephalometric, or Intraoral Camera) from the second list, and then select an orientation option (No Rotation, Rotate 90, Rotate 180, Rotate 270, Mirror, Rotate 90 + Mirror, Flip, or Rotate 90 + Flip) from the third list. Repeat this as needed for any other TWAIN sources.

    • Software Bridge

      Software Bridge tab

      • DEXIS - If someone selects the Dexis software bridge from the device list when acquiring an image, the Application Path (where the Dexis software is installed; the default is C:\DEXIS) and the Images Path (where the Dexis software stores images; the default is C:\DEXIS\DATA) must be correct, so Dentrix Ascend Imaging can open the Dexis software and have bi-directional communication with it. The Dexis software must be installed to use this software bridge.

      • SIDEXIS - If someone selects the Sidexis software bridge from the device list when acquiring an image, the Application Path (where the Sidexis software is installed; the default is C:\Program Files\Sirona\SIDEXIS4), the SLIDA Mailbox Path (the location of the SLIDA mailbox file; the default is C:\PDATA), the Ascend Mailbox Path (the location of the Dentrix Ascend mailbox file; the default is C:\ProgramData\Acquisition Agent), the SLIDA Mailbox File name (the default is siomin.sdx), and the Dentrix Ascend Mailbox File name (the default is Ascend.sdx) the must be correct, so Dentrix Ascend Imaging can open the Sidexis software and have bi-directional communication with it. The Sidexis software must be installed to use this software bridge.

      • Romexis - You can specify whether Dentrix Ascend Imaging imports the STL model file or not if someone selects the Romexis software bridge from the device list when acquiring a 3D model. With the Import STL Models check box selected, Dentrix Ascend Imaging will import the STL model file. This allows for rotating and zooming of the 3D model in Dentrix Ascend Imaging. With the Import STL Models check box clear, Dentrix Ascend Imaging will import a 2D snapshot image of the 3D model. The Romexis software must be installed to use this software bridge.

        Note: Because Dentrix Ascend Imaging cannot do all the things that a CAD/CAM software can do, whether or not you import the STL model file, you must do the ground design and editing of the 3D model in the Romexis software. If you do not care about having the STL model file uploaded to Dentrix Ascend Imaging for backup, disaster recovery, or sharing purposes, you may want only the minimal viewing capabilities of a 2D image in Dentrix Ascend Imaging.

    • Filters

      Filters tab

      • Acquisition Filters - For each acquisition device, you can specify a set of filters to apply to images to fine tune those images more than what Dentrix Ascend Imaging does by default. Select a Device, and then set up the following filters as needed:

        • Apply Gamma Correction - To customize this filter, select the check box, and then enter the amount of Gamma correction. The gamma correction value defines the relationship between a pixel's numerical value and its actual luminance; use it to redistribute the tonal levels of a raw image to be closer to how human eyes perceive them (on a standard monitor).

        • Apply Pre Smoothing - To customize this filter, select the check box, and then enter the Strength of the smoothing effect.

        • Apply Sharpening - To customize this filter, select the check box, and then enter the Effect and the Strength of the sharpening effect.

        • Apply Post Smoothing - To customize this filter, select the check box, and then enter the Strength of the smoothing effect after the sharpening filter is applied. The Apply Post Smoothing check box is available only if the Apply Sharpening check box is selected.

        Repeat this as needed for any other devices.

      • Schick Filter - You can specify the following types of sharpness adjustments to apply to an image that is acquired with a Schick device, according to the type of image that is acquired: General Sharpness, Endodontic Sharpness, Periodontic Sharpness, Caries Sharpness, and Hygiene Sharpness.

    • DICOM

      DICOM tab (this tab is available only if support for DICOM has been enabled)

      • Compress DICOM Volumes - Controls whether 3D volumes are compressed or not.

      • Cache DICOM Volumes - Controls whether 3D volumes will be cached locally or not.

        With this check box selected, in the Cache folder box, either enter the path to the folder where you want to store cached 3D volumes, or click (or tap) Browse to select the correct folder.

  3. Click (or tap) Done.

To configure the acquisition agent (Macintosh)

  1. Click the Acquisition Agent icon on the dock.

  2. From the Acquisition Agent menu, click Preferences.

    The Acquisition Agent Preferences dialog box appears.

  3. Set up any of the following options as needed:

    • Planmeca:

      • Use Binned Acquisition - For Planmeca sensors, "binned" is the default operating mode, so this check box is selected by default for Dentrix Ascend Imaging.

      • Import STL Model - You can specify whether Dentrix Ascend Imaging imports the STL model file or not if someone selects the Romexis software bridge from the device list when acquiring a 3D model. With the Import STL Model check box selected, Dentrix Ascend Imaging will import the STL model file. This allows for rotating and zooming of the 3D model in Dentrix Ascend Imaging. With the Import STL Model check box clear, Dentrix Ascend Imaging will import a 2D snapshot image of the 3D model. The Romexis software must be installed to use this software bridge.

        Note: Because Dentrix Ascend Imaging cannot do all the things that a CAD/CAM software can do, whether or not you import the STL model file, you must do the ground design and editing of the 3D model in the Romexis software. If you do not care about having the STL model file uploaded to Dentrix Ascend Imaging for backup, disaster recovery, or sharing purposes, you may want only the minimal viewing capabilities of a 2D image in Dentrix Ascend Imaging.

    • DEXIS Platinum - For DEXIS Platinum sensors, "binned" is the default operating mode for direct integration, so the Use Binned Acquisition check box is selected by default for Dentrix Ascend Imaging.

    • RealCloud HD1 - Dentrix Ascend Imaging can automatically detect the port that the RealCloud HD1 intraoral camera is using so the buttons function properly, or you can specify a port. By default, Auto-Detect is selected as the Port.

    • Grayscale JPEG Compression - Dentrix Ascend Imaging can use JPEG lossy compression or PNG lossless compression for grayscale images (intraoral and extraoral X-ray images). To specify the compression method for a device, select that Device, and then select or clear the Use JPEG Compression check box. By default, this check box is selected for every acquisition device. With this check box selected, Dentrix Ascend Imaging uses a JPEG lossy compression (which has been optimized for grayscale images and uses a Q factor of 96) to obtain near-perfect-quality images. With this check box clear, Dentrix Ascend Imaging uses PNG lossless compression (which may produce larger file sizes and negatively impact the performance of uploading and downloading images). Repeat this process as needed for any other devices.

    • Show Log Files - The acquisition agent logs actions that it performs for debugging, troubleshooting, and performance monitoring. To view the log, click Show Log Files.

  4. Close the dialog box.

Related Topics

Related Errors/Questions

  • None

Related articles

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk