Download whole or partial two-dimensional images from the Allen Institute with the SectionImage, AtlasImage and ProjectionImage Download Services.
The SectionImage download service serves whole and partial two-dimensional images presented on the Allen Brain Atlas Web site.
http://api.brain-map.org/api/v2/section_image_download/[SectionImage.id]?downsample=[#]&quality=[#]&expression=[true|false] |
Download a downsampled SectionImage of one sagittal section from the Mouse Brain Pdyn SectionDataSet:
http://api.brain-map.org/api/v2/section_image_download/69750516?downsample=4 |
Download a downsampled expression mask for a SectionImage of one sagittal section from the Mouse Brain Pdyn SectionDataSet:
http://api.brain-map.org/api/v2/section_image_download/69750516?downsample=4&expression=true |
Download a region of interest at full resolution from the same sagittal SectionImage:
http://api.brain-map.org/api/v2/section_image_download/69750516?left=6174&top=2282&width=1000&height=1000 |
Download SectionImage 71592261 downsampled 3 times with 50% image quality:
http://api.brain-map.org/api/v2/section_image_download/71592261&downsample=3&quality=50 |
Determine the default range values for a Mouse Connectivity Projection experiment by referring to its associated Equalization model (red_lower=0, red_upper=923, green_lower=0, green_upper=987, blue_lower=0, blue_upper=4095), then download one of its downsampled SectionImages:
http://api.brain-map.org/api/v2/data/SectionDataSet/100141599.xml?include=equalization,section_images http://api.brain-map.org/api/v2/section_image_download/102146167?range=0,923,0,987,0,4095&downsample=4 |
filename |
Integer |
SectionImage.id identifying the image to download. |
expression |
Boolean (optional) |
Set the value to true to retrieve the specified SectionImage's expression mask image. |
downsample |
Integer (optional) |
The number of times to downsample the original image. For example, 'downsample=1' halves the number of pixels of the original image both horizontally and vertically. Specifying 'downsample=2' quarters the height and width values. |
quality |
Integer (optional) |
The jpeg quality of the returned image. This must be an integer from 0, for the lowest quality, up to as high as 100. If it is not specified, it defaults to the highest quality. |
left |
Integer (optional) |
Index of the leftmost column of the region of interest, specified in full-resolution (largest tier) pixel coordinates. SectionImage.x is the default value. |
top |
Integer (optional) |
Index of the topmost row of the region of interest, specified in full-resolution (largest tier) pixel coordinates. SectionImage.y is the default value. |
width |
Integer (optional) |
Number of columns in the output image, specified in tier-resolution (desired tier) pixel coordinates. SectionImage.width is the default value. It is automatically adjusted when downsampled. |
height |
Integer (optional) |
Number of rows in the output image, specified in tier-resolution (desired tier) pixel coordinates. SectionImage.height is the default value. It is automatically adjusted when downsampled. |
range |
Array (optional) |
Filter to specify the RGB channels. The range parameter consists of 6 comma delimited integers that define the lower (0) and upper (255) bound for each channel in red-green-blue order (i.e. "range=0,1500,0,1000,0,4095"). The default range values can be determined by referring to the following fields on the Equalization model associated with the SectionDataSet: red_lower, red_uppper, green_lower, green_upper, blue_lower, blue_upper. For more information, see the "Image Controls" section of the Allen Mouse Brain Connectivity Atlas: Projection Dataset help topic. |
A jpeg file of the requested image.
The AtlasImage download service serves whole and partial two-dimensional images with annotations presented on the Allen Brain Atlas Web site.
http://api.brain-map.org/api/v2/atlas_image_download/[AtlasImage.id]?downsample=[#]&quality=[#]&annotation=[true|false] |
Download the downsampled AtlasImage 100883869 with annotations:
http://api.brain-map.org/api/v2/atlas_image_download/100883869?downsample=4&annotation=true |
filename |
Integer |
AtlasImage.id identifying the image to download. |
annotation |
Boolean (optional) |
Set the value to true to retrieve the specified AtlasImage with annotations. |
downsample |
Integer (optional) |
The number of times to downsample the original image. For example, 'downsample=1' halves the number of pixels of the original image both horizontally and vertically. Specifying 'downsample=2' quarters the height and width values. |
quality |
Integer (optional) |
The jpeg quality of the returned image. This must be an integer from 0, for the lowest quality, up to as high as 100. If it is not specified, it defaults to the highest quality. |
left |
Integer (optional) |
Index of the leftmost column of the region of interest, specified in full-resolution (largest tier) pixel coordinates. SectionImage.x is the default value. |
top |
Integer (optional) |
Index of the topmost row of the region of interest, specified in full-resolution (largest tier) pixel coordinates. SectionImage.y is the default value. |
width |
Integer (optional) |
Number of columns in the output image, specified in tier-resolution (desired tier) pixel coordinates. SectionImage.width is the default value. It is automatically adjusted when downsampled. |
height |
Integer (optional) |
Number of rows in the output image, specified in tier-resolution (desired tier) pixel coordinates. SectionImage.height is the default value. It is automatically adjusted when downsampled. |
A jpeg file of the requested image.
The Projection Image download service serves whole and partial two-dimensional images with projection data presented on the Allen Brain Atlas Web site.
http://api.brain-map.org/api/v2/projection_image_download/[SectionImage.id]?downsample=[#]&quality=[#]&projection=[true|false] |
Download the downsampled SectionImage 126862583 with projection:
http://api.brain-map.org/api/v2/projection_image_download/126862583?downsample=4&projection=true |
filename |
Integer |
SectionImage.id identifying the image to download. |
projection |
Boolean (optional) |
Set the value to true to retrieve the specified SectionImage with projection. |
downsample |
Integer (optional) |
The number of times to downsample the original image. For example, 'downsample=1' halves the number of pixels of the original image both horizontally and vertically. Specifying 'downsample=2' quarters the height and width values. |
quality |
Integer (optional) |
The jpeg quality of the returned image. This must be an integer from 0, for the lowest quality, up to as high as 100. If it is not specified, it defaults to the highest quality. |
left |
Integer (optional) |
Index of the leftmost column of the region of interest, specified in full-resolution (largest tier) pixel coordinates. SectionImage.x is the default value. |
top |
Integer (optional) |
Index of the topmost row of the region of interest, specified in full-resolution (largest tier) pixel coordinates. SectionImage.y is the default value. |
width |
Integer (optional) |
Number of columns in the output image, specified in tier-resolution (desired tier) pixel coordinates. SectionImage.width is the default value. It is automatically adjusted when downsampled. |
height |
Integer (optional) |
Number of rows in the output image, specified in tier-resolution (desired tier) pixel coordinates. SectionImage.height is the default value. It is automatically adjusted when downsampled. |
A jpeg file of the requested image.