wiki:barServiceQueryReconstruction

Context Navigation

Version 6 (modified by jkowalski, 13 years ago) (diff)
--

3d Brain Atlas Reconstructor on-line service

queryReconstruction

Return AJAX data describing reconstructions in the service matching the criteria.

syntax

queryReconstruction?cafDatasetName=<dataset identifier>
                   ;structureList=<structure name>
                   ;outputFormats=<output format list>
                  [;resolution=<resolution>]
                  [;pipeline=<pipeline name>]
                  [;switches=<switches list>]

Required arguments

cafDatasetName: The service identifier of the selected CAF dataset.

structureName: Name of structure from hierarchy tree. In practice nearly all names should be fine. Formally name has to point to a root node of a subtree containing at least one node with representation among paths in CAF slides.

outputFormats

Nonempty coma-separated list of reconstruction file format descriptors. Allowed format descriptors are:

'exportToVRML': VRML files,
'exportToX3d': X3D files,
'exportToPOVRay': POV-Ray files,
'exportToNiftii': NIfTI files
'exportToVTKPolydata': vtk polydata files,
'exportToNumpy': NumPy? array files,
'exportToVolume': vtk structured grid files,
'exportScreenshot': PNG images,
'exportThumbnail': PNG thumbnails.

Optional arguments

resolution: Coronal and anterior-posterior voxel size separated with a coma.

pipeline: Service identifier of the pipeline the reconstructions has been generated with.

switches

Nonempty coma-separated list of switches. Allowed switches are:

'brainoutline': match only structures containing the outline of hierarchy tree root structure; forces 'composite' switch,
'composite': only scene format descriptors ('exportToVRML', 'exportToX3d', 'exportToPOVRay', 'exportScreenshot', 'exportThumbnail') are allowed in the outputFormats list.

AJAX data type

[{
   String: String,
   String: [Number, Number, String],
   String: String,
   String: Boolean,
   String: String,
   String: Number,
   String: Number | null,
   String: String,
   String: String
 },
 ...]

AJAX data description

The data is provided in format:

[{
   'groups': <groups>,
   'quality': [<xyres>, <zres>, <pipeline>],
   'format': <format>,
   'compressed': <compressed>,
   'status': <status>,
   'cacheID': <id>,
   'size': <size>,
   'groupsID': <groups id>,
   'CAFSlideUnits': <unit>
 },
 ...]

where:

<groups>: is a string describing structures included in the reconstruction,

<xyres>: is the coronal voxel size used in the reconstruction process,

<zres>: is the anterior-posterior voxel size used in the reconstruction process,

<pipeline>: is the service identifier of the pipeline used in the reconstruction process,

<format>: is a string describing the format of reconstruction file,

<compressed>: indicates if the reconstruction file has been compressed as a zip archive,

<status>

is a string describing the status of the reconstruction; possible values are:

'None',
'Scheduled',
'Pending',
'In progress',
'Completed',
'Finished',
'Failed',
'Removed',

<id>: is the service identifier of the reconstruction,

<size>: is the reconstruction file size (in bytes),

<groups id>: is a string composed of reconstructed groups names separated with '_' character; if an outline is present in the reconstruction, its name precedes others and is separated with double '_' character,

<unit>: is the voxel size unit.