Protocol Documentation

[optional] A short description for the partition.

[required] The unique external identifier for the partition.

[optional] A short description for the seismic

[required] An externally correlatable unique identifier for the seismic

[required] The owning partition

Deprecated**: Defines the volume as VolumeDef format. Use `two_dee_extent` or `three_dee_extent`.

Defines the volume as WKT or GeoJson

Will create a seismic with an empty cutout if true

Defines the volume as an extent. Only valid if the seismic is 2D

Defines the volume as an extent. Only valid if the seismic is 3D

[optional] Metadata to associate with the seismic.

[optional] A custom text header for the seismic.

[optional] A custom binary header for the seismic.

If true, copy the metadata from the source seismic store.

Valid if the seismic is 2D or 3D

[required] Short descriptive name

[required] Key-value pairs of metadata for the survey.

[required] Identifier for correlation with systems outside CDF

[required] CRS used by all members of the survey

[optional] Specifies a grid transformation to use, overriding the defaults.

[optional] Specifies a coverage to serve as the survey coverage, overriding calculated coverage.

[required] The partition to delete.

[required] The seismic store to delete.

The survey to delete.

[required] The unique identifier for the partition to be edited.

[required] The new name.

Replaces the existing text header, if specified

Replaces the existing binary header, if specified

Deprecated**. Use `identifier` instead.

[optional] The new seismic store name.

[optional] The new seismic store metadata. If set, this will replace the existing metadata.

[required] The seismic store to edit.

[optional] The new external id. Will fail if the new external id is not unique.

[required] The registered source file to edit

[optional] Path including protocol, bucket, directory structure, and file name. Example: "gs://cognite-seismic-eu/samples/DN1302M03R16_MERGED_KPSDM_00-32_DEG_T.sgy"

[optional] An external identifier - matches service contract field

[optional] Any custom-defined metadata

[optional] Official name of the CRS used. Example: "EPSG:23031"

[optional] Overrides for the source file

[optional] The trace header fields that will be used as keys for indexing

[optional] File data dimensionality, either 2D or 3D

[required] The type of seismic data contained in this file. E.g., pre-stack vs. post-stack

The result of the edit.

[optional] The metadata to replace the existing metadata with.

[optional] The new external id.

[optional] The new CRS for all members of the survey.

[optional] The new custom grid transformation.

[optional] The new custom coverage.

[optional] The new name of the survey.

[required] The geometry of the volume.

[optional] If the geometry describes a line, must be specified.

[optional] The z-ranges to fetch. Defaults to the entire z-range.

[required] The file to queue for ingestion

[required] Target storage tier for this file. A storage tier is a defined facility for storing the trace data associated with a seismic volume. [Accepted values] Accepted values are defined by the tenant configuration, and allow for optimizing tradeoffs between storage cost, retrieval performance, numeric precision and sampling. Note that currently only one storage tier per trace store is supported, so ingesting an already ingested file will result in the file's data being removed from the previously active storage tier.

The time this log was recorded.

The contents of the log.

Specifies a seismic store by id.

Specifies a seismic store by source segy file id.

Specifies a seismic store by job id.

The fetched seismic store.

The job id for this status.

The uuid of the file that this job is associated with.

The status of the job.

When the job was started.

When the job was last updated.

The target storage tier of the job.

Logs recorded by the job.

The id of the file that this job is associated with.

[required] The survey this source file belongs to

[required] Path including protocol, bucket, directory structure, and file name. Example: "gs://cognite-seismic-eu/samples/DN1302M03R16_MERGED_KPSDM_00-32_DEG_T.sgy"

[optional] An external identifier - matches service contract field

[optional] Any custom-defined metadata

[required] Official name of the CRS used. Example: "EPSG:23031"

[optional] Overrides for the source file

[optional] The trace header fields that will be used as keys for indexing

[required] File data dimensionality, either 2D or 3D

[required] The type of seismic data contained in this file. E.g., pre-stack vs. post-stack

