VitalView Activity & Data Viewer User Manual Version 1.3 For Technical Assistance please contact STARR Life Sciences at 866-978-2779 STARR Life Sciences Corp., 2015
Table of Contents 1.0 Vital View Activity Monitoring System Quick Start Guide... 2 1.1 Install Software... 2 1.2 Setup USB Hardware... 2 2.0 Vital View Activity Monitoring System User Manual... 5 2.1 Operating the Software... 5 2.2 Configuration... 5 2.3 Starting a Data Acquisition Session... 7 2.4 Zoom... 8 2.5 Data Export... 9 2.5.1 AWD Conversion... 10 2.6 Stopping a Data Acquisition Session... 11 2.7 Minimum system requirements:... 11 2.8 USB Accessories... 11 2.9 Troubleshooting... 11 2.9.1 Setup Problems... 12 2.9.2 Runtime Problems... 12 3.0 Vital View Data Viewer User Manual... 13 3.1 Loading Data... 13 3.1.1 Load Data... 13 3.1.2 Load Legacy Data... 13 3.2 Zoom... 14 3.3 Filter... 14 3.4 Convert to AWD... 15 3.5 Save Filtered Data... 15 VV-A/VV-DV 1.1 1
1.0 Vital View Activity Monitoring System Quick Start Guide 1.1 Install Software 1) Insert the VitalView Activity software CD into the CD drive of your PC. If installation does not start automatically open the CD drive through your computers file browser and double click on Autorun.exe. Complete steps 1-4 in the installer and follow the onscreen prompts. After installing all components restart your computer and proceed to step 2 below. 1.2 Setup USB Hardware The DataPort 1224 connects to a PC using standard USB 2.0. Multiple DP1224s can be connected using powered USB 2.0 hubs. The example above is for illustrative purposes. Your setup will depend on equipment purchased and the layout of your lab. 2) If not using any USB hubs proceed to step 3 below. If using USB hub(s), attach each hub one at a time. After you attach each hub wait until Windows recognizes and installs device drivers before connecting the next hub. When Windows is finished installing drivers for each hub the message below should appear in the lower right corner of the Windows Desktop. To ensure proper operation you should use powered USB hubs. Make sure the power cord for each hub is plugged in before proceeding to the next step 3) Connect the DataPort 1224 labeled Board 0 into any available USB port on your PC or hub(s). Wait until the bottom green LED on the side of the DP1224 stops blinking and the top LED turns solid green before proceeding to the next step. Please note that it may take a few minutes for the LED on the DP1224 to turn green. VV-A/VV-DV 1.1 2
4) Run Instacal software (Windows Start->All Programs->Measurement Computing->Instacal) a) The dialog box below will appear (serial number in parenthesis will be different). Click OK. Refresh Boards Board Serial Number b. After clicking OK you will see the following window 5) Verify that the Board Serial Number next to Board# 0 matches the silver serial number label on the DataPort 1224. (If it does not match contact Starr Life Sciences) 6) If only using one DP1224 proceed to step 7 below. Otherwise connect the next DP1224 labeled Board# 1, wait for the green LED to illuminate on the DP1224 then click on the Refresh Boards button shown above The following screens should appear (serial numbers will be different). Click OK then verify that the Board Serial Number for Board# 1 matches the silver factory label on the DP1224 labeled Board# 1 You can keep adding DataPorts in ascending Board# order by repeating the above steps for each one. Note: If you detach your DataPorts from your PC for any reason you must repeat this hardware installation procedure in order to ensure accurate assignment of data channels. VV-A/VV-DV 1.1 3
7) Exit Instacal 8) Assemble any running wheels and/or IR Cage Top Sensors that you purchased per the instructions included with each device. Attach each device to an open port on a DP1224 (push connector in until it clicks). On a piece of paper record Device Type, Board # and Port # for each device. This will be referenced when configuring the data channels in the VitalView software. DataPort 1224 Port #s Example: Device Type Board # Port # Large Running Wheel 0 1 Small Running Wheel 0 2 In-Cage Running Wheel 0 3 9) On your PC run VitalView-A software (Windows Start->All Programs->VitalView A->VVA) a) You will be asked to enter the Product Key Code (case sensitive) that was included with your order. Enter the code and click OK Your hardware and software installation is complete. Detailed instructions for using the VitalView-A software can be found in the User Manual included with the installation media (CD, thumb drive, or download at www.starrlifesciences.com/vitalview-a) ADVISORY NOTICE: DISABLE SLEEP MODE ON YOUR COMPUTER WHEN USING VV-A. IF THE COMPUTER GOES TO SLEEP IT WILL SEVER USB CONNECTIONS AND YOU WILL NOT BE ABLE TO COLLECT ANY DATA WHILE ASLEEP NOR BE ABLE TO RECOVER ANYTHING FROM THIS PERIOD. VV-A/VV-DV 1.1 4
2.0 Vital View Activity Monitoring System User Manual 2.1 Operating the Software Run the VitalView Activity software (Start->All Programs->VitalView A->VVA) 1. Enter Product Key Code (case sensitive). You should see the screen below. i) If the key code is rejected (1) Double check that you entered it correctly (It is Case Sensitive) (2) Re-run Instacal (See Quick Start Guide) and make sure each DP1224 is associated with the proper Board# 2.2 Configuration Click on the Configuration button. You should see the first window below Click on Hardware Config tab. You should see the second window above. Note: DP1224s can be purchased with either 12 or 24 channels. VV-A/VV-DV 1.1 5
1. Depending on how many DP1224s you have connected you will need to click each toggle switch associated with DP1224/Board# that you connected in previous steps. Set each one to either 12 or 24 channels to match your hardware. 2. Specify the System Sample Interval (default is 15 seconds) Note: Sample Interval = Time period in which the number of input triggers are counted and reported as a data point. E.g. A 15 second Sample Interval will record the number of running wheel turns that occur within each 15 second interval. Note: System Sample Interval determines the smallest sample interval available for each individual channel (setup in the next step) 3. Click on the Channel Config tab. The window below should appear. Data Channel Selection Arrows i) Specify a Data Channel you wish to configure by using the selection arrows or typing a value into the box. Note: The number of data channels you have available is dependent on the hardware you purchased. E.g. if you purchased 2 X DP1224s each with 12 ports then you have a total of 24 Data Channels. Data Channels 1-12 correspond to Port #s 1-12 on Board #0, Data Channels 13-24 correspond to Port #s 1-12 on Board #1. (1) Enter values in the Channel Name and Channel Group (Click on a field and it will become active) Note: These fields are for labels you specify that are meaningful in your study. E.g. Channel Name = animal tattoo identifier, Channel Group = Experimental/Control (2) Click on Sensor Type and select the type of sensor input that is being used. (3) The Board and Port# fields will automatically update after you click Save and Continue (4) Enter a value into Channel Sample Interval if you want the data for this channel to be parsed into a different interval other than the System Sample Interval Note: You can select a value equal to or larger than the System Sample Interval specified in a previous step Note: Two versions of each log file will be created. The original version will be created using the System Sample Interval for all channels. A second version will be created using the individual Channel Sample Intervals and have the prefix DM added to the Log File Path/name VV-A/VV-DV 1.1 6
(5) Configure each subsequent Data Channel by repeating the steps above ii) When all Data Channels have been configured click on Save Channel Config (1) Specify a file name and location where the configuration is to be stored: iii) Specify a Log File Path where you want acquired data to be stored (1) Either accept the default location or specify a location iv) Click Save and Continue v) The main screen should appear and be populated with the values associated with the project that you just configured. See example below 2.3 Starting a Data Acquisition Session Click on the Start button under Data Acquisition. 1. A dialog box will open with three options: i) Start Now? Allows you to begin data acquisition immediately ii) Start At: - Allows you to select a time in the future to begin recording data VV-A/VV-DV 1.1 7
iii) If you selected Start At: [Time], a second dialog box will appear: iv) At this point, you can wait until your start time begins, select Start Now to begin immediately, or use the Cancel and Change button if you need to adjust your settings v) If you use the Cancel and Change button, your Start Time will not be saved 2. The Data Acquisition indicator will turn bright green 3. Verify proper connection of each input by manually spinning the running wheels or triggering the Infrared Cage Top Sensor 4. Data should start to show up on the graph thumbnail for each Data Channel. See example below: Data vi) You can stop data acquisition at any time by clicking the Stop button. If you click Start again without changing the Log File Path new data will be appended onto the end of the current Log File. Note: You can do this but it will introduce an error in the time base used to create the individual Channel Sample Intervals at the point where the appending of the data occur, and will also affect AWD files time base as well 2.4 Zoom Click on the Zoom button and a large graph will appear Select the Data Channel you would like to display using the Channel Selector arrows VV-A/VV-DV 1.1 8
If using a running wheel you can enter the Wheel Diameter and the Distance Ran will be calculated Note: The units of the Distance Ran will be the same as whatever units you entered into the Wheel Diameter box. 2.5 Data Export Click on Data Export. You can export data at any time and the main recording will continue uninterrupted 1. A dialog box will open in which you can specify if you would like to export CSV or AWD data If you selected CSV, a new dialog box will open and allow you to choose a file name and location where you want to save the data. VV-A/VV-DV 1.1 9
-The file will contain data from the beginning of the acquisition session until the moment the data export was initiated -Two versions of data log will be created. One version using the System Sample Interval and one version using the individual Channel Sample Intervals ( DM prefix on log file name) 2.5.1 AWD Conversion If you selected AWD, a new dialog box will open allowing you to choose any selection of animals to convert to AWD 1)Use Ctrl+Click to add several unique animals, Shift+Click to select several animals in sequence, or click on the Select All button 2)Use the Path control to browse for a folder to save the AWD files to 3)When you are in the folder you want to save to, click on the Current Folder button 4)Click on Convert to AWD and a dialog box will appear showing you the status of each conversion -The Files created will have a naming scheme as follows: [Channel Name] [Numeric Increment] -The numeric incrementor starts at 1 and increases with every animal created and serves to prevent filename overlap -You are able to change these filenames as soon as the conversion is complete VV-A/VV-DV 1.1 10
2.6 Stopping a Data Acquisition Session Click on Stop under Data Acquisition 1)The green Data Acquisition indicator will turn off 2) Two versions of the master Log File will be created. One version will use the System Sample Interval and have the name specified when configuring the Data Channels. The second version will use the individual Channel Sample Intervals and have a DM prefix added to the file name. The DM File will only be created if there are any individual sample intervals that are different from the system sample interval. 3) At this point, you can also click on Data Export and have AWD files generated for any animal Click Exit to finish your data acquisition session. NOTE: Data acquisition must be stopped in order to exit the program When you restart the VitalView Activity Software it will reload the last hardware and Data Channel configurations. Before starting, you will need to click on configuration and select Save to confirm the same settings. To change the configuration enter new values and save them to a new config file and create a new Log File Path. 2.7 Minimum system requirements: Windows PC (Windows XP or newer) 2 GHz Processor (Recommended 2 nd Generation of i3 Intel Core Processor or better) 2GB RAM 800MB Hard Drive free space 1 available USB port per device* Use Uninterruptible Power Supply Disable Sleep mode (set to Always On) Disable Automatic Windows Updates Recommended to use this computer ONLY for VV-A while acquiring data. You may use the Data Export feature at will but should open the data on a separate computer if system is still acquiring data *For laptop users, use a USB port on one side of the computer while connecting your mouse or other USB peripherals on the other side of the laptop. When using more than one DP1224, use a powered USB hub to connect. See Section 2.9 for more instructions. 2.8 USB Accessories USB Hub Tripp Lite U223-004-IND (Industrial Powered 4-port USB Hub) USB Extension Tripp Lite U026-10M (10 meter, 32.8ft) USB extension cable USB over Ethernet Tripp Lite B203-101-PNP (supports Ethernet cables up to 50 meter, 164 ft) 2.9 Troubleshooting This section is divided into setup problems and runtime problems: VV-A/VV-DV 1.1 11
2.9.1 Setup Problems If you are having trouble getting the system to start, please review the steps in the quick start guide to make sure your hardware is properly connected and recognized by the computer. If you have an older version of InstaCal, you will need to uninstall that prior to installation. After uninstalling the older InstaCal, search your computer for cbw32.dll. Specifically, if a copy of this file exists in your SysWOW64 folder (C Drive), then you need to delete it before installing the newer InstaCal. Once InstaCal has been re-installed and the computer has restarted, open up InstaCal with no DP1224 units attached. Next, attach only Board# 0 and wait for the bottom green LED to stop blinking and the top LED to remain on. Click the Refresh button, and InstaCal should recognize the unit and make it Board# 0. If it the board# is not 0, then simply right click the listing and select Change Board# and use the menu to set it to Board# 0. If you have any more DP1224 units, plug them in one at a time, using the Refresh button to have InstaCal recognize them as they are added. 2.9.2 Runtime Problems If the units have issue running for long periods of time, such as shutting off randomly, you may need to adjust advanced power settings in the Control Panel and Device Manager. 2.9.2.1 Control Panel The following steps will take you through how to change advanced power settings to adjust USB Sleep issues: 2.9.2.2 Device Manager 1. Open Control Panel and click on System and Security 2. Click on Power Options 3. Find your currently selected plan (Should be High Performance), and click on Change Plan Settings to the right of it 4. Double check that the sleep settings are set to Never 5. Click on Change advanced power settings 6. Expand the USB settings entry and then expand the USB selective suspend setting 7. If on a desktop computer, there will be one entry and set to Disabled 8. If on a laptop, there will be two entries; set them both to Disabled 9. Click Apply at the bottom then OK 1. Go back to the Control Panel and select Hardware and Sound 2. Under the Devices and Printers heading, select Device Manager 3. Scroll down and find the Universal Serial Bus controllers entry and expand it 4. Right click the first entry and select Properties 5. Click on the tab labeled Power Management and deselect the box marked Allow the computer to turn off this device to save power and click OK 6. If there is no tab labeled Power Management click OK and move on to the next entry 7. Repeat steps 5-6 for each entry under Universal Serial Bus controllers VV-A/VV-DV 1.1 12
3.0 Vital View Data Viewer User Manual The Vital View Data Viewer (VV-DV) allows user to: Load in VV-A or VV Legacy data to view, filter, and convert to AWD files for use in Actiview or Clock Lab Circadian Analysis. VV Legacy data will also be converted to a.csv file. This will not alter the original files in anyway. 3.1 Loading Data To use VV-DV, click on Load Data or Load Legacy Data to get started 3.1.1 Load Data You will be asked if the file is a Standard or DM file. Currently, DM files are not supported, so you will have to load the main file from VV-A (Click Standard) 3.1.2 Load Legacy Data You will be prompted to select the.log file associated with the VV 5.0 (or older) data set. The other data files (.cfg,.evn,.cal, and.001 with any additional memory files) will need to be in the same directory for VV-DV to find all the data. Once loaded, the Analysis Data Load Selection Window will appear. You can choose which animals to load, and from what dates to load the data from. When done, click Ok, and the data will be loaded into VV-DV. The data will also be saved as a.csv file in the same directory as Temp Legacy CSV. This file can be used to convert animal data to AWD files without having to re-save your legacy data in a new format. VV-A/VV-DV 1.1 13
Once data is loaded (Standard or Legacy), the first 9 animals will be loaded into the graphs G1-G9. There is a selector above each graph, you can select any animal from that drop down to view. If you click on any graph, a Zoom window will appear with statistics for that animal, as shown in the picture below. 3.2 Zoom The Wheel Diameter takes any value; for example, if you have a 4 inch wheel, and you enter 4 into Wheel Diameter, the Distance Ran will be translated to inches. If you put in 0.3333 feet, the Distance Ran will be in feet. You can use the tools underneath the graph (the ones that are shaped like a plus sign, magnifying glass, and a hand). The Plus sign will allow you to move any cursors present on the graph. The Magnifying glass will allow you to select from several zoom tools. The Hand will let you move around the graph space (Click and Drag in any direction). 3.3 Filter The filter dialog allows you to alter your data for viewing. You can select any animal from the list on the left. Use Ctrl+Click to select several animals, or Shift+Click to select any number of animals in a row. All number boxes accept any real number. Scale Multiplies all data points by the number typed into the number box Offset Adds the number typed in to every data point Clip Low Any data below this number will be raised up to it Clip High Any data above this number will be clipped down to it Increase Time Base- Allows you to change your sampling interval by concatenating data sets. For example, if your sampling interval is 1 minute and you put 15 in the box next to Increase Time Base, it will add up 15 data points at a VV-A/VV-DV 1.1 14
time, which will effectively make the new sample interval 15 minutes. The timestamps will also update to accompany the data. Special Span Clicking this button will make a dialog box pop up. The From and To boxes will populate with all the times from the data collection session. Pick any time period, and the software will clip all the data in that time frame so that it can be viewed and saved as its own file. The software will prevent you from selecting a To time that starts before the chosen From time as well. This feature works on every animal regardless of what is selected in the Filter Dialog before clicking Special Span. 3.4 Convert to AWD Click on the Convert to AWD button on the main screen. The pop-up window (shown at left) will appear with the animal names displayed. You can select from one to all of the animals. Ctrl+Click will allow you pick out any animals, Shift+Click will allow you to select any number of animals in a row. Alternatively, you can click the Select All button to select all animals instantly. Next, click on the folder button and browse to a folder where you want your AWD files to be saved. Click Current Folder tab to save the location. It may take some time to finish converting all the animals, but once done, click Exit to return to the main screen. The AWD files can be found in the folder you selected with the filename: {[Animal Name] #.awd}. The # starts at 1 and increments for each animal converted, this is to prevent any filename collisions during conversion. After conversion is complete, you can rename the files anything you wish. 3.5 Save Filtered Data This feature allows you to save your data after it has been filtered as a new CSV file. It will pop-up with a file dialog, allowing you to select where it will be saved. The file type is always a.csv (Comma Separated Values file). VV-A/VV-DV 1.1 15