barrywark / pldaps-importer

Pldaps importer for Ovation

PL-DA-PS importer for Ovation

This project contains Matlab[1]_ code for importing PL-DA-PS <http://hukdata.cps.utexas.edu/archive/PLDAPS.html> data into the Ovation Scientific Data Management System <http://physionconsulting.com/web/Ovation.html>.

Basic Usage

To use the importer:

1. add the project directory to the Matlab path

2. Choose an Ovation Experiment object to insert data into. To create a Project and Experiment:

   >> import ovation.*
   >> context = NewDataContext(<path_to_connection_file>, <username>);
   >> project = context.insertProject(<project name>, <project purpose>, <project start date>);
   >> experiment = project.insertExperiment(<expt purpose>, <expt start date>);
   

3. Insert a PL-DA-PS .PDS file as an EpochGroup:

   >> epochGropu = ImportPladpsPDS(experiment,...
       <path to PDS file>,...
       trialFunctionName,...
       experimentTimeZone)
   

4. Export spike sorting data from a .plx to a Matlab .mat file:

   >> plx2mat ??
   

5. Append DerivedResponses with spike times and spike waveforms to Epochs already in the database:

   >> ImportPladpsPlx(epochGroup,...
       plxFilePath,...
       expFilePath);
   

This step will will issue a warning Epochs in the plexon data are not already represented by Epoch instances in the Ovation database.

Automated tests

To run the automated test suite:

1. Add pldaps-importer folder to the Matlab path

2. Add Matlab xUnit (pldaps-importer/matlab-xunit-doctest/xunit) to the Matlab path

3. From within the pldaps-importer/test directory:

   >> runtestsuite
   

License

Copyright (c) 2012, Physion Consulting LLC All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

[1]	Matlab is a registered trademark of The Mathworks, Inc..