Finds files by id, name or external id.

Finds files that are the source of the seismic stores specified by id, name, or external id.

Finds files that are included in the surveys specified by id, name, or external id.

Finds files by their last modified time.

The id of the job.

The uuid of the file that a job is associated with.

The id of the file that a job is associated with.

[optional] If specified, only returns jobs with the given status.

[optional] If specified, only returns jobs with the given target storage tier.

[optional] If specified, only returns jobs that started before the timestamp.

[optional] If specified, only returns jobs that started after the timestamp.

[optional] If specified, only returns jobs that were last updated before the timestamp.

[optional] If specified, only returns jobs that were last updated after the timestamp.

Searches for partitions by id, name, or external id.

Searches for partitions by last modified time.

Will return seismic stores by last modified.

[optional] Whether to include File information in the response. Defaults to false.

Deprecated**: Whether to include inline/crossline volume definitions in the response. Use `include_extent` instead. Defaults to false.

[optional] Whether to include a description of the traces contained in the seismicstore. Defaults to false.

[optional] If specified: - for 2D headers, indicates which trace header the extent should be indexed by, or - for 3D headers, what the major direction should be. Leaving `extent_key` unspecified when `include_extent=true` means the server will choose a key header for each seismicstore. Any seismicstores not indexed by the given header will have its extent field left as null.

[optional] Whether to include text and binary headers in the response. Defaults to false.

Deprecated**. Use `coverage` instead.

[optional] If specified, includes coverage in the specified format and CRS.

Searches for seismics which are included in the specified surveys.

Searches for seismics by their id, name or external id.

Searches for seismics which are included in the specified partitions. Can only search on partitions you can see.

Searches for seismics by their seismic store. Requires ALL scope.

Searches for seismics by last modified

[optional] Whether to include the text header. Defaults to false.

[optional] Whether to include the binary header. Defaults to false.

[optional] Whether to include the line range. Defaults to false.

Deprecated**. Whether to include the volume definition. Use `include_extent` instead. Defaults to false.

[optional] Whether to include the cutout specification the seismic was created with. Defaults to false.

[optional] Whether to include a description of the included traces. Defaults to false.

[optional] If specified, indicates which trace header the extent should be indexed by (if a 2d header), or which should be the major direction (if a 3d header). Leaving this unspecified with `include_extent=true` means the server chooses the native key header for each seismic. Any seismic not indexed by the given header will have its extent field left as null.

[optional] Whether to include info on the backing seismicstore. Requires ALL scope. Defaults to false.

[optional] Whether to include info on the partition. Requires ALL scope. Defaults to false.

Deprecated**. Use `coverage` instead. Defaults to false.

[optional] If specified, includes coverage as the specified CRS and format.

[optional] The list of ids for seismics included in the survey.

[optional] The list of ids for seismic stores included in the survey.

[optional] The coverage of the survey.

[optional] The source of the fetched coverage of the survey.

[optional] Identifier of the survey(s) to fetch. If not specified, retrieves all accessible surveys.

[optional] Whether to list the survey's seismics in the response (default: false)

[optional] Whether to list the survey's seismic stores in the response. Requires ALL scope.

[optional] Whether to include survey metadata in the response (default: false)

Deprecated**. Use `coverage` instead.

[optional] If set, includes coverage in the responses in the specified format and CRS.

[optional] Whether to include the manually specified grid transformation in the response (default: false)

[optional] Whether to include the customer-provided survey coverage in the response.

[optional] If set, requests that a coverage geometry from a particular source is returned in the SearchSurveysResponse. If set, the `coverage` field must also be provided. Note that this is independent from the custom coverage returned as part of the survey. If `coverage_source` is unset but `coverage` is, the coverage geometry will use custom coverage if available and fall back to the calculated coverage otherwise.

[optional] If set, will further filter returned objects by the last modified time.

Specifies a seismic object.

Specifies a seismic store. Requires ALL scope.

Traces will be contained within the polygon.

Deprecated**. Traces will be contained within the rectangle. Only valid if the queried object is 3D.

Traces will be contained within the extent. Only valid if the queried object is 2D.

Traces will be contained within the extent. Only valid if the queried object is 3D

[optional] Skips the first *n* chunks of the download. Useful for resuming aborted downloads. Defaults to 0.

[optional] Select which traces to return within each ensemble. Only valid if the queried object is pre-stack.

Some bytes of the resulting Seg-Y file.

The identifier of the Seismic object to stream traces from

The id of the Seismicstore to stream traces from. Requires ALL scope.

Filters traces by 2D header ranges. Only valid if the queried object is 2D.

Filters traces by 3D header ranges. Only valid if the queried object is 3D.

Filters traces by geometry. If the geometry is a polygon, traces will be contained within the geometry. If the geometry is a line or a linestring, the traces will be interpolated traces onto the line.

[optional] Which depth indices to return as part of the traces. Defaults to the entire depth.

[optional] Whether to include the binary trace header in the streamed traces. Defaults to false.

[optional] Which traces to return within each ensemble. Only valid if the queried object is pre-stack.

The size in bytes of one Trace message

The number of traces to be returned

The number of samples per trace

CRS of the returned trace coordinates

The actual range of z values returned

Three-dimensional bounds for the case when the seismic object is 3D

Two-dimensional bounds for the case when the seismic object is 2D

Null for post-stack data

A range bounding the trace header values of the returned traces, using the trace key specified in the extent (if any), or CDP if no extent was specified

A range bounding the CDP numbers of the returned traces

[required] The file to unregister

The size in bytes of one Trace message

The number of traces to be returned

The number of samples per trace

CRS of the returned trace coordinates

Upper and lower bounds and step sizes in each direction for the returned traces. Null if the result is empty. The iline and xline fields will be null for a line-like geometry.

The unique identifier for a seismic object.

The unique ID for a seismic store. Requires ALL scope.

Retrieves traces by lines.

Retrieves traces within a geometry.

[optional] Whether to include trace headers. Defaults to false.

Deprecated**: This field will always be empty

The x value of the coordinate

The y value of the coordinate

[optional] Which CRS to return the coverage in. Defaults to the native CRS of the object.

[optional] Which format to return the coverage as. Defaults to WKT.

Match on an exact key-value pair. Both the key and the value must exactly match.

Only used for linear geometries in 3D

Identifies an object by internal id.

Identifies an object by external id.

The key to match on.

[optional] All returned objects will have a last_modified before this timestamp.

[optional] All returned objects will have a last_modified after this timestamp.

[optional] The inline range. Defaults to the entire inline range, depending on context.

[optional] The crossline range. Defaults to the entire crossline range, depending on context.

[optional] The depth range. Defaults to the entire depth range, depending on context.

[optional] The inline range. Defaults to the entire inline range, depending on context.

[optional] The crossline range. Defaults to the entire crossline range, depending on context.

The list of metadata filters.

The contents of the map.

The unique internal id for this partition.

The external id of the partition

A short description of this partition

Deprecated**: This field will always be empty. Use seismic search by partition instead.

If specified, the list of ids of seismics that belong to this partition.

The last time this object was created or edited.

Searches by integer id.

Searches surveys and files by string-format uuid. This is not a valid way to search other objects.

Searches seismics and seismic stores by an exact match of external id.

Searches seismics and seismic stores by a substring match of external id.

Searchs any object by an exact match of name.

Searches any object by a substring match of name.

Searches surveys by metadata.

Searches surveys by intersection with geometry.

[optional] Position of the inline number field in the trace headers. Defaults to 189 as per the SEG-Y rev1 specification

[optional] Position of the crossline number field in the trace headers. Defaults to 193 as per the SEG-Y rev1 specification

[optional] Position of the X coordinate of ensemble (CDP) in trace headers. Defaults to 181 as per the SEG-Y rev1 specification

