You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

To Do:

  • get slides and handouts from XSEDE demo
  • go to Bitbucket and get the -h output for all the flags
  • Sandeep's Big Data flag will be the only thing missing

The Brown Dog Command Line Interface (BD-CLI) provides users with an easy to use interface to Brown Dog services. It talks to various components of Brown Dog through its API. It can be used to do operations like file conversions and extractions. Please see the README for current instructions.

Installation

You can install BD-CLI either from the PyPi repository or from our Bitbucket repository.

PyPi repository

  1. Create a Python virtual environment in your computer using virtualenv, virtualenvwrapper or by another method.
  2. Activate the created Python virtual environment
  3. Run ```pip install bdcli```

Help

Below you can see the output of  command

bd -h

, which basically describes how to use this client. 

BD-CLI Help
Brown Dog Command-Line Interface (BD-CLI)

=========================================

bd [OPTION] [FILE/DIRECTORY]

-----------------------------

Command line interface to Brown Dog services. Use to convert files between formats and extract various derived products

from file contents (e.g. tags, metadata, signatures, previews).

-b set the BD URL (e.g. https://bd-api.ncsa.illinois.edu)

-t set the token

-v verbose output

-w set wait time for conversions/extractions

-h display help

-o set output format

--outputs list the available output formats for the given file

--extractors list the available extractors for the given file

--find search current directory for a file similar to the given file

--bigdata use this flag if the file is large enough and it needs to be processed locally rather than using remote

 Brown Dog services

 **Examples:**

List available output formats for given file:

  bd --outputs image.pcd

Convert the given Kodak Photo CD image to a JPEG image.  Produces file image.jpg:

  bd -o jpg image.pcd

Convert a directory of images into the JPEG format:

  bd -o jpg images/

List available extractors for given file:

  bd --extractors image.jpg

Extract data from files contents (e.g. tags, previews, analysis, and other derived products).  Produces file image.json:

  bd image.jpg

Chain conversion and extraction.  Equivalent to the previous two examples:

  bd -o jpg image.pcd | bd

Index files within a directory:

  bd images/

Search for a similar file within a directory that has already been indexed:

  bd --find /path/image.jpg



  • No labels