Búsqueda#

Cada función de búsqueda devuelve un objeto ASFSearchResults:

geo_search() Encuentre información del producto sobre un área de interés usando una cadena WKT
granule_search() Encuentre información del producto usando una lista de nombres de escenas
product_search() Encuentre información del producto usando una lista de IDs de productos
stack_from_id() Encuentre una pila base de productos usando un ID de escena de referencia
Si los enfoques de búsqueda anteriores no satisfacen sus necesidades, search() soporta todas las palabras clave disponibles:
- search() Encuentre información del producto usando cualquier combinación de parámetros de búsqueda. Consulta la lista de palabras clave a continuación.

Ejemplos de algunos flujos de trabajo de búsqueda se pueden encontrar en este script de muestra. También puede consultar los Jupyter notebooks para flujos de trabajo de ejemplo.

Para un uso más avanzado, consulta las secciones Clase ASFSearchResults y Clase ASFProduct.

Palabras clave#

Las palabras clave se utilizan para encontrar los datos deseados. Usa tantas o tan pocas palabras clave como necesites. A continuación, se enumeran las palabras clave disponibles y sus descripciones. Además, se proporcionan numerosas constantes para facilitar el proceso de búsqueda. Actualmente, proporcionamos constantes para el modo de haz, dirección de vuelo, instrumento, plataforma, polarización y tipo de producto. Puede ver la lista completa de constantes aquí.

Parámetros del conjunto de datos#

dataset
- Esta es la palabra clave alternativa preferida para búsquedas de 'plataforma'.
- Consulta la lista de constantes
- Plataforma de teledetección que adquirió los datos. Puedes especificar un único valor o una lista de valores.
- También puedes obtener la lista disponible de constantes usando help(asf_search.constants.DATASET)
- Ejemplo:
  - dataset=asf.DATASET.OPERA_S1
platform
- Consulta la lista de constantes
- Plataforma de teledetección remota que adquirió los datos. Sentinel-1 y ERS tienen múltiples plataformas de teledetección remota, y puede elegir si deseas especificar una plataforma específica. puede especificar un solo valor o una lista de valores.
- También puede obtener la lista de constantes disponibles utilizando help(asf_search.constants.PLATFORM)
- Ejemplo:
  - platform=asf.PLATFORM.SENTINEL1A
instrument
- Consulta la lista de constantes
- Instrumento de teledetección remota que adquirió los datos. Para algunas plataformas, como ALOS, hay varios instrumentos para elegir.
- También puede obtener la lista de constantes disponibles utilizando help(asf_search.constants.INSTRUMENT)
- Ejemplo:
  - instrument=asf.INSTRUMENT.AVNIR_2
absoluteBurstID
- Utilizado para los productos de ráfaga de Sentinel-1. Cada valor identifica el conjunto de una ráfaga, representando todos los productos generados durante una subfranja específica. puede especificar un solo valor o una lista de valores.
- Ejemplo:
  - valor único: absoluteBurstID='102563902'
  - lista de valores: absoluteBurstID=['102563902', '103558145']
absoluteOrbit
- Para ALOS, ERS-1, ERS-2, JERS-1, RADARSAT-1, Sentinel-1A y Sentinel-1B, este valor corresponde al recuento de órbitas dentro del ciclo orbital. Para UAVSAR, es el ID de vuelo. puede especificar un solo valor, un rango de valores o una lista de valores.
- Ejemplo:
  - valor único: absoluteOrbit=25436
  - rango de valores: absoluteOrbit=(12005, 12008)
  - lista de valores: absoluteOrbit=[25436, 25450]
asfFrame
- Ver también 'frame'
- Esto es principalmente una referencia de marco de ASF / JAXA. Sin embargo, algunas plataformas utilizan otras convenciones. puede especificar un solo valor, un rango de valores o una lista de valores.
- Ejemplo:
  - valor único: asfFrame=300
  - rango de valores: asfFrame=(2845, 2855)
  - lista de valores: asfFrame=[2800, 2845]