[optional] Position of the Y coordinate of ensemble (CDP) in trace headers. Defaults to 185 as per the SEG-Y rev1 specification

[optional] Position of the ensemble (CDP) number in trace headers. Defaults to 21 as per the SEG-Y rev1 specification

[optional] Position of the energy source point in trace headers. Defaults to 17 as per the SEG-Y rev1 specification

[optional] Position of the shotpoint field in trace headers. Defaults to 197 as per the SEG-Y rev1 specification

[optional] Position of the trace number within ensemble. Defaults to 21 as per the SEG-Y rev1 specification.

[optional] Position of the 'offset' field in the trace header. Defaults to 37 as per the SEG-Y rev1 specification.

[optional] Multiplier for CDP-X and CDP-Y values that overrides the scalar factor obtained from the trace header. Note that this is a floating point multiplier used directly to scale CDP-X and CDP-Y values, and it is not interpreted in the way that the "source group scalar trace header field" in the SEG-Y specification is. In other words, to divide by 100 you must specify 0.01, not -100. Negative values and values greater than 1 are not permitted. To remove the override from a file where an override has previously been set, set the source_group_scalar_override to 0 or NaN. The next ingestion process for that file will then use the source group scalar values found in trace headers.

The unique internal id of the seismic. It is always present.

The external id of the seismic

A non-unique name for the seismic. It is easily editable and is intended to be used as a human-friendly reference.

The Coordinate Reference System of the seismic

Any custom-defined metadata

The text header that corresponds to the seismic

The binary header that corresponds to the seismic

Deprecated**: Use the GetTraceBounds API call instead.

Deprecated**: The VolumeDef describing the seismic. Use extents instead.

The cutout the seismic object was created with.

A description of the traces contained in the seismic.

The id of the partition the seismic belongs to.

The id of the seismicstore the seismic is derived from. It is present only if you have READ access and ALL scope.

The coverage geometry for the seismic.

Deprecated**. Whether this seismic was created empty. Use the `cutout` field instead.

An estimate of the number of traces contained within the seismic.

The trace header fields that have been registered as keys for indexing. This will always match the trace header fields registered for the underlying seismic store.

The underlying file's data dimensionality, either 2D or 3D This will always match the dimensionality for the underlying seismic store.

The last time this object was created or edited.

Whether this seismic object contains pre-stack or post-stack data.

Must be an applicable field for 2D

Range of header values to use

Must be an applicable field for 2D

Whether `inline` or `crossline` is the first coordinate.

Whether `inline` or `crossline` is the second coordinate. Must be different to `major_header`.

The set of included coordinates. The key is `major_header` and values are `minor_header`.

An extent described as a set of rectangles.

An extent described by an enumeration of inline/crossline pairs.

The rectangles that compose the extent.

Indicates that the seismic was created with this 2D extent.

Indicates that the seismic was created with this 3D extent (or an equivalent VolumeDef).

Indicates that the seismic was created with this geometry.

Indicates that the seismic was created empty.

Indicates that the seismic was created to cover the entire seismicstore.

A two dimensional extent.

A three dimensional extent.

The unique internal id of the seismic store

The unique name of the seismic store. This will become non-unique in the future, and `external_id` will be the only unique string-based identifier for seismic stores.

The uuid of the survey this seismic store belongs to.

The integer id of the survey this seismic store belongs to.

The source of the seismicstore. It indicates how the file was ingested

Custom-defined metadata.

Deprecated**. Same as `ingested_source_file`.

If present, the file this SeismicStore was ingested from.

Deprecated**: Volume definition for the store, indexed on inlines. Maps from an inline to all of its valid crosslines. Use extents instead.

Deprecated**: Volume definition for the store, indexed on crosslines. Maps from a crossline to all of its valid inlines. Use extents instead.

Description of the traces contained in the seismicstore.

If present, the text header for this seismic store.

