Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Cinema:library repository DEPRICATED

This repository has been DEPRICATED. Cinema tools are now available under the cinemasci repository.

cinema_lib is a set of tools and library for interacting with a Cinema database (currently Spec A and Spec D) through Python and the command line tool, cinema.

Requirements

Minimum requirements are:

  • Python 3.6
  • numpy >=1.13
    • image capabilities
    • OpenCV capabilities
  • scikit-image >=0.13.1 (newer versions may cause regression tests to fail due to changing numerics and implementations of algorithms)
    • image capabilities

Optional requirements are:

  • opencv-python >=3.4 (newer versions may cause regression tests to fail due to changing numerics)
    • OpenCV capabilities

Installation

This command will install cinema_lib in your current directory: With curl:

curl -s "https://raw.githubusercontent.com/cinemascience/cinema_lib/master/install.sh" | sh

To install with missing dependencies:

curl -s "https://raw.githubusercontent.com/cinemascience/cinema_lib/master/install.sh" | sh -- -f

With wget:

wget -qO - "https://raw.githubusercontent.com/cinemascience/cinema_lib/master/install.sh" | sh

To install with missing dependencies:

wget -qO - "https://raw.githubusercontent.com/cinemascience/cinema_lib/master/install.sh" | sh -- -f

To run the command line tool directly from the repository, after cloning:

$ git clone https://github.com/cinemascience/cinema_lib.git 
$ cd cinema_lib
$ ./cinema

To install with pip:

$ git clone https://github.com/cinemascience/cinema_lib.git
$ cd cinema_lib
$ pip install .
$ cinema

Examples (directly found by running cinema --help)

Help

$ cinema --help

  • get all of the currently implemented commands

Database manipulation

$ cinema -t -a cinema_lib/test/data/sphere.cdb

  • validate a Spec A database

$ cinema -i -d cinema_lib/test/data/sphere.cdb

  • return the header (parameters, columns) for a Spec D database

$ cinema -itvq -d cinema_lib/test/data/sphere.cdb

  • quickly validate a Spec D database and report the header, verbosely

$ cinema -t --a2d -a cinema_lib/test/data/sphere.cdb

  • validate a Spec A database and convert it to a Spec D database

Image examples

$ cinema -d cinema_lib/test/data/sphere.cdb --image-grey 2

  • convert RGB images to greyscale images

$ cinema -d cinema_lib/test/data/sphere.cdb --image-mean 2 --label average

  • calculate the average color per component in images, naming the column "average"

Computer vision examples

$ cinema -d cinema_lib/test/data/sphere.cdb --cv-gaussian-blur 2

  • convert apply a Gaussian blur to images

$ cinema -d cinema_lib/test/data/sphere.cdb --cv-fast-draw 2 --label FAST

  • draw locations of FAST features in images, naming the column "FILE FAST"