Read and write neuroglancer Precomputed formats to cloud storage
Project description
[![Build Status](https://travis-ci.org/seung-lab/cloud-volume.svg?branch=master)](https://travis-ci.org/seung-lab/cloud-volume)
# cloud-volume
Python client for reading and writing to Neuroglancer Precomputed volumes on cloud services. (https://github.com/google/neuroglancer/tree/master/src/neuroglancer/datasource/precomputed)
When working with a particular dataset, say an EM scan of a mouse, fish, or fly brain, you’ll typically store that as a grayscale data layer accessible to neuroglanger. You may store additional labellings and processing results as other layers.
## Usage
Supports reading and writing to neuroglancer data layers on Amazon S3, Google Storage, and the local file system.
Supported URLs are of the forms:
$PROTOCOL://$BUCKET/$DATASET/$LAYER
- Supported Protocols:
gs: Google Storage
s3: Amazon S3
file: Local File System (absolute path)
` vol = CloudVolume('gs://mybucket/retina/image') # Basic Example image = vol[:,:,:] # Download the entire image stack into a numpy array vol[64:128, 64:128, 64:128] = image # Write a 64^3 image to the volume `
## Setup
You’ll need to set up your cloud credentials as well as the main install.
### Credentials
` mkdir -p ~/.neuroglancer/secrets/ echo $GOOGLE_STORAGE_PROJECT > ~/.neuroglancer/project_name # needed for Google mv aws-secret.json ~/.neuroglancer/secrets/ # needed for Google mv google-secret.json ~/.neuroglancer/secrets/ # needed for Amazon `
### pip
` pip install cloud-volume `
### Manual ` git clone git@github.com:seung-lab/cloud-volume.git cd cloud-volume virtualenv venv source venv/bin/activate pip install -e . `
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cloud_volume-0.0.1.dev17-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 33b22f5498f214c54f61ebc3002cbdf96aa90ccebd0a16b1e72959b069855e52 |
|
MD5 | b7cc34ae61f583cc5c0f537e9115b563 |
|
BLAKE2b-256 | 3c7e6b6230f0d63ec399f07966dded2d69464d103a8ef6be869bf5e3e1ee204a |