README.md

In NCSABrownDog/bd.r: Brown Dog R Interface

Brown Dog R Library (bd.r)

Installation

• Download R from any one of the mirror sites listed here: https://cran.r-project.org/mirrors.html
• Install R by following the instructions provided in the website: https://cran.r-project.org/doc/manuals/r-release/R-admin.html#Installation
• Install devtools using the instructions provided here: https://www.r-project.org/nosvn/pandoc/devtools.html
• Run the following commands after opening an R Console to install the BD.r library:

  library(devtools)
  install_github("NCSABrownDog/bd.r")
  library(BrownDog)
  

Some example input files and outputs

• A set of example files for testing can be found here: https://browndog.ncsa.illinois.edu/examples/caltech101/

• Index method creates .index.tsv file with file name and corresponding tags and content descriptors obtained from Brown Dog service. An example .index.tsv file content is shown below:

  airplane.jpg    [[0.0721,0.0508,0.777,0.1001,0,0,0,0],[0.1502,0.2493,0.5582,0.0424,0,0,0,0],[0.137,0.0398,0.7637,0.0594,0,0,0,0]]
  
  brontosaurus.jpg
  
  cougar.jpg  [[0.2571,0.5403,0.1928,0.0098,0,0,0,0],[0.4692,0.5001,0.0308,0,0,0,0,0],[0.3381,0.59,0.0713,0.0007,0,0,0,0]]
  
  dollar_bill.jpg ["Human Face Automatically Detected"]   ["Person Automatically Detected"]   [[0.2035,0.2141,0.5724,0.0101,0,0,0,0],[0.2509,0.2266,0.5225,0,0,0,0,0],[0.1939,0.2189,0.5707,0.0165,0,0,0,0]]
  
  person.jpg  ["Mid Close Up Automatically Detected"] ["Human Face Automatically Detected"]   ["Person Automatically Detected"]   ["Human Eyes Automatically Detected"]   ["Human Profile Automatically Detected"]    [[0.1969,0.393,0.4079,0.0022,0,0,0,0],[0.1983,0.6102,0.1912,0.0004,0,0,0,0],[0.177,0.5175,0.3048,0.0007,0,0,0,0]]
  

• Find method allows to find similar images in a folder for a given query image using the .index.tsv file. An example output looks like:

  [1] "Distance of each file to the query file"
  <hash> containing 5 key-value pair(s).
  airplane.jpg : 0.2321195
  brontosaurus.jpg : 1.797693e+308
  cougar.jpg : 0.5819163
  dollar_bill.jpg : 0
  person.jpg : 0
  

NCSABrownDog/bd.r documentation built on May 7, 2019, 6:01 p.m.