If present, the binary header for this seismic store.

Tenant specific name for the storage facility the trace data are stored in. If empty, it is stored in an unspecified trace store. While support for multiple storage backends per store is planned, this is not currently offered.

If present, the coverage geometry for this seismic store.

The trace header fields that have been registered as keys for indexing.

The underlying file's data dimensionality, either 2D or 3D.

The coordinate reference system used by this seismicstore.

The last time this object was created or edited.

Whether this seismic store contains pre-stack or post-stack data.

The trace header to differentiate between prestack migrated traces in the same bin

A unique string id.

A unique numerical id.

A unique external id.

The name of the file

The cloud storage path including protocol, bucket, directory structure, and file name. Usually in format gs://path/to/file/some_name.sgy

Associated key-value metadata.

Overrides for various Seg-Y options.

The trace header fields that will be used as keys for indexing.

File data dimensionality, either 2D or 3D

The coordinate reference system used by this file

The integer id of the survey this file is contained in

The last time this object was created or edited.

Whether this file contains pre-stack or post-stack data.

The unique uuid for the survey in CDF. The identifier is generated by CDF on creation and not editable.

The unique integer ID for the survey. This ID should be used for V1 survey operations.

Survey name: Should be a short but recognizable name for the survey. Must be unique within a single CDF tenant, and may be used to refer to the survey in API calls.

Metadata describing the survey with named fields and values. @exclude TODO: Augment surveys with a predefined set of fields giving a predictable metadata model and better integration with Discover.

External identifier of the survey. The value of this field must be unique among all the surveys in the CDF tenant. It may be used for correlating with systems outside CDF, and for search and retrieval operations later.

Coordinate reference system to be used by all members of this survey

A manually specified affine transformation between bin grid coordinates and projected crs coordinates, either using an origin point and the azimuth of the xline axis (P6Transformation), or by specifying three or more corners of the grid as a list of DoubleTraceCoordinates. This transformation must be valid for all members of this survey.

A user-provided coverage override

The last time this object was created or edited.

Deprecated**: This field will always be empty

The text content of the header

The raw bytes of a header as a string

Uses the Volume Definition schema

A coordinate reference system specified as a full EPSG code, for example "EPSG:4326".

The CRS of the coordinate. Must be a full EPSG code, for example `EPSG:23031`.

The x value of the coordinate

The y value of the coordinate

[optional] If CRS provided converts coverage to given CRS. Otherwise, will return in the survey's original CRS

[optional] Whether to use WKT format in the response. Defaults to false, returning GeoJSON.

Overrides survey coverage with the provided custom coverage geometry

No custom coverage is provided. Survey coverage will be computed from the seismicstores contained in the survey.

The inline number. Within a 3D survey, a inline represents a seismic line parallel to the direction in which the data was adquired.

The xline number. Within a 3D survey, a xline represents a seismic line perpendicular to the direction in which the data was adquired.

The x value of the coordinate

The y value of the coordinate

[required] The CRS of the geometry.

A wkt format geometry.

A GeoJSON format geometry.

[optional] The first element of the line. Defaults to the minimum value, depending on context.

[optional] The maximum value of a point on the line. Defaults to the maximum value, depending on context.

[optional] The 'step' of the line. Defaults to 1.

The inline number. Within a 3D survey, a inline represents a seismic line parallel to the direction in which the data was adquired.

The xline number. Within a 3D survey, a xline represents a seismic line perpendicular to the direction in which the data was adquired.

A point in the grid

The bin width along the inline axis

The bin width along the crossline axis

Map bearing of the crossline axis in clockwise degrees from north

Inline increment corresponding to a bin

Crossline increment corresponding to a bin

The inline number. Within a 3D survey, a inline represents a seismic line parallel to the direction in which the data was adquired.

The xline number. Within a 3D survey, a xline represents a seismic line perpendicular to the direction in which the data was adquired.

The inline number. Within a 3D survey, a inline represents a seismic line parallel to the direction in which the data was adquired.

