Skip to main content

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

cloud-volume-0.0.1.dev17.tar.gz (36.5 kB view hashes)

Uploaded Source

Built Distribution

cloud_volume-0.0.1.dev17-py2-none-any.whl (26.1 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page