ASFSearchOptions#
Description#
This class describes a set of search parameters. While it is not required to use this class when constructing a search, it can be useful, as it provides some degree of immediate parameter validation, as well as a convenient way to manipulate and handle search options in general.
Specific search parameters are handled as object attributes. Attempting to add an attribute that is not supported will raise a KeyError. Attempting to delete an attribute will result in it being set to None. Search parameters can be set via kwargs at object instantion, or directly on an existing object using the normal mechanisms.
Converting to a dict
will only include search options which have actually been set to a usable value. That is, any options set to None
will be ignored.
Attributes#
- maxResults
- absoluteBurstID
- absoluteOrbit
- asfFrame
- beamMode
- provider
- collectionName
- maxDoppler
- minDoppler
- maxFaradayRotation
- minFaradayRotation
- flightDirection
- flightLine
- fullBurstID
- frame
- granule_list
- product_list
- intersectsWith
- lookDirection
- offNadirAngle
- operaBurstID
- platform
- polarization
- processingLevel
- relativeBurstID
- relativeOrbit
- processingDate
- start
- end
- season
- groupID
- insarStackId
- instrument
- session
Methods#
ASFSearchOptions does not provide any methods intended for direct use, instead relying on a handful of dunders for the desired behavior. For clarity, these are included below.
init()#
Establishes the various attributes described above and processes any kwargs into them.
args:
- **kwargs, limited to names listed as attributes above. Anything else will raise a
KeyError
returns: None
setattr()#
Sets the attribute named by key
to the specified value
after passing it through an appropriate validator function.
Values of None
are allowed as a way to un-set the attribute. Attempting to set a key
not listed in the above attribute list will raise a KeyError
args:
- key: the name of the attribute to set
- value: the value to which the named attribute should be set
returns: None
delattr()#
Clears an attribute names by item
by way of setting it to None
args:
- item: the name of the attribute to be cleared
returns: None
iter()#
Used when converting the ASFSearchOptions object to more fundamental objects, such as dict
Only includes attributes that are not None
.
args: None
yields:
- (key, value) pairs for each of the above attributes that are not
None