Introduction
This document describes the field attributes that are supported and/or used when integrating the Bad Elf Flex with Esri's ArcGIS Field Maps app. These are used to support high-accuracy data collection and laser offset measurements.
Esri provides detailed instructions for preparing for high-accuracy data collection. Once completed, your feature classes should have the following GNSS-related feature attributes. These fields will be populated automatically when Field Maps is configured to use a Bad Elf GNSS receiver as its location provider.
Field Name | Alias | Description | Type |
geometry.x | Latitude | The latitude of the feature or target, after transformations have been applied by Field Maps | D |
geometry.y | Longitude | The longitude of the feature or target, after transformations have been applied by Field Maps | D |
geometry.z | Orthometric height | The final Orthometric height (MSL) of the feature or target, after any transformations have been applied by Field Maps | D |
esrignss_receiver | Receiver Name | Name and serial number of external GNSS receiver (ie: Bad Elf Flex #12345) | S |
esrignss_latitude | Latitude | Latitude of the actual point or calculated offset point, before any transformations have been applied | D |
esrignss_longitude | Longitude | Longitude of the actual point or calculated offset point, before any transformations have been applied. | D |
esrignss_altitude | Altitude | Final ellipsoidal height (HAE) of the feature in meters, before any transformations have been applied | D |
esrignss_fixdatetime | Fix Time | Data and time of the GNSS point | U |
esrignss_positionsourcetype | Position source type | ESRI_POSITIONSOURCETYPE_DOMAIN: 0 : Unknown 1 : User defined 2: Integrated (System) Location Provider 3 : External GNSS receiver 4 : Network location provider
| I |
For capturing single-shot (1 epoch) GNSS points, the following fields will be populated:
Field Name | Alias | Description | Type |
esrignss_h_rms | Horizontal Accuracy (m) | Estimated horizontal accuracy in meters | D |
esrignss_v_rms | Vertical Accuracy (m) | Estimated vertical accuracy in meters | D |
esrignss_pdop | PDOP | Positional dilution of precision value | D |
esrignss_hdop | HDOP | Horizontal dilution of precision value | D |
esrignss_vdop | VDOP | Vertical dilution of precision value | D |
esrignss_fixtype | Fix Type | ESRI_FIX_TYPE_DOMAIN: | I |
esrignss_correctionage | Correction Age | Age of the correction source in seconds | I |
esrignss_stationid | Station ID | Station ID providing SBAS/RTK corrections | I |
esrignss_numsats | Number of Satellites | ESRI_NUM_SATS_DOMAIN: Range 0-99 | I |
esrignss_speed | Speed (km/h) | Ground speed | D |
esrignss_direction | Direction of travel (°) | Track of movement over ground | D |
esrisnsr_azimuth | Azimuth | Compass heading from phone or tablet | D |
For capturing an averaged position from 2 or more GNSS points, the following fields will be populated:
Field Name | Alias | Description | Type |
esrignss_avg_h_rms | Average Horizontal Accuracy (m) | The average horizontal accuracy of the points used to calculate the position | D |
esrignss_avg_v_rms | Average Vertical Accuracy (m) | The average vertical accuracy of the points used to calculate the position | D |
esrignss_avg_positions | Averaged Positions | The number of points used to calculate the average position | D |
esrignss_h_stddev | Standard Deviation (m) | The horizontal standard deviation of the points used to calculate the average position | D |
Bad Elf's Custom Field Attributes
Building on the metadata fields above, Bad Elf has defined a set of feature attribute fields to support high-accuracy data collection and offset measurements. The goal of these fields is to preserve all the metadata associated with a point and collection method. They are broken into logical groups depending on your collection needs.
Visit our Adding Bad Elf custom field attributes to your ArcGIS feature class article for further instructions and tools.
High-Accuracy GNSS Fields
The following fields are used for capturing metadata associated with a single GNSS point.
Field Name | Alias | Description | Type |
badelf_latitude | Bad Elf Latitude | The raw latitude reported by the Bad Elf GNSS receiver; for offset measurements, same as ESRIGNSS_LATITUDE. | D |
badelf_longitude | Bad Elf Longitude | The raw longitude reported by the Bad Elf GNSS receiver; for offset measurements, same as ESRIGNSS_LONGITUDE. | D |
badelf_ellipsoidal_m | Ellipsoidal height (m) | The raw ellipsoidal height (HAE) reported by the Bad Elf GNSS receiver; for offset measurements, this value is the same as BADELF_FINAL_ELLIPSOIDAL_M. | D |
badelf_datum | Datum | The datum in use, with a _EPSG suffix, if known. For example: WGS84_4326 ITRF2000_8997 ITRF2008_8999 NAD83(2011)_6318
| S |
badelf_ntrip_mount | NTRIP Mount | The name of the NTRIP mount point used for RTK corrections | S |
badelf_corr_type | Correction Type | The correction type associated with this point (BADELF_CORR_TYPE_DOMAIN): 0: NONE 1: SBAS 2: RTCM 3: ATLAS
| I |
badelf_corr_distance_km | Correction Distance (km) | The baseline distance to the correction source (in kilometers) | D |
badelf_point_name | Point Name | User defined point name, will be auto-incremented by default | S |
badelf_note | Note | User and/or Bad Elf generated metadata about this point |
|
For capturing additional information about the elevation and orthometric height:
Field Name | Alias | Description | Type |
badelf_final_ortho_height_m | Final Orthometric Height (m) | The final orthometric height (MSL) after subtracting the geoid offset and antenna height from the receiver's reported ellipsoidal height | D |
badelf_final_ellipsoidal_m | Final Ellipsoidal Height (m) | The final ellipsoidal height (HAE) after subtracting antenna height from the receiver's reported ellipsoidal height | D |
badelf_ortho_geoid_m | Geoid Offset (m) | The geoid offset/undulation specified by geoid model at the current position | D |
badelf_ortho_model | Geoid Model | The name of the GEOID model in use, for example:
See: supported GEOID models | S |
badelf_antenna_height_m | GNSS Antenna Height (m) | Height of the antenna above ground
Pole height + antenna reference position (ARP)
ARP of the Bad Elf Flex is 0.23m. | D |
Offset Measurement Fields
When collecting offset points using a laser rangefinder, the following field attributes will be populated.
Field Name | Alias | Description | Type |
badelf_offset_method | Offset Method | Range-Range, Range-Azimuth, etc | S |
badelf_offset_device | Rangefinder Name | Laser device model and serial number | S |
badelf_offset_laser_ht_m | Rangefinder Height (m) | Laser rangefinder pole height above ground | D |
badelf_offset_magdec | Magnetic Declination (°) | Magnetic declination used in Range-Azimuth method | D |
badelf_offset_azi_source | Azimuth Source | Source of the azimuth data used for offset positioning, for example: RANGEFINDER_COMPASS COMPUTED (Range-Range)
| S |
All offset measurement methods require at least one control point, designated Control Point #1 (CP1).
Field Name | Alias | Description | Type |
badelf_cp1_latitude | CP1 Latitude | Latitude reported by receiver | D |
badelf_cp1_longitude | CP1 Longitude | Longitude reported by receiver | D |
badelf_cp1_final_ortho_height_m | CP1 Final Orthometric Height (m) | Final orthometric height (see FINAL_ORTHO_HEIGHT_M above) | D |
badelf_cp1_fixdatetime | CP1 Fix Date/Time | Date and time position was collected | U |
badelf_cp1_h_rms | CP1 HRMS (m) | Horizontal accuracy | D |
badelf_cp1_v_rms | CP1 VRMS (m) | Vertical accuracy | D |
badelf_cp1_numsats | CP1 Number of Sats | ESRI_NUM_SATS_DOMAIN (Range 0-99) | I |
badelf_cp1_fixtype | CP1 Fix Type | See ESRI_FIX_TYPE_DOMAIN above | I |
badelf_cp1_corr_age_sec | CP1 Correction Age | Age of corrections, in seconds | I |
badelf_cp1_station_id | CP1 Station ID | Station ID of correction service | I |
badelf_cp1_avg_positions | CP1 Points Averaged | Number of points used | I |
badelf_cp1_h_stddev | CP1 Horizontal StdDev (m) | Horizontal standard deviation of points used | D |
badelf_cp1_slope_dist_m | CP1 Laser Slope Distance (m) | Slope distance in meters from rangefinder instrument to the target point | D |
badelf_cp1_inclination | CP1 Laser Inclination (°) | The inclination angle from the rangefinder instrument to the target point | D |
badelf_cp1_azimuth | CP1 Laser Azimuth (°) | The azimuth angle from the rangefinder instrument to the target point | D |
For capturing offset measurements via the Range-Range method, a second Control Point (CP2) is required:
Field Name | Alias | Description | Type |
badelf_cp2_latitude | CP2 Latitude | Latitude reported by receiver | D |
badelf_cp2_longitude | CP2 Longitude | Longitude reported by receiver | D |
badelf_cp2_final_ortho_height_m | CP2 Final Orthometric Height (m) | Final orthometric height (see FINAL_ORTHO_HEIGHT_M above) | D |
badelf_cp2_fixdatetime | CP2 Fix Date/Time | Date and time position was collected | U |
badelf_cp2_h_rms | CP2 HRMS (m) | Horizontal accuracy | D |
badelf_cp2_v_rms | CP2 VRMS (m) | Vertical accuracy | D |
badelf_cp2_numsats | CP2 Number of Sats | ESRI_NUM_SATS_DOMAIN (Range 0-99) | I |
badelf_cp2_fixtype | CP2 Fix Type | See ESRI_FIX_TYPE_DOMAIN above | I |
badelf_cp2_corr_age_sec | CP2 Correction Age | Age of corrections, in seconds | I |
badelf_cp2_station_id | CP2 Station ID | Station ID of correction service | I |
badelf_cp2_avg_positions | CP2 Points Averaged | Number of points used | I |
badelf_cp2_h_stddev | CP2 Horizontal StdDev (m) | Horizontal standard deviation of points used | D |
badelf_cp2_slope_dist_m | CP2 Laser Slope Distance (m) | Slope distance in meters from rangefinder instrument to the target point | D |
badelf_cp2_inclination | CP2 Laser Inclination (°) | The inclination angle from the rangefinder instrument to the target point | D |
badelf_cp2_azimuth | CP2 Laser Azimuth (°) | The azimuth angle from the rangefinder instrument to the target point
| D |
For capturing the height of the target above the ground, the following field is defined:
Field Name | Alias | Description | Type |
badelf_height_agl_m | Height (m) | Height of target feature above ground | D |
Field Type Legend