The xline number. Within a 3D survey, a xline represents a seismic line perpendicular to the direction in which the data was adquired.

Survey ID

Survey name

Survey external ID

The Coordinate Reference System of the survey

The binary SEGY trace header, if requested.

The inline number. Only populated for 3D seismics.

The xline number. Only populated for 3D seismics.

The cdp number. Only populated for 2D seismics indexed by cdp.

The shotpoint number. Only populated for 2D seismics indexed by shotpoint.

The energy source point number. Only populated for 2D seismics indexed by energy source point.

The cdp trace number. Only populated for prestack-migrated seismics indexed by cdp_trace.

The offset number. Only populated for prestack-migrated seismics indexed by offset.

The underlying array of floats representing samples

The CDP X and Y coordinates of the trace.

DEPRECATED: This field will always be empty

only return traces if closer than this to the actual point in the file

name or id of the file

[optional] If CRS provided converts coverage to given CRS. Otherwise, will return in the file's original CRS

set this to true to return in WKT format. Otherwise, response will be in geojson format by default

name or id of the file

number of the selected inline or crossline in the file

name or id of the file

either time or depth according to the file

name or id of the file

set to true to include the raw header in the response (default: false)

set to true to list the survey files in the response (default: false)

set to true to include metadata in the response (default: false)

set to true to include the grid transformation in the response, if available (default: false)

set to true to include the custom survey coverage in the response, if available (default: false)

name or id of the survey

name or id of the survey

set to true to list the survey files in the response (default: false)

set to true to include metadata in the response (default: false)

set this field to include coverage in the response (default: false)

set to true to include the grid transformation in the response, if available (default: false)

set to true to include the custom survey coverage in the response, if available (default: false)

DEPRECATED: This field will always be empty

[required] Either name or id of a file previously registered with /RegisterFile

If set to true, will delete contents of file (undo the ingestion), but keep the file registered. If set to false, will completely remove the file from database. If no option is set, default is false

[required] Either name or id of a survey previously registered with /RegisterSurvey

[required] Either name or id of a file

[required] Either name or id of a project

If neither add or remove are set, or if both are set to true, add will be assumed Add project access to this file

Remove project access from this file

[required] Either name or id of a file previously registered with /RegisterFile

[optional] New path. Example: "gs://cognite-seismic-eu/samples/"

[optional] New (unique) filename. Example: "DN1302M03R16_MERGED_KPSDM_00-32_DEG_T.sgy"

[optional] New metadata

[optional] Official name of the CRS used. Example: "EPSG:23031"

[optional] Inline number field in the trace headers. Defaults to 189 as per the SEG-Y rev1 specification

[optional] Crossline number field in the trace headers. Defaults to 193 as per the SEG-Y rev1 specification

[optional] X coordinate of ensemble (CDP) position in trace headers. Defaults to 181 as per the SEG-Y rev1 specification

[optional] Y coordinate of ensemble (CDP) position in trace headers. Defaults to 185 as per the SEG-Y rev1 specification

[optional] An external identifier - matches service contract field

[optional] Multiplier for CDP-X and CDP-Y values, overrides scalar factor obtained from trace header. Note that this is a floating point multiplier used directly to scale CDP-X and CDP-Y values, and it is not interpreted in the manner of the source group scalar trace header field in the SEG-Y specification. That is: To divide by 100, specify 0.01, not -100. Negative values and values greater than 1 are not permitted. To remove the override from a file where an override has previously been set, set the source_group_scalar_override to 0 or NaN. The next ingestion processing of a file will then use the source group scalar values found in trace headers.

[optional] Inline number field in the trace headers. Defaults to 189 as per the SEG-Y rev1 specification

[optional] Crossline number field in the trace headers. Defaults to 193 as per the SEG-Y rev1 specification

[optional] X coordinate of ensemble (CDP) position in trace headers. Defaults to 181 as per the SEG-Y rev1 specification

