Resumen
Calcula los valores que se computan de la diferencia entre entidades de orden sucesivo en un recorrido. Se crea una nueva clases de entidad de línea para representar los intervalos de rastreo y almacenar los valores calculados (distancia, duración, velocidad y curso).
Ilustración
Uso
Para que esta herramienta funcione, la capa o clase de entidad de entrada debe tener información de fecha y hora incluida en un campo de hora único del tipo de datos texto, corto, largo, flotante, doble o fecha. Si el tipo de datos del campo de hora es fecha, la herramienta detectará automáticamente el formato. Si el tipo de datos del campo de hora es cualquier otro que no sea fecha, se requerirá un formato de campo de hora (y posiblemente otro tipo de información para el tipo de datos del campo de hora texto) para analizar los valores de los datos correctamente.
Si el campo de hora seleccionado es texto, corto, largo, flotante o doble, el formato del campo de hora se puede seleccionar en una lista de formatos del campo de hora admitidos, o puede definir un formato del campo de hora personalizado para interpretar los valores de fecha u hora personalizados en un campo de texto. Para obtener más información acerca de los formatos personalizados para los campos de texto, consulte convertir valores de hora de cadena de texto en formato de fecha.
Esta herramienta genera automáticamente los nombres de campo de salida que almacenan los valores calculados en la clase de entidad de salida y autogenera el nombre que incluye una abreviatura de las unidades utilizadas.
Sintaxis
arcpy.ta.TrackIntervalsToLine(in_features, out_feature_class, time_field, {track_id_field}, {time_field_format}, {locale_id}, {am_designator}, {pm_designator}, {distance_field_units}, {distance_field_name}, {duration_field_units}, {duration_field_name}, {speed_field_units}, {speed_field_name}, {course_field_units}, {course_field_name})| Parámetro | Explicación | Tipo de datos |
in_features | La capa o clase de entidad de entrada. | Feature Layer |
out_feature_class | La clase de entidad de línea de salida que se creará. | Feature Class |
time_field | El campo en la capa o clase de entidad de entrada que contiene información de fecha y hora. Esta herramienta requiere que la información de fecha y hora estén en el mismo campo y el tipo de datos del campo debe ser corto, largo, flotante, doble, texto o fecha. | Field |
track_id_field (Opcional) | El campo que contiene los valores de datos que se utilizan para agrupar entidades de entrada en los recorridos. El tipo de datos de campo puede ser corto, largo, flotante, doble, texto u OID. | Field |
time_field_format (Opcional) | Si el tipo de dato del campo de tiempo es distinto de fecha, este parámetro determina el formato que se utiliza para interpretar los valores de datos en el campo de tiempo. Algunos ejemplos de formatos se detallan a continuación:
Si el tipo de dato del campo de tiempo es texto, se puede utilizar un formato de hora de texto estándar de Esri o se puede especificar un formato personalizado. Sin embargo, los formatos personalizados no se pueden utilizar si especificó KEEP_ON_DISK para la política de almacenamiento. Si el tipo de dato del campo de tiempo es numérico (corto, largo, flotante o doble), sólo se pueden utilizar los formatos de hora numéricos estándar de Esri. Si el tipo de dato del campo de tiempo es fecha, este parámetro no es necesario. | String |
locale_id (Opcional) | Si el tipo de dato del campo de tiempo es texto, este parámetro determina la configuración regional que se utiliza para interpretar los valores de datos en el campo de tiempo. Para todos los tipos de datos del campos de tiempo distintos de texto, este parámetro no es necesario. Si no se introduce ninguna configuración regional, se utiliza la configuración regional actual del sistema operativo. Para obtener una lista de las configuraciones regionales compatibles con el sistema, abra el cuadro de diálogo de la herramienta y expanda esta lista desplegable. Cuando se introduce la configuración regional como parámetro, se recomienda utilizar sólo el Id. de configuración regional (LCID) asignado por Microsoft, que se puede introducir como un entero largo como, por ejemplo, 1033. También puede introducir la representación de cadena de caracteres completa de la configuración regional como parámetro como, por ejemplo, "01033-English_(United_States)", pero debe reemplazar los espacios por guiones bajos. | Long |
am_designator (Opcional) | Si el tipo de dato del campo de tiempo es texto y el formato de hora es una representación de reloj de 12 horas que incluye un marcador de hora (t o tt), este parámetro determina el carácter (t) o los caracteres (tt) que designan AM en los valores de datos del campo de tiempo. Si no se introduce nada, se utiliza la designación de AM predeterminada para la configuración regional seleccionada. Para todos los tipos de datos del campos de tiempo distintos de texto, este parámetro no es necesario. | String |
pm_designator (Opcional) | Si el tipo de dato del campo de tiempo es texto y el formato de hora es una representación de reloj de 12 horas que incluye un marcador de hora (t o tt), este parámetro determina el carácter (t) o los caracteres (tt) que designan PM en los valores de datos del campo de tiempo. Si no se introduce nada, se utiliza la designación de PM predeterminada para la configuración regional seleccionada. Para todos los tipos de datos del campos de tiempo distintos de texto, este parámetro no es necesario. | String |
distance_field_units (Opcional) | Especifica las unidades de distancia que se utilizarán en el campo de distancia de salida.
| String |
distance_field_name (Opcional) | Especifica el nombre del campo de distancia que se agregará a la capa o clase de entidad de entrada. Si no se especifica ningún nombre de campo, se elige un nombre automáticamente. | String |
duration_field_units (Opcional) | Especifica las unidades de tiempo que se utilizarán en el campo de duración de salida.
| String |
duration_field_name (Opcional) | Especifica el nombre del campo de duración que se agregará a la capa o clase de entidad de entrada. Si no se especifica ningún nombre de campo, se elige un nombre automáticamente. | String |
speed_field_units (Opcional) | Especifica las unidades de velocidad que se utilizarán en el campo de velocidad de salida.
| String |
speed_field_name (Opcional) | Especifica el nombre del campo de velocidad que se agregará a la capa o clase de entidad de entrada. Si no se especifica ningún nombre de campo, se elige un nombre automáticamente. | String |
course_field_units (Opcional) | Especifica las unidades de curso que se utilizarán en el campo de curso de salida.
| String |
course_field_name (Opcional) | Especifica el nombre del campo de curso que se agregará a la capa o clase de entidad de entrada. Si no se especifica ningún nombre de campo, se elige un nombre automáticamente. | String |
Muestra de código
TrackIntervalsToLine ejemplo del uso de campo de datos y unidades predeterminadas y nombres de campos de salida
Este ejemplo muestra cómo ejecutar la herramienta en la clase de entidad cuyo campo de fecha utiliza los nombres de campos de salida y unidades predeterminadas.
import arcpy
arcpy.CheckOutExtension("tracking")
in_features = "C:\Data\Vehicles.gdb\Planes"
out_feature_class = "C:\Data\Vehicles.gdb\Plane_Intervals"
time_field = "DATE_TIME"
track_id_field = "ACID"
arcpy.TrackIntervalsToLine_ta(in_features, out_feature_class, time_field, track_id_field)
TrackIntervalsToLine ejemplo del uso de campo fecha de texto, unidades personalizadas y nombres de campos personalizados
Este ejemplo muestra cómo ejecutar la herramienta sobre una clase de entidad con un campo fecha de tipo de datos texto, especificando los nombres de campos y unidades personalizadas.
import arcpy
arcpy.CheckOutExtension("tracking")
in_features = "C:\Data\Vehicles.gdb\Planes"
out_feature_class = "C:\Data\Vehicles.gdb\Plane_Intervals_2"
time_field = "DATE_TEXT"
track_id_field = "ACID"
time_field_format = "MM/dd/yyyy HH:mm:ss"
distance_field_units = "MILES"
distance_field_name = "DISTANCE"
duration_field_units = "SECONDS"
duration_field_name = "DURATION"
speed_field_units = "KILOMETERS_PER_HOUR"
speed_field_name = "SPEED"
course_field_units = "DEGREES"
course_field_name = "HEADING"
arcpy.TrackIntervalsToLine_ta(in_features, out_feature_class, time_field, track_id_field, time_field_format, "", "", "", distance_field_units, distance_field_name, duration_field_units, duration_field_name, speed_field_units, speed_field_name, course_field_units, course_field_name)
Entornos
Esta herramienta no utiliza ningún entorno de geoprocesamiento.
Información de licenciamiento
- Basic: Requiere Tracking Analyst
- Standard: Requiere Tracking Analyst
- Advanced: Requiere Tracking Analyst