public abstract class WitsmlTrajectory extends WitsmlObject
The trajectory object is used to capture information about a directional survey in a wellbore. It contains many trajectory stations to capture the information about individual survey points. This object is uniquely identified within the context of one wellbore object.
Trajectories can be instantiated in two different ways in JWitsml client programs:
// Get trajectories of a wellbore from remote server List<WitsmlTrajectory> trajectories = witsmlServer.get(WitsmlTrajectory.class, new WitsmlQuery(), wellbore);
// Create instance WitsmlTrajectory trajectory = witsmlServer.newInstance(WitsmlTrajectory.class, "my trajectory", wellbore); // Set properties and add stations trajectory.setDefinitive(false); trajectory.setMagneticAngle(new Value(19.0, "deg"); trajectory.setMdMax(new Value(2700.0, "m")); : WitsmlTrajectort.Station station1 = trajectory.addStation(); station1.setMd(new Value(2110.0, "m")); station1.setAzimuth(new Value("0.0", "rad")); : // Add to remote server witsmlServer.add(trajectory);
Modifier and Type | Class and Description |
---|---|
static class |
WitsmlTrajectory.AzimuthReference |
static class |
WitsmlTrajectory.GrowingStatus |
static class |
WitsmlTrajectory.Station |
Modifier and Type | Method and Description |
---|---|
abstract WitsmlTrajectory.Station |
addStation() |
Value |
getAzimuthOfVerticalSection()
Return the azimuth of vertical section of this trajectory.
|
WitsmlTrajectory.AzimuthReference |
getAzimuthReference()
Return the azimuth reference of this trajectory.
|
String |
getAzimuthUnit() |
String |
getBuildRateUnit() |
String |
getDipAngleUncertaintyUnit() |
String |
getDlsUnit() |
String |
getDMdUnit() |
String |
getDTvdUnit() |
String |
getEastUnit() |
WitsmlTrajectory.Station |
getFirstStation()
Return the first station of this trajectory.
|
String |
getGravitationFieldReferenceUnit() |
String |
getGravityUncertaintyUnit() |
Value |
getGridConvergence() |
Value |
getGridCorrection()
Return the grid correction of this trajectory.
|
WitsmlTrajectory.GrowingStatus |
getGrowingStatus() |
String |
getInclinationUnit() |
WitsmlTrajectory.Station |
getLastStation()
Return the last station of this trajectory.
|
Value |
getMagneticAngle()
Return the magnetic angle of this trajectory.
|
String |
getMagneticDipAngleReferenceUnit() |
String |
getMagneticFieldReferenceUnit() |
String |
getMagneticUncertaintyUnit() |
Value |
getMdMax()
Return the max MD of this trajectory.
|
Value |
getMdMin()
Return the min MD of this trajectory.
|
String |
getMdUnit() |
String |
getNorthUnit() |
Value |
getOriginEw()
Return the east/west origin of this trajectory.
|
Value |
getOriginNs()
Return the north/south origin of this trajectory.
|
Reference |
getParentTrajectory()
Return the parent trajectory of this trajectory.
|
String |
getServiceCompany()
Return the service company of this trajectory.
|
SortedSet<WitsmlTrajectory.Station> |
getStations()
Return the stations of this trajectory.
|
Date |
getStationsMeasurementEndTime()
Return the stations measurement end time of this trajectory.
|
Date |
getStationsMeasurementStartTime()
Return the stations measurement start time of this trajectory.
|
String |
getToolfaceGravityAngleUnit() |
String |
getToolfaceMagneticAngleUnit() |
String |
getTurnRateUnit() |
String |
getTvdUnit() |
String |
getVerticalSectionDistanceUnit() |
Boolean |
isDefinitive()
Return if this trajectory is definitive.
|
Boolean |
isFinal()
Return if this trajectory is final.
|
Boolean |
isGrowing()
Return if this trajectory is growing.
|
Boolean |
isMemoryDump()
Return if this trajectory is memory dump.
|
void |
setAzimuthOfVerticalSection(Value azimuthOfVerticalSection)
Set the azimuth of vertical section of this trajectory.
|
void |
setAzimuthReference(WitsmlTrajectory.AzimuthReference azimuthReference)
Set the azimuth reference of this trajectory.
|
void |
setDefinitive(Boolean isDefinitive)
Set if this trajectory is definitive.
|
void |
setFinal(Boolean isFinal)
Set if this trajectory is final.
|
void |
setGridConvergence(Value gridConvergence) |
void |
setGridCorrection(Value gridCorrection)
Set the grid correction of this trajectory.
|
void |
setGrowing(Boolean isGrowing)
Set if this trajectory is growing.
|
void |
setGrowingStatus(WitsmlTrajectory.GrowingStatus growingStatus) |
void |
setMagneticAngle(Value magneticAngle)
Set the magnetic angle of this trajectory.
|
void |
setMdMax(Value mdMax)
Set the max MD of this trajectory.
|
void |
setMdMin(Value mdMin)
Set the min MD of this trajectory.
|
void |
setMemoryDump(Boolean isMemoryDump)
Set if this trajectory is memory dump.
|
void |
setOriginEw(Value originEw)
Set the east/west origin of this trajectory.
|
void |
setOriginNs(Value originNs)
Set the north/south origin of this trajectory.
|
void |
setParentTrajectory(Reference parentTrajectory)
Set the parent trajectory of this trajectory.
|
void |
setServiceCompany(String serviceCompany)
Set the service company of this trajectory.
|
void |
setStationsMeasurementEndTime(Date stationsMeasurementEndTime)
Set the stations measurement end time of this trajectory.
|
void |
setStationsMeasurementStartTime(Date stationsMeasurementStartTime)
Set the stations measurement start time of this trajectory.
|
equals, getAddQuery, getAliases, getCitation, getCommonData, getEtpResource, getEtpServer, getId, getName, getParent, getParentId, getReadLock, getServer, getVersion, getWitsmlServer, getWitsmlType, getWriteLock, hashCode, newAliases, newCitation, newCommonData, setEtpResource, setName, toString
public Boolean isGrowing()
Corresponds to the WITSML property objectGrowing, 1.3+
:
Whether or not the trajectory is growing. True indicates the that the trajectory is still growing in size (that is, trajectoryStation values are still being added). For example, it may be connected to a realtime stream. False indicates that the trajectory is closed (that is, no further trajectoryStation values will be added). Not given indicates that the status of the trajectory is not known. This value is only relevant within the context of a server.
public void setGrowing(Boolean isGrowing)
Corresponds to the WITSML property objectGrowing, 1.3+
:
Whether or not the trajectory is growing. True indicates the that the trajectory is still growing in size (that is, trajectoryStation values are still being added). For example, it may be connected to a realtime stream. False indicates that the trajectory is closed (that is, no further trajectoryStation values will be added). Not given indicates that the status of the trajectory is not known. This value is only relevant within the context of a server.
isGrowing
- The is growing to set.
May be null indicating absent or unknown.public WitsmlTrajectory.GrowingStatus getGrowingStatus()
public void setGrowingStatus(WitsmlTrajectory.GrowingStatus growingStatus)
public Reference getParentTrajectory()
Corresponds to the WITSML property parentTrajectory
:
If a trajectory is tied into another trajectory, a pointer to the parent trajectory. The trajectory may be in another wellbore.
public void setParentTrajectory(Reference parentTrajectory)
Corresponds to the WITSML property parentTrajectory
:
If a trajectory is tied into another trajectory, a pointer to the parent trajectory. The trajectory may be in another wellbore.
parentTrajectory
- The parent trajectory to set.
May be null indicating absent or unknown.public Date getStationsMeasurementStartTime()
Corresponds to the WITSML property dTimTrajStart
:
Start date and time of trajectory station measurements. Note that this is NOT a server query parameter.
public void setStationsMeasurementStartTime(Date stationsMeasurementStartTime)
Corresponds to the WITSML property dTimTrajStart
:
Start date and time of trajectory station measurements. Note that this is NOT a server query parameter.
stationsMeasurementStartTime
- The stations measurement start time to set.
May be null indicating absent or unknown.public Date getStationsMeasurementEndTime()
Corresponds to the WITSML property dTimTrajEnd
:
End date and time of trajectory station measurements. Note that this is NOT a server query parameter.
public void setStationsMeasurementEndTime(Date stationsMeasurementEndTime)
Corresponds to the WITSML property dTimTrajEnd
:
End date and time of trajectory station measurements. Note that this is NOT a server query parameter.
stationsMeasurementEndTime
- The stations measurement end time to set.
May be null indicating absent or unknown.public Value getMdMin()
Corresponds to the WITSML property mdMn
:
Minimum measured depth of trajectory. This is a query parameter. It's value will be populated by the server to reflect the values of md in the returned trajectoryStations.
public void setMdMin(Value mdMin)
Corresponds to the WITSML property mdMn
:
Minimum measured depth of trajectory. This is a query parameter. It's value will be populated by the server to reflect the values of md in the returned trajectoryStations.
mdMin
- The min MD to set.
May be null indicating absent or unknown.public Value getMdMax()
Corresponds to the WITSML property mdMx
:
Maximum measured depth of trajectory. This is a query parameter. It's value will be populated by the server to reflect the values of md in the returned trajectoryStations.
public void setMdMax(Value mdMax)
Corresponds to the WITSML property mdMx
:
Maximum measured depth of trajectory. This is a query parameter. It's value will be populated by the server to reflect the values of md in the returned trajectoryStations.
mdMax
- The max MD to set.
May be null indicating absent or unknown.public String getServiceCompany()
Corresponds to the WITSML property serviceCompany
:
Name of contractor who provided the service.
public void setServiceCompany(String serviceCompany)
Corresponds to the WITSML property serviceCompany
:
Name of contractor who provided the service.
serviceCompany
- The service company to set.
May be null indicating absent or unknown.public Value getMagneticAngle()
Corresponds to the WITSML property magDeclUsed
:
Magnetic declination used to correct a magnetic survey. Starting value if stations have individual values.
public void setMagneticAngle(Value magneticAngle)
Corresponds to the WITSML property magDeclUsed
:
Magnetic declination used to correct a magnetic survey. Starting value if stations have individual values.
magneticAngle
- The magnetic angle to set.
May be null indicating absent or unknown.public Value getGridCorrection()
Corresponds to the WITSML property gridCorUsed
:
Grid correction used to correct a survey. Starting value if stations have individual values.
public void setGridCorrection(Value gridCorrection)
Corresponds to the WITSML property gridCorUsed
:
Grid correction used to correct a survey. Starting value if stations have individual values.
gridCorrection
- The grid correction to set.
May be null indicating absent or unknown.public Value getGridConvergence()
public void setGridConvergence(Value gridConvergence)
public Value getAzimuthOfVerticalSection()
Corresponds to the WITSML property aziVertSect
:
Azimuth used for vertical section plot/computations.
public void setAzimuthOfVerticalSection(Value azimuthOfVerticalSection)
Corresponds to the WITSML property aziVertSect
:
Azimuth used for vertical section plot/computations.
azimuthOfVerticalSection
- The azimuth of vertical section to set.
May be null indicating absent or unknown.public Value getOriginNs()
Corresponds to the WITSML property dispNsVertSectOrig
:
Origin north-south used for vertical section plot/computations.
public void setOriginNs(Value originNs)
Corresponds to the WITSML property dispNsVertSectOrig
:
Origin north-south used for vertical section plot/computations.
originNs
- The north/south origin to set.
May be null indicating absent or unknown.public Value getOriginEw()
Corresponds to the WITSML property dispEwVertSectOrig
:
Origin east-west used for vertical section plot/computations.
public void setOriginEw(Value originEw)
Corresponds to the WITSML property dispEwVertSectOrig
:
Origin east-west used for vertical section plot/computations.
originEw
- The east/west origin to set.
May be null indicating absent or unknown.public Boolean isDefinitive()
Corresponds to the WITSML property definitive
:
True indicates that this trajectory is definitive for this wellbore. False or not given indicates otherwise. There can only be one trajectory per wellbore with definitive=true and it must define the geometry of the whole wellbore (surface to bottom). The definitive trajectory may represent a composite of information in many other trajectories. A query requesting a subset of the possible information can provide a simplistic view of the geometry of the wellbore.
public void setDefinitive(Boolean isDefinitive)
Corresponds to the WITSML property definitive
:
True indicates that this trajectory is definitive for this wellbore. False or not given indicates otherwise. There can only be one trajectory per wellbore with definitive=true and it must define the geometry of the whole wellbore (surface to bottom). The definitive trajectory may represent a composite of information in many other trajectories. A query requesting a subset of the possible information can provide a simplistic view of the geometry of the wellbore.
isDefinitive
- The is definitive to set.
May be null indicating absent or unknown.public Boolean isMemoryDump()
Corresponds to the WITSML property memory
:
Is trajectory a result of a memory dump from a tool?
public void setMemoryDump(Boolean isMemoryDump)
Corresponds to the WITSML property memory
:
Is trajectory a result of a memory dump from a tool?
isMemoryDump
- The is memory dump to set.
May be null indicating absent or unknown.public Boolean isFinal()
Corresponds to the WITSML property finalTraj
:
Is trajectory a final or intermediate/preliminary?
public void setFinal(Boolean isFinal)
Corresponds to the WITSML property finalTraj
:
Is trajectory a final or intermediate/preliminary?
isFinal
- The is final to set.
May be null indicating absent or unknown.public WitsmlTrajectory.AzimuthReference getAzimuthReference()
Corresponds to the WITSML property aziRef
:
Specifies the definition of north. While this is optional because of legacy data, it is strongly recommended that this always be specified.
public void setAzimuthReference(WitsmlTrajectory.AzimuthReference azimuthReference)
Corresponds to the WITSML property aziRef
:
Specifies the definition of north. While this is optional because of legacy data, it is strongly recommended that this always be specified.
azimuthReference
- The azimuth reference to set.
May be null indicating absent or unknown.public SortedSet<WitsmlTrajectory.Station> getStations()
Corresponds to the WITSML property trajectoryStation
:
Container element for trajectory station elements.
public abstract WitsmlTrajectory.Station addStation()
public WitsmlTrajectory.Station getFirstStation()
public WitsmlTrajectory.Station getLastStation()
public String getMdUnit()
public String getTvdUnit()
public String getInclinationUnit()
public String getAzimuthUnit()
public String getToolfaceMagneticAngleUnit()
public String getToolfaceGravityAngleUnit()
public String getNorthUnit()
public String getEastUnit()
public String getVerticalSectionDistanceUnit()
public String getDlsUnit()
public String getTurnRateUnit()
public String getBuildRateUnit()
public String getDMdUnit()
public String getDTvdUnit()
public String getGravityUncertaintyUnit()
public String getDipAngleUncertaintyUnit()
public String getMagneticUncertaintyUnit()
public String getGravitationFieldReferenceUnit()
public String getMagneticFieldReferenceUnit()
public String getMagneticDipAngleReferenceUnit()
Copyright © 2023 Petroware AS - https://petroware.no