Getting Started

The first thing to do is to ssh into cvrl.cse.nd.edu. Using this machine give you bxgrid export permission.
ssh cvrl.cse.nd.edu

Once you have logged in cvrl.cse.nd.edu. The next step is to obtain the bxgrid binary from /afs/crc.nd.edu/group/ccl/software/bxgrid/bxgrid. You can copy it to /tmp, your afs space or run it directly from ccl afs space. We recommend the last method to utilize the lastest bxgrid built.
cp /afs/crc.nd.edu/group/ccl/software/bxgrid/bxgrid /tmp
cd /tmp/

Before starting using bxgrid, you need to provide login information, you only need to do this the first time by running this command: bxgrid biometrics login. Obtain the username and password from Dr. Flynn.
bxgrid biometrics login
mysql login: cvrl
password:

Now you are ready to export some data from bxgrid. To do that you will invoke bxgrid import command.

bxgrid biometrics export  <data type> to <metadata file> <output dir> where <conditions>

For example, this command will export 10 irises to /tmp/irises and the associated metadata to /tmp/meta.data:
bxgrid biometrics export irises_still to /tmp/meta.data /tmp/irises where true limit 10

If your conditions have any brakets and quote or double quotes, you need to add \ infront of each leter. The following command will export 10 random irises /tmp/newirises and the associated metadata to /tmp/newmeta.data
bxgrid biometrics export irises_still to /tmp/newmeta.data /tmp/newirises where true order by rand\(\) limit 10

You can choose from 5 types of data:
irises_still, irises_mov, faces_still, faces_mov and faces_3d.

You can export the whole collection:
bxgrid biometrics export faces_still to /tmp/meta.data /tmp/face_nd1C00011 where collectionid = \'nd1C00011\'

Or all faces from a particular subject:
bxgrid biometrics export faces_still to /tmp/meta.data /tmp/face_nd1S05213 where subjectid = \'nd1S05213\'

Or a single face image:
bxgrid biometrics export faces_still to /tmp/meta.data /tmp/face_nd5R55000 where recordingid = \'nd5R55000\'

If you have a more complicated query that you don't how to handle, please contact hbui at nd.edu. You also can visit a more completed BXGrid User Manual

Back To BXGrid