Feature Representation

In addition to the generic FME feature attributes that FME Workbench adds to all features (see About Feature Attributes), this format adds the format-specific attributes described in this topic.

Each feature created in FME corresponds to either one data record or the entirety of header records.

There are numerous P190 data record types, each one with different data fields. Each record type corresponds to a feature type in FME. The corresponding feature type will store the data fields as attributes. In some cases, additional location-specific information will be stored as traits of the geometry for the feature type.

Currently data record types “Receiver Group Records (3-D Offshore Surveys)” and “Relation Records (3-D Offshore Surveys) are not supported. If you would like a data record type added, please contact safe@support.com.

The tables below list the FME feature types for “Type 1: Grid or Geographical Coordinates” and “Type 2 data record types, and the attributes each produces.

Feature Type

Attribute Contents

p190_coordinates_points_record

(on reader)

p190_coordinates_record

(on writer)

p190_type

This will always be p190_point.

  p190_record_data

Data record in its entirety.

Range: Alphanumeric string of 80 characters

Default: No default

  p190_filename

File name of the survey.

Range: Any alphanumeric string

Default: No default

  p190_record_identifier

Record identification character

Range:

‘S’ (Centre of Source) |

‘G’ (Receiver Group) |

‘Q’ (Bin Centre) |

‘A’ (Antenna Position) |

‘T’ (Tail buoy Position) |

‘C’ (Common Mid-Point) |

‘V’ (Vessel Reference Point) |

‘E’ (Echo Sounder) |

‘Z’ (Other)

Default: No default

  p190_line_name

Line name

Range: Any alphanumeric string of 12 characters.

Default: No default

  p190_vessel_id

Vessel ID

Range: Any alphanumeric character

Default: No default

  p190_source_id

Source ID Range: Any alphanumeric character

Default: No default

  p190_other_id

Tail buoy or other ID

Range: Any alphanumeric character

Default: No default

  p190_point_number

Point number

Range: Any alphanumeric string of six characters

Default: No default

  p190_latitude Latitude in decimal degrees or grads Range: Any real number Default: No default
  p190_latitude_dir

N/S direction for latitude specified above.

Range: N or S

Default: No default

  p190_longitutde

Longitude in decimal degrees or grads,

Range: Any real number

Default: No default

  p190_longitude_dir

E/W direction for longitude specified above.

Range: W or S

Default: No default

  p190_angular_units

Units for Latitude and Longitude measurements.

Range: DEGREES | GRADS

Default: DEGREES

  p190_easting

Map grid Easting.

Range: Any real number (metres) or any integer value (non metric)

Default: No default

  p190_northing

Map grid Northing.

Range: Any real number (metres) or any integer value (non metric)

Default: No default

  p190_grid_units

Units for X-Y grid measurements.

Range: METRIC | NONMETRIC

Default: METRIC

  p190_depth

Water depth or elevation

Range: Any real number (vertical datum defined) or any integer value (non metric)

Default: No default

  p190_height_units

Units for X-Y grid measurements. Typically the same as p190_grid_units

Range: METRIC | NONMETRIC

Default: METRIC

  p190_date

Julian day of the year

Range: 1 to 366, inclusive.

Default: No default

  p190_time

Time in hours, minutes, seconds with respective to GMT or as defined in p190_gmt_offset

Range: Any three two-digit integer numbers

 

Feature Type

Attribute Contents

p190_offset_points_record

(on reader)

p190_offset_record

(on writer)

p190_type This will always be p190_point.
  p190_record

Data record in its entirety.

Range: Alphanumeric string of 80 characters

Default: No default

  p190_filename

File name of the survey.

Range: Any alphanumeric string

Default: No default

  p190_time_definition

Clock time in respect of GMT (clock display in advance of GMT expressed as GMT + N hours)

Range: Any alphanumeric string of length 48

Default: No default

  p190_record_type_identifier

Record identification character. This will always be “L”.

  p190_record_identifier

Record identification character

Range:

‘S’ (Centre of Source) |

‘G’ (Receiver Group) |

‘Q’ (Bin Centre) |

‘A’ (Antenna Position) |

‘T’ (Tail buoy Position) |

‘C’ (Common Mid-Point) |

‘V’ (Vessel Reference Point) |

‘E’ (Echo Sounder) |

‘Z’ (Other)

Default: No default

  p190_line_name

Line name

Range: Any alphanumeric string of 12 characters

Default: No default

  p190_point_number

Point number

Range: Any alphanumeric string of six characters

Default: No default

  p190_point_suffix

Suffix to point number for fractional intervals or point descriptors

