ConvertTrajectoryRequest

Cloud APIs

Input trajectory data structure; contains the context (crs, units, azimuth reference, method). The 3D reference point 'referencePoint' must be given in the 'trajectoryCRS' where MD = 0. The z-value is expected to be an elevation above MSL (upwards positive).

trajectoryCRSstringrequired

Coordinate reference system for the reference point; typically the CRS is a projected CRS; if a geographic CRS is provided, the unitXY must be defined and the azimuthReference must be TrueNorth.

Example:"{\"lateBoundCRS\":{\"wkt\":\"PROJCS[\\\"Trinidad_1903_Trinidad_Grid\\\",GEOGCS[\\\"GCS_Trinidad_1903\\\",DATUM[\\\"D_Trinidad_1903\\\",SPHEROID[\\\"C

azimuthReferencestringrequired

Azimuth reference for the input trajectory station azimuth values (TrueNorth or GridNorth)

Example:"TrueNorth"

unitXYstring

The horizontal unit of the dx, dy in the input trajectory stations; the unit must be a length unit in 'persistable reference' format, see example.

Example:"{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}"

unitZstringrequired

The vertical unit of the dz in the input trajectory stations; the unit must be a length unit in 'persistable reference' format, see example.

Example:"{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}"

referencePointobject(Point)required

Point representation for CRS operations.

Example:

{
  "x": 400000,
  "y": 6500000,
  "z": 0
}

inputStationsArray of objects(TrajectoryStationIn)required

The array of input trajectory stations

Example:

[
  {
    "md": 0,
    "inclination": 0,
    "azimuth": 0
  },
  {
    "md": 1000,
    "inclination": 0,
    "azimuth": 0
  },
  {
    "md": 2000,
    "inclination": 90,
    "azimuth": 0
  },
  {
    "md": 3000,
    "inclination": 90,
    "azimuth": 0
  },
  {
    "md": 5000,
    "inclination": 90,
    "azimuth": 90
  },
  {
    "md": 6000,
    "inclination": 90,
    "azimuth": 90
  }
]

methodstringrequired

The computation method - 'AzimuthalEquidistant' (default) or 'LMP' (Lee's modified proposal SPE96813)

Example:"AzimuthalEquidistant"

inputKindstring

The kind of input; e.g. MD_Incl_Azim (default). Future options will be MD_X_Y_Z, MD_dX_dY_dZ, X_Y_Z, dX_dY_dZ. MD stands for measured depth; MD_X_Y_Z/X_Y_Z stand for absolute coordinates in the reference CRS, MD_dX_dY_dZ/dX_dY_dZ stand for deviations relative to the reference point.

Default:"MD_Incl_Azim"

Example:"MD_Incl_Azim"

interpolateboolean

Perform trajectory interpolation on demand; default is true.

Example:true

{
  "trajectoryCRS": "{\"wkt\":\"PROJCS[\\\"WGS_1984_UTM_Zone_31N\\\",GEOGCS[\\\"GCS_WGS_1984\\\",DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",0.0174532925199433]],PROJECTION[\\\"Transverse_Mercator\\\"],PARAMETER[\\\"False_Easting\\\",500000.0],PARAMETER[\\\"False_Northing\\\",0.0],PARAMETER[\\\"Central_Meridian\\\",3.0],PARAMETER[\\\"Scale_Factor\\\",0.9996],PARAMETER[\\\"Latitude_Of_Origin\\\",0.0],UNIT[\\\"Meter\\\",1.0],AUTHORITY[\\\"EPSG\\\",32631]]\",\"ver\":\"PE_10_3_1\",\"name\":\"WGS_1984_UTM_Zone_31N\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"32631\"},\"type\":\"LBC\"}",
  "azimuthReference": "TN",
  "unitXY": "{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}",
  "unitZ": "{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}",
  "referencePoint": {
    "x": 400000,
    "y": 6500000,
    "z": 0
  },
  "inputKind": "MD_Incl_Azim",
  "interpolate": true,
  "inputStations": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ],
  "method": "AzimuthalEquidistant"
}