Extent

Options for searching well-known spatial regions whose coordinates are already known by ScienceBase.

--extent NAME

The name of an extent (such as a state or country) to search. Place the name in quotes if it contains spaces or punctuation. Cannot be used if the --extent-id option is used.

Examples:

# Named extents
pwfdf |command| --extent California
pwfdf |command| --extent "Los Angeles, CA"
pwfdf |command| --extent "Grand Canyon National Park"

# Hydrologic unit codes
pwfdf |command| --extent 05

--extent-id ID

The ID of an extent to search. Cannot be used if the --extent option is used.

Example:

# Searches California
pwfdf |command| --extent-id 35

# Searches the 05 HUC-2 watershed
pwfdf |command| --extent-id 2000387

--extent-type TYPE

The type of extent to search. This option is usually not necessary, but can guard against searching a wrong extent with a similar name.

Tip

Use the pwfdf extents types command to obtain a list of supported types.

Example:

pwfdf |command| --extent "Los Angeles, CA" --extent-type "U.S. County"

--extent-relation RELATION

The spatial relationship between the extent and the search results. Options are:

Relation	Description
intersects (default)	Matches assessments that intersect the extent at any point.
within	Matches assessments that are fully contained within the extent.
disjoint	Matches assessments that do not intersect the extent at any point.

Example:

pwfdf |command| --extent California --extent-relation within