Exporting L*a*b*, XYZ, and L*C*h. Set Up

Transcription

1 Exporting L*a*b*, XYZ, and L*C*h Set Up This document describes the steps for instructing ShadeVision v.3.01 to export the XYZ and L*a*b*C*h data values associated to its measurements. In order for ShadeVision v.3.01 to export its numeric data to an output file, it must be run in export data mode. To run ShadeVision v.3.01 in this mode, its executable must be run with the following command line parameter: /exportdata. 1. Right-click the ShadeVision desktop shortcut and select Copy. Right-click on the PC s desktop and select Paste to place a copy of the ShadeVision shortcut. Right-click the new shortcut and select Properties from the popup menu. Edit the new shortcut s Target property as follows: Target: "C:\Program Files\X-Rite\ShadeVision\dvs.exe" /exportdata This assumes that ShadeVision is installed in the default location. Be sure to include a single space before the /exportdata in the target property as shown below. Select Apply and then OK to save these changes. 2. Right-click the new shortcut and select Rename to name this new shortcut something other than ShadeVision. We will use the name Lab data in this example. When using this Exportdata feature, open the software with the new shortcut ( Lab data in this example), not the original ShadeVision icon.

2 3. When running the ShadeVision program with the new shortcut, XYZ and L*a*b*C*h data is automatically generated after viewing measurements in the Group Editor. A line of data is output to the file for each measurement when you select the Average or Color Grid tab in the Group Editor. 4. The name of the output file is ExportData.txt and is located in the same directory as the ShadeVision executable (default is: c:\program files\x- Rite\ShadeVision). When running ShadeVision, if the ExportData.txt file does not exist, it will be created. If it exists, the new data will be added to the existing file. 5. Each line of the output file represents the data associated with the gingival, dentin, or incisal area of each measurement in the group. Each data entry is Tab delimited. This allows the file to be directly opened and imported into Microsoft Excel or other similar spreadsheet programs. To load the ExportData file into Excel, perform the following steps: 1. Left-click the Windows Start and then select Search or Find. Select Files and Folders in the local hard drive and then select Search or Find (depending on your operating system). The example below is from Windows XP.

3 2. Right-click the Excel.exe application file (highlighted in previous screen grab) listed in the Search Results window, select Send To, and then click on Desktop (create shortcut) to place a shortcut to Excel.exe on the PC s desktop. 3. Right-click on this new Shortcut to Excel desktop icon and then select Properties. In the Target: path, add a single space, quotation mark, the path to the exportdata.txt file, followed by another quotation mark (default will be: "c:\program files\x-rite\shadevision\exportdata.txt"). The new Target path in this example would be as follows: "C:\Program Files\Microsoft Office\Office10\EXCEL.EXE" "c:\program files\xrite\shadevision\exportdata.txt" 4. Select Apply and then OK to save these settings. 5. Right-click the Shortcut to Excel desktop icon and then select Rename to label it appropriately. 6. Each time that this shortcut is double-clicked in the future, the ExportData.txt file will be viewed in Excel. 7. The first row contains the column headings. Resizing the columns can help view the data contained in each column. 8. To retain this data, save the Excel spread sheet as an.xls file for future reference. Note: The original ExportData.txt file remains intact. After Average or Color Grid is selected while running ShadeVision in ExportData mode, data will continue to be added to the file. To start a new ExportData.txt file, simply delete the existing one in the ShadeVision folder (a new file will be created as needed). Creating a desktop shortcut to this folder might prove useful. Warning: While running ShadeVision in ExportData mode, no other program on the PC is allowed to have the ExportData.txt file open at the same time. If this conflict occurs, an I/O Error will be displayed in ShadeVision. This means that two programs were trying to access the same file at the same time. Simply close the other program (for example: Excel) that is accessing the ExportData.txt file and continue to run ShadeVision as usual.

4 Viewing the data in Excel The first line of the file consists of the column headings: Patient Name, Patient ID, Work Order, Tooth ID, Tooth Area, Date, Time, X, Y, Z, L*, a*, b*, C*, h. While viewing the Average and Color Grid tabs for a group, data for each tooth is exported to the ExportData.txt file. A typical Excel spreadsheet might look like the following: If viewing the Average tab, the averaged color data for the dentin area is appended to the file. If viewing the Color Grid tab, the average of each tooth s gingival, dentin, and incisal areas are appended. NOTE: Only the shaded elliptical areas shown in the Average and Color Grid tabs are being used for calculating the average color data for the gingival, dentin, or incisal areas.

5 Sample Protocol for Tracking the Progress of Bleaching There are a growing number of ShadeVision customers that are using the system to track the progress of tooth bleaching. Some researchers are set up by X-Rite to export raw color data to a Microsoft Excel spreadsheet in the form of XYZ, L*a*b*, and L*C*h. While this data can be confusing and virtually useless to a dentist or dental lab technician, a researcher with significant color science background can find this data quite useful. The following suggested protocol might be helpful whether you are comparing raw color data, shade tab assignments, or simply the side-by-side comparison of the images. This protocol is only a suggested outline that the clinician might or might not find useful to follow. Suggested Protocol 1. Measure the patient and create a work order prior to bleaching treatment to create a baseline. Make sure to follow proper targeting procedures as outlined on the ShadeVision Training CD. When you are prompted to enter a Work Order Number, use whatever is appropriate for your situation ( Bleach00562 in this example) as shown below.

6 2. Assuming that all upper anteriors are measured, the resulting baseline work order could be viewed in any of the tabs. This baseline example is displayed in each the Full Color and Average views in the following two images. 3. When the patient ( John Doe in this example) returns after a bleaching session, the clinician can easily track the progress by again measuring the patient s anteriors. Select Measure Patient from the home screen of ShadeVision.

7 4. Make sure to select the patient from the drop down list of patient names in the resulting Measure Patient Wizard window as pictured next. 5. Properly target the same anterior teeth as in the baseline work order. Upload the measurements and define the active tooth area in the same manner as the original work order. After all teeth are properly defined, click the green check in the lower right corner of the window. 6. In the resulting Store Measurements window, select Add to existing work order, select the work order to add these to, and then select the green check. Only work orders associated to the selected patient will appear in this box. In this example, the work order number was Bleach00562, as shown below.

8 7. The software will return to the ShadeVision home screen. Now simply open the work order to view both the original set of measurements (baseline) along with the new measurements of the patient following treatment. 8. Click on the Auto Arrange icon ( 123 on the toolbar) in the Group Editor window to arrange the teeth in an orderly fashion. The teeth will display with the latest measurements on top and chronologically from left to right as determined by the tooth number selected by the operator. Expect this to look as the following image. 9. The groups of teeth (before and after bleaching) can be compared visually and/or numerically. Select Full Color, Average, Color Grid, or Color Map to compare according to the clinician s wishes. You can compare Color Analysis data on individual teeth as well by selecting the icon and then the teeth to compare. 10. If the patient returns a third, fourth, or fifth time to be re-evaluated, more measurements can be added using the same method as outlined in the previous steps. All measurements will be added to the original work order. Select the Auto Arrange icon again as described in step #8 to arrange the groups of measurements from the latest (top group) to the rest in descending order. In the next example image; the top group of anterior measurements are the latest group

9 of teeth targeted followed by the middle group (second group targeted) and then the baseline group (first group targeted) is the bottom group of anteriors.

10 11. For those researchers using our ExportData utility to display the raw color in the Excel spreadsheet, clicking on the Average tab and then opening the spreadsheet will give add the following data added to the existing Exportdata spreadsheet. 12. Note that each individual tooth s color data is listed from the first (baseline) to the last measurement uploaded for that particular tooth. This allows researchers to quickly compare the color change associated with all teeth over time.