Range: Any alphanumeric string of three characters

Default: No default

  p190_northerly_offset

Offset of point from reference point in Northerly direction. Positive represents North; Negative represents South.

Range: Any real number

Default: No default

  p190_easterly_offset

Offset of point from reference point in Easterly direction. Positive represents East; Negative represents West.

Range: Any real number

Default: No default

  p190_depth

Elevation or water depth.

Range: Any real number

Default: No default

  p190_reference_name

Name of reference point

Range: Any alphanumeric string of 16 characters.

Default: No default

  p190_reference_latitude

Reference point latitude in degrees, minutes, seconds with a single direction character.

Range: Two two-digit numbers, followed by a real number, ending with either “N” or “S”.

Default: No default

  p190_reference_longitude

Reference point longitude in degrees, minutes, seconds with a single direction character.

Range: Two two-digit numbers, followed by a real number, ending with either “E” or “W”.

Default: No default

Feature Type

Attribute Contents
p190_control_file_lines_record p190_type This will always be p190_line
  p190_record_type

Record Identification character.

Single character identifier for the type of record this is.

  p190_line_name

Line name

Range: Any alphanumeric string of a length specified in the control file.

Default: No default

 

Feature Type

Attribute Contents
p190_control_file_points_record p190_type This will always be p190_point.
  p190_latitude

Latitude in decimal degrees or grads

Range: Any real number

Default: No default

  p190_longitude

Longitude in decimal degrees or grads,

Range: Any real number

Default: No default

  p190 _easting

Map grid Easting.

Range: Any real number (metres) or any integer value (non metric)

Default: No default

  p190 _northing

Map grid Northing.

Range: Any real number (metres) or any integer value (non metric)

Default: No default

  p190 _depth

Water depth or elevation

Range: Any real number (vertical datum defined) or any integer value (non metric)

Default: No default

  p190 _point_number

Point number

Range: Any alphanumeric string of a length specified in the control file.

Default: No default

  p190_line_name

Line name

Range: Any alphanumeric string of a length specified in the control file.

Default: No default

  p190_filename

File name of the survey.

Range: Any alphanumeric string

Default: No default

 

Feature Type

Attribute Contents

p190_coordinates_lines_record

(reader only)

p190_line_name

Line name

Range: Any alphanumeric string of 12 characters.

Default: No default

  p190_type

This will always be p190_line.

  p190_record_identifier

Record identification character

Range:

‘S’ (Centre of Source) |

‘G’ (Receiver Group) |

‘Q’ (Bin Centre) |

‘A’ (Antenna Position) |

‘T’ (Tail buoy Position) |

‘C’ (Common Mid-Point) |

‘V’ (Vessel Reference Point) |

‘E’ (Echo Sounder) |

‘Z’ (Other)

Default: No default

  p190 _longitude_dir

E/W direction for longitude specified above.

Range: W or S

Default: No default

  p190 _latitude_dir

N/S direction for latitude specified above.

Range: N or S

Default: No default

  p190_filename

File name of the survey.

Range: Any alphanumeric string

Default: No default

 

Feature Type

Attribute Contents

p190_offset_lines_record

(reader only)

p190_line_name

Line name

Range: Any alphanumeric string of 12 characters.

Default: No default

  p190_record_identifier

Record identification character. This will always be "L".

  p190 _longitude_dir

E/W direction for longitude specified above.

Range: W or S

Default: No default

  p190 _latitude_dir

N/S direction for latitude specified above.

Range: N or S

Default: No default

  p190_filename

File name of the survey.

Range: Any alphanumeric string

Default: No default

Each P1/90 file contains several header records, which are accumulated into one FME feature type. Each different header is parsed corresponding to the header record type, and the fields are stored as list attributes on the header feature type. For header feature types, p190_type will always be p190_none.

The default value for non-coordinate system related records (datum, projection, and units) is “N/A”.

The default for datum is WGS-84.

The default for projection is UTM.

The default for units is metric and degrees.

Notes:

The reader header feature will produce the attributes header_description for the p190_onboard_system and for the p190_offset records. This is to allow the header descriptions for those fields to be written out if a file is round-tripped through FME.

While these attributes do not show up on the schema and are not created automatically for other fields, they can be added manually in the form of

p190_issue_date{0}.header_description

where p190_issue_date is the desired header record.

The writer will look for these attributes and write them out if they exist; otherwise, it will write out default values.

There is also a header_last_digits attribute for the p190_offset and the p190_sgsi_comment records: this determines the last two digits of the H09XX value and the last digit of the H800X value. The header_last_digits attribute will only work for these two record types.