[optional] Y coordinate of ensemble (CDP) position in trace headers. Defaults to 185 as per the SEG-Y rev1 specification

[optional] Multiplier for CDP-X and CDP-Y values, overrides scalar factor obtained from trace header

[required] Either name or id of a survey previously registered with /RegisterSurvey

[optional] New name

[optional] New metadata

[optional] External id matching service contract type

[optional] new CRS used by all members

[optional] Affine transformation from grid bins to coordinates

[optional] Customer-provided custom survey coverage

[required] Either name or id of a file previously registered with /RegisterFile

[optional] Selected step to start ingestion. Leave blank to start from last completed step. [Accepted values] 1 -- insert binary and text headers 2 -- insert trace headers 3 -- insert trace data 4 -- compute coverage polygon and additional metadata (trace count, valid lines, etc) 6 -- insert trace offset indices [Use cases] Usual ingestion: If the last successful step was 0 (REGISTER), the file will be fully ingested regardless of start_step Completing a failed ingestion: If the last successful step was 3 (INSERT_DATA), and no start step is selected, only coverage will be computed. Previously ingested headers and traces will be preserved in this case. Forcing reingestion: If start_step is 1 (INSERT_FILE_HEADERS), regardless of previous ingestion status, all headers and data will be deleted and the whole file will be forcefully reingested Forcing a single step to be rerun: If the file is ingested (last step is COMPUTE_COVERAGE), by using start_step = 4 (COMPUTE_COVERAGE), for example, only coverage will be computed while headers and traces will be preserved

[optional as of 2020-11-01, will be required at some later time] Target storage tier for this file. If empty a bigtable-based storage will be used. A storage tier is a defined facility for storing the trace data associated with a seismic volume. The default storage facility is based on Cloud Bigtable, but it is also possible to leave trace data stored in SEG-Y files in Cloud Storage, only retaining a compact index of file data in fast storage to facilitate retrieval of data from Cloud Storage in a performant manner. [Accepted values] Accepted values are defined by the tenant configuration, and allow for optimizing tradeoffs between storage cost, retrieval performance, numeric precision and sampling. Note that currently only one storage tier per trace store is supported, so ingesting an already ingested file will result in the file's data being removed from the previously active storage tier.

job id that can be used to query for status

[required] Either name or id of a file

[required] Either name or id of a survey previously registered with /RegisterSurvey

[required if file is not synthetic] Path including protocol, bucket and directory structure. Example: "gs://cognite-seismic-eu/samples/"

[required] Unique filename including extension. Example: "DN1302M03R16_MERGED_KPSDM_00-32_DEG_T.sgy". The name must be unique across buckets and can be used to identify this file in query requests

[optional]

[required] Official name of the CRS used. Example: "EPSG:23031"

[optional] tells whether file is temporary (writeable) or not. False by default

[optional] Inline number field in the trace headers. Defaults to 189 as per the SEG-Y rev1 specification

[optional] Crossline number field in the trace headers. Defaults to 193 as per the SEG-Y rev1 specification

[optional] X coordinate of ensemble (CDP) position in trace headers. Defaults to 181 as per the SEG-Y rev1 specification

[optional] Y coordinate of ensemble (CDP) position in trace headers. Defaults to 185 as per the SEG-Y rev1 specification

[optional] An external identifier - matches service contract field

[optional] Multiplier for CDP-X and CDP-Y values, overrides scalar factor obtained from trace header. Must be in the range (0,1]. Note that this is a floating point multiplier used directly to scale CDP-X and CDP-Y values, and it is not interpreted in the manner of the source group scalar trace header field in the SEG-Y specification. That is: To divide by 100, specify 0.01, not -100. Negative values, 0 and values greater than 1 are not permitted when registering a file, although 0 may be used in the EditFile call to unset this field.

[required]

[optional]

[optional]

[optional] new CRS used by all members

[optional] Affine transformation from grid bins to coordinates