- Valores:
- ERS, JERS, RADARSAT: ASF frames 0 to 900
  - ALOS PALSAR: JAXA frames 0 to 7200
  - SEASAT: ESA-like frames 208 to 3458
  - Sentinel-1: In-house values 0 to 1184
beamMode
- Consulta la lista de constantes
- El modo de haz utilizado para adquirir los datos.
- También puede obtener la lista disponible de constantes utilizando help(asf_search.constants.BEAMMODE)
- Ejemplo:
  - beamMode=asf.BEAMMODE.POL
beamSwath
- La franja del haz abarca un ángulo de visión y un modo de haz. puede especificar un solo valor o una lista de valores.
- Ejemplo:
  - valor único: beamSwath='IW'
  - lista de valores: beamSwath=['IW','EW']
campaign
- Solo para conjuntos de datos de UAVSAR, AIRSAR y Sentinel-1 Interferogram. Busca por el nombre de la campaña. puede especificar un solo valor.
- Para obtener una lista de campañas disponibles, utiliza la función asf_search.campaigns(). Debe proporcionar la plataforma deseada.
  - asf_search.campaigns(asf_search.PLATFORM.UAVSAR)
- Ejemplo:
  - campaign='Volcán Puracé, Colombia'
maxDoppler
- El Doppler proporciona una indicación de cuánto se desvía la dirección de observación de la dirección de vuelo ideal perpendicular.
- Ejemplo:
  - maxDoppler=1500 o maxDoppler=1500.5
minDoppler
- El Doppler proporciona una indicación de cuánto se desvía la dirección de observación de la dirección de vuelo ideal perpendicular.
- Ejemplo:
  - minDoppler=100 o minDoppler=1500.5
maxFaradayRotation
- La rotación del plano de polarización de la señal de radar afecta la imaginería. Las señales HH y HV se mezclan. Las rotaciones unidireccionales que exceden los 5° pueden reducir significativamente la precisión de la recuperación de parámetros geofísicos, como la biomasa forestal.
- Ejemplo:
  - maxFaradayRotation=3.5
minFaradayRotation
- La rotación del plano de polarización de la señal de radar afecta la imaginería. Las señales HH y HV se mezclan. Las rotaciones unidireccionales que exceden los 5° pueden reducir significativamente la precisión de la recuperación de parámetros geofísicos, como la biomasa forestal.
- Ejemplo:
  - minFaradayRotation=2
flightDirection
- Consulta la lista de constantes
- Dirección de órbita del satélite durante la adquisición de datos. puede especificar un solo valor.
- También puede obtener la lista disponible de constantes utilizando help(asf_search.constants.FLIGHT_DIRECTION)
- Ejemplo:
  - flightDirection=asf.FLIGHT_DIRECTION.ASCENDING
flightLine
- Especifica una línea de vuelo para UAVSAR o AIRSAR. puede especificar un solo valor.
- Ejemplo:
  - UAVSAR: flightLine='05901'
  - AIRSAR: flightLine='gilmorecreek045-1.93044'
frame
- Consulta también 'asfFrame'
- Los marcos referenciados por la ESA se ofrecen para brindar a los usuarios una convención de marcos universal. A cada marco de la ESA se le asigna un marco ASF correspondiente. puede especificar un solo valor, un rango de valores o una lista de valores.
- Ejemplo:
  - valor único: frame=300
  - rango de valores: frame=(305, 315)
  - lista de valores: frame=[300, 303, 305]
- Valores:
  - Cualquier número del 0 al 7200.
fullBurstID
- Se utiliza para productos de ráfagas Sentinel-1. Cada valor representa todos los productos de ráfagas sobre una sola franja, correspondiente a una pila alineada perfectamente con el marco. Este valor es útil para la pila de líneas base. puede especificar un solo valor o una lista de valores.
- Ejemplo:
  - valor único: fullBurstID='017_034465_IW2'
  - lista de valores: fullBurstID=['017_034465_IW2', '079_167884_IW1']
