DataCollaborationToolbox
From charlesreid1
Contents
Installation
The Data Collaboration (DC) Matlab Toolbox can be downloaded here: http://collab-sci.sourceforge.net/
There are two versions available:
- Version 1: http://sourceforge.net/projects/collab-sci/files/DataCollaboration/1.0.0/
- Version 2: http://sourceforge.net/projects/collab-sci/files/DataCollaboration/2.0.0/
And you need Matlab.
(Also... to use the Matlab gui from the clusters, you have to download X11: http://xquartz.macosforge.org/ )
CHPC Clusters
Version 1 (Feeley Version)
1. Download DClabV1.zip and unpack to DClabV1release1/
2. Before you can run the toolbox from Matlab, you have to make a minor modification. DC toolbox v. 1 comes packaged with SeDuMi 1.1 or 1.21, but needs 1.3 to run on the latest version of Matlab on the CHPC clusters. You can obtain SeDuMi from here: http://sedumi.ie.lehigh.edu/
3. Download/unpack SeDuMi 1.3 into DClabV1release1/source/SeDuMi_1_3
4. Modify the Matlab file DClabV1release1/DCsetup.m so that all instances of "SeDuMi_1_1" are replaced with "SeDuMi_1_3"
5. Add SeDuMi and DC scripts to the Matlab path by running the following Matlab commands:
addpath('/path/to/DClabV1/')
addpath('/path/to/DClabV1/source/SeDuMi_1_3')
addpath('/path/to/DClabV1/source/SeDuMi_1_3/conversion')
addpath('/path/to/DClabV1/source/SeDuMi_1_3/examples')
6. Run the DC toolbox setup script, and you should see the following output:
>> DCsetup
Appending directories to Matlab path:
/uufs/chpc.utah.edu/common/home/u0552682/pkg/DClabV1release1
/uufs/chpc.utah.edu/common/home/u0552682/pkg/DClabV1release1/examples/GRI
/uufs/chpc.utah.edu/common/home/u0552682/pkg/DClabV1release1/examples/massSpringDamper
/uufs/chpc.utah.edu/common/home/u0552682/pkg/DClabV1release1/source
/uufs/chpc.utah.edu/common/home/u0552682/pkg/DClabV1release1/source/generalFctns
/uufs/chpc.utah.edu/common/home/u0552682/pkg/DClabV1release1/savedEvaluations
/uufs/chpc.utah.edu/common/home/u0552682/pkg/DClabV1release1/source/gui
Path updated: run DCTEST.M to confirm successful installation
>> dctest
Testing software installation...
Upper inner bound:
Lower inner bound:
Installation successful!
7. To permanently add the DC toolbox to your Matlab path, edit the file startup.m in ~/.matlab/R20XXx/startup.m (where R20XXx is whatever version you're using; I've tested this DC toolbox using Matlab R2009b and R2010a) and add the "addpath" commands:
addpath('/path/to/DClabV1/')
addpath('/path/to/DClabV1/source/SeDuMi_1_3')
addpath('/path/to/DClabV1/source/SeDuMi_1_3/conversion')
addpath('/path/to/DClabV1/source/SeDuMi_1_3/examples')
Version 2 (Russi Version)
This is essentially the exact same process as for Version 1.
1. Download DClabV2.zip and unpack to DClabV2/
2. Before you can run the toolbox from Matlab, you have to make a minor modification. DC toolbox v. 2 comes packaged with SeDuMi 1.21, but needs 1.3 to run on the latest version of Matlab on the CHPC clusters. You can obtain SeDuMi from here: http://sedumi.ie.lehigh.edu/
3. Download/unpack SeDuMi 1.3 into DClabV2/SeDuMi_1_3
 |
DClabV1 has a source folder into which SeDuMi was put, but DClabV2 does not.
But actually, it doesn't really matter - you can have a single SeDuMi install on your Matlab path, and point to that SeDuMi for either DC toolbox. You would simply modify theaddpath() calls given below to point to the correct location of SeDuMi. |
4. Run the install_sedumi.m script
5. Modify the Matlab file DClabV2/DCsetup.m so that all instances of "SeDuMi_1_21" are replaced with "SeDuMi_1_3"
6. Add SeDuMi and DC scripts to the Matlab path by running:
>> addpath('/path/to/DClabV2/')
>> addpath('/path/to/DClabV2/SeDuMi_1_3')
>> addpath('/path/to/DClabV2/SeDuMi_1_3/conversion')
>> addpath('/path/to/DClabV2/SeDuMi_1_3/examples')
7. Run the DC toolbox setup script, and you should see the following output:
>> DCsetup
>> dctest
Testing software installation...
Installation successful!
|
Don't be fooled if you don't see any output from DClabV2's DCsetup.m script. It is more quiet than the DClabV1 DCsetup.m script, but as long as the dctest.m script works, your installation was successful. |
8. To permanently add the DC toolbox to your Matlab path, edit the file startup.m in ~/.matlab/R20XXx/startup.m (where R20XXx is whatever version you're using; I've tested this DC toolbox version using Matlab R2009b and R2010a) and add the "addpath" stuff:
addpath('/path/to/DClabV2/')
addpath('/path/to/DClabV2/SeDuMi_1_3')
addpath('/path/to/DClabV2/SeDuMi_1_3/conversion')
addpath('/path/to/DClabV2/SeDuMi_1_3/examples')
Alternately, you can still use DC toolbox but leave it out of your Matlab startup file by adding the above commands (except for the "dctest" command) to any DC scripts.
Note that you'll probably need to run the following command:
export MATLABPATH=$HOME/.matlab/R20XXx
Basic DC Toolbox Script
(Details & toy problem coming later...)
1. Load your experimental assertions
2. Load your model/simulation assertions
3. Construct surrogate model coefficients
4. Create ParameterAssertion objects (DC toolbox objects)
5. Construct the Dataset object
6. Create a ConsistTest object to run the consistency analysis
7. Create a Prediction object
8. Make plots
Keywords to facilitate searching
Data
Collaboration
Toolbox
DCLab
DC Lab
DC Toolbox
Data Collaboration
Data Collaboratories
Data Collab