Options

Option	Meaning	Default
`-k <int>`	Specify maximum Number of Candidates to return	size of gallery
`-m <float>`	Specify candidate Minimum Similarity	`0.0`
`-r`	Re-order candidates using roc_rerank	Don't re-order candidates
`–search-persons`	Call roc_search_persons	Call roc_search
`–one-candidate-per-person-id`	Candidates in person search must have different person ID	`false`
`–ignore-identical`	Ignore identical comparisons in a person search	`false`
`–consolidate <float>`	roc_consolidate_candidates with the specified minimum similarity	Don't consolidate candidates
`-c <key>,<key>,...<key>`	Concise TSV output with just the similarity score and values for the specified metadata keys	Verbose JSON output
`–csv`	Concise outputs as a CSV instead of TSV. `-c` is Required	`false`

Examples

Show help

Print application usage and supported arguments.

$ roc-search -h

Run a search

Write the metadata of the top candidate templates in gallery.t for a template probe.t to candidates.json.

$ roc-search gallery.t probe.t candidates.json

Find the nearest match

Write the metadata of the top candidate template in gallery.t for a template probe.t to candidate.json.

$ roc-search -k 1 gallery.t probe.t candidate.json

Run a search to stdout

Print the metadata of the top candidate templates in gallery.t for a template probe.t to stdout.

$ roc-search gallery.t probe.t > candidates.json

Run a search with concise CSV output

Print the specified metadata values of the top candidate templates in gallery.t for a template probe.t to stdout.

$ roc-search gallery.t probe.t -c Path,Index,Quality

Unique concise output keys:

Probe_* Print metadata associated with the probe template
Rank Candidate template result compared to other templates in the gallery. Rank 1 is the highest scoring candidate in the set.
```
$ roc-search gallery.t probe.t --csv -c Path,TemplateID,PersonID,Probe_PersonID,Probe_TemplateID,Rank 
```