groupID
- Lista de identificadores de grupo específicos. Para algunos conjuntos de datos, el identificador de grupo es el mismo que el nombre de la escena. Para otros, como Sentinel-1, el identificador de grupo es único para un grupo de escenas.
- Ejemplo:
  - groupID='S1A_IWDV_0112_0118_037147_150'
lookDirection
- Dirección izquierda o derecha de la adquisición de datos. puede especificar un solo valor.
- Ejemplo:
  - lookDirection='L'
- Valores:
  - R, RIGHT, L, LEFT
offNadirAngle
- Ángulos fuera del nadir para ALOS PALSAR. puede especificar un solo valor, un rango de valores o una lista de valores.
- Ejemplo:
  - valor único: offNadirAngle=21.5
  - rango de valores: offNadirAngle=(9.7, 14)
  - lista de valores: offNadirAngle=[21.5, 23.1]
- Valores comunes:
  - Más comunes: 21.5, 23.1, 27.1, 34.3
  - Otros: 9.7, 9.9, 13.8, 14, 16.2, 17.3, 17.9, 18, 19.2, 20.5, 21.5, 23.1, 24.2, 24.6, 25.2, 25.8, 25.9, 26.2, 27.1, 28.8, 30.8, 34.3, 36.9, 38.8, 41.5, 43.4, 45.2, 46.6, 47.8, 49, 50, 50.8
polarization
- Consulta la lista de constantes
- Una propiedad de las ondas electromagnéticas SAR que se puede utilizar para extraer información significativa sobre las propiedades de la superficie de la Tierra. puede especificar un solo valor o una lista de valores.
- También puede obtener la lista de constantes disponibles utilizando help(asf_search.constants.POLARIZATION)
- Ejemplo:
  - polarization=asf.POLARIZATION.VV
processingLevel
- Consulta la lista de constantes
- Nivel al que se ha procesado los datos, también es el tipo de producto.
- También puede obtener la lista de constantes disponibles utilizando help(asf_search.constants.PRODUCT_TYPE)
- Ejemplo:
  - processingLevel=asf.PRODUCT_TYPE.SLC
relativeBurstID
- Se utiliza para productos de ráfagas Sentinel-1. Cada valor identifica un ciclo de ráfagas y dentro de cada subfranja estos valores son únicos. puede especificar un solo valor o una lista de valores.
- Ejemplo:
  - valor único: relativeBurstID='367299'
  - lista de valores: relativeBurstID=['167877', '167882']
relativeOrbit
- Trayectoria o órbita del satélite durante la adquisición de datos. Para UAVSAR es el ID de línea. puede especificar un solo valor, un rango de valores o una lista de valores.
- Ejemplo:
  - valor único: relativeOrbit=5905
  - rango de valores: relativeOrbit=(2400, 2410)
  - lista de valores: relativeOrbit=[500, 580]
- Valores:
  - ALOS: 1-671
  - ERS-1: 0-2410
  - ERS-2: 0-500
  - JERS-1: 0-658
  - RADARSAT-1: 0-342
  - SEASAT: 1-243
  - UAVSAR: various

Parámetros Geoespaciales#

intersectsWith
- Búsqueda por polígono, segmento de línea ("linestring") o punto definido en el formato Well-Known Text (WKT) en 2D. Cada polígono debe estar explícitamente cerrado, es decir, el primer vértice y el último vértice de cada polígono deben ser idénticos. Las coordenadas para cada vértice están en grados decimales: la longitud sigue a la latitud.
- Ejemplo:
  - intersectsWith='POLYGON((-152.81 58.49,-154.90 57.49,-155.08 56.30,-153.82 56.34,-151.99 57.30,-151.43 58.19,-152.81 58.49))'
  - intersectsWith='LINESTRING(-119.543 37.925, -118.443 37.7421)'
  - intersectsWith='POINT(-119.543 37.925)'

