Versions Compared

Old Version 5

changes.mady.by.user Daniel Flath

Saved on

compared with

New Version 6

changes.mady.by.user Daniel Flath

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Alright, here's what it all means:

Arguments to 'find' command: 

Argument

Explanation

<logical folder>

This parameter is required and comes after all options are specified.  Replace it with the Data Catalog folder path where you want to begin your search.
The more specific you are, the faster your search will be.

--recurse

If you specify this option, the find command will traverse the folder tree under <logical folder> in it's quest to provide you with the data you desire.

--search-folders

Tells find to look inside the folder (or folders if --recurse specified) and consider datasets that live there.  In general, datasets live in groups, and this option is not used.

--search-groups

Tells find to look inside all dataset groups in the specified folder (or folder tree if using --recurse) for your files.  May be combined with --search-folders and --recurse.
Has no meaning if --group is also specified.

--group <group name>

Tells find to look inside groups only if they have the name specified by <group name>.  May be used with --recurse to search in groups of the given name in a folder tree.

--site <site name>



Specifies the a specific site you want to get datasets from.  May be used multiple times to specify a list of sites to search where order indicates preference.
If no sites are specified, the 'master' location is returned.  This will generally be a file in XROOT. 

--filter <filter expression>

Also known as "search criteria" is an expression using logical operators, meta-data fields and constant values on which to filter the output results.

--sort <meta name>

Specifies the name of the specific meta-data field on which to sort the output results.  May be used multiple times to specify a list of fields to sort on where order indicates preference.
Sorting may add a significant overhead to the time it takes to start getting results, as the entire output set must be calculated, then sorted, before being displayed.
Currently only 'ascending' sort is supported

*Important note:  At least one of --search-folders, --search-groups, --group <group name> must be specified.

<site name> Valid values:

SLAC_XROOT

XROOT servers at SLAC.  Almost everything lives here.

SLAC

NFS (or AFS) at SLAC.  Some FT1 and FT2 data are stored here until the ftools learn to read from XROOT.

IN2P3

Some Monte Carlo data is stored at Lyon

IN2P3_HPSS

Lyon Monte Carlo backups

UW

University of Washington.

<filter expression> Specifics:

 A logical expression used to select datasets that meet specific criteria.

Examples: