In ColumbusPlus the Remote Reference is a requirement for the Cluster system to access a corresponding measurement's images and perform the analysis. You will find Remote Reference under the Measurement Info tab in the Browse view. If the Remote Reference is missing a Cluster analysis will fail. If your system has been in use and data imported prior to being upgraded to ColumbusPlus you will find that any existing measurement data will not have a Remote Reference. To set the Remote Reference manually using measurement data available in Columbus:
Export to the shared file system
- Switch to the Export View
- Select Export Options - Method - Export to Disk (*)
- Export Folder - the path to the shared file system used by the Columbus Cluste
- Image Data - tick checkbox and select SinglePlane TI
- Start Export
If you are uncertain of the Export Folder path refer to the import_path parameter in the /etc/columbus/*.config file
For purposes of this example the Export Folder is
/columbus_cluster/data/images
To export to this path the acapella user requires write access. This would normally be the case if the shared file system is owned by columbus (acapella user typically being in the same group) but if you see a warning to the effect:
Selected directory /columbus_cluster/data/image1 does not exist.
Check and potentially change the permissions to allow acapella to write, if writable you will see:
Selected directory /columbus_cluster/data/images OK.
Once exported by default the folder created will bear the name of the Screen appended with the Screen ID within []
For purposes of this example Reference Screen is the name of the Screen and the Screen ID in Columbus is [3152]. Therefore the first folder created is Reference Screen[3152] then a plate and finally the measurement folders containing the images. The full path in this example being:
/columbus_cluster/data/images/Reference Screen[3152]/Plate[3202]/2008-06-12T123202+0100[3252]/2008-06-12T123202+0100[3252]
Confirming the above path on the Columbus Server
- Log into the Columbus server using ssh
- Navigate to the top level folder in the Export Folder path i.e the measurement level
- Get the path, for instance using the above pwd command
- Switch to the Browse view in Columbus interface
- Edit the Remote Reference adding the path such as above but append ‘file://‘ to the beginning.
- Error Message: tcgetattr: Inappropriate ioctl for device Connection to gcc1 closed.
- (*) If you are only exporting a single measurement as oppose to a large Screen and do not need to preserve the folder hieracy the exported subfolders can be simplify by choosing: Screen or Screen+Plate or the default Screen+Plate+Measurement in Generate Subfolders. You will find this under the left drop down arrow at the bottom of the Select Export Options section.