Validación de Forma#

Si la AOI especificada es su propio Rectángulo de Contención Mínimo (MBR) en una proyección de Mercator, los resultados de la búsqueda se intersectarán con la AOI en una proyección de Mercator, independientemente de su ancho. Esto sigue siendo cierto incluso si se cruza la línea internacional de cambio de fecha dentro de la AOI.

Para que una AOI sea considerada su propio MBR, debe cumplir con los siguientes criterios:

Cada vértice comparte una latitud o longitud con sus vecinos.
Los puntos Este/Oeste comparten la longitud.
Los puntos Norte/Sur comparten la latitud.

Las AOIs que no cumplen con estos criterios tendrán sus puntos conectados a lo largo de círculos máximos.

Además, todas las AOIs son validadas y, si es necesario, simplificadas según el siguiente proceso:

Validar la AOI de entrada. Si no es válida, se muestra un error.
Fusionar formas que se superpongan.
Cálculo del casco convexo.
Manejo de valores de índice fuera de rango mediante ajuste y envolvimiento a los valores válidos.
Simplificación de puntos según un umbral de proximidad. El objetivo es tener menos de 400 puntos.

Cada uno de estos pasos se realiza solo cuando es necesario para obtener una AOI con un único contorno con menos de 400 puntos. Se omiten los pasos innecesarios.

Ejemplos de validación y simplificación:

Se proporciona un polígono que se auto-intersecta:
- Se muestra un error.
Se proporciona un único contorno que consta de 1000 puntos:
- Se utiliza una versión simplificada del mismo contorno con menos de 400 puntos.
Se proporcionan múltiples geometrías, todas ellas se superponen al menos en parte:
- Se devuelve un único contorno que representa el contorno de todas las formas combinadas.
Se proporcionan múltiples geometrías, al menos algunas de ellas no se superponen en absoluto:
- Se devuelve un único contorno que representa el casco convexo de todas las formas juntas.

Parámetros Temporales#

processingDate
- Limita los resultados a registros que han sido procesados en ASF desde una fecha y/o hora dada.
- Ejemplo:
  - processingDate='2017-01-01T00:00:00UTC'
start
- Fecha de adquisición de datos. Puede usarse en combinación con 'end'. puede ingresar fechas en lenguaje natural o un sello de fecha y/o tiempo. Todos los horarios están en UTC.
- Ejemplo:
  - start='30 de mayo de 2019'
  - start='ayer'
  - start='2010-10-30T11:59:59Z'
  - start='hace 1 semana', end='ahora'
end
- Fecha de adquisición de datos. Puede usarse en combinación con 'start'. puede ingresar fechas en lenguaje natural o un sello de fecha y/o tiempo. Todos los horarios están en UTC.
  - end='30 de mayo de 2018'
  - end='hoy'
  - end='2021-04-30T11:59:59Z'
  - start='hace 1 semana', end='ahora'
season
- Día de inicio y fin del año para el rango estacional deseado. Esta palabra clave puede usarse junto con start/end para especificar un rango estacional dentro de un rango de fechas general. Los valores se basan en el calendario juliano. especificar tanto una fecha de inicio como una de fin de temporada.
- Ejemplo:
  - season=[1, 31]
  - season=[45, 67]
  - season=[360, 10]
- Valores:
  - Del 1 al 365

Parámetros de Línea de Base#

stack_from_id
- Ingrese el nombre de la escena para la cual deseas ver resultados de la línea de base.
- stack_from_id no puede utilizarse en conjunción con otras palabras clave.
- Ejemplo:
  - stack_from_id('S1A_IW_SLC__1SDV_20220215T225119_20220215T225146_041930_04FE2E_9252-SLC')
- Consulta el Jupyter notebook para ejemplos de uso y mejores prácticas.

Parámetros de Resultados#

maxResults
- Número máximo de registros de datos a devolver.
- Ejemplo:
  - maxResults=10