POSC Specifications: Epicentre Version 3.0 | Logical Data Model |
This modification merges the surface and mineral (subsurface) concepts for agreements and rights. This is done to accomodate business practices in which subsurface parts of the earth are referenced as if they were surface parts. Extensions included in this change include classification of license rights and license right payments.
CHANGE ESM2_license_and_lease DROP ENTITY mineral_agreement; DROP ENTITY surface_agreement; ADD ENTITY license_agreement (*<desc> A contract between lessor and lessee whereby the lessor grants the lessee the right to explore for, develop and/or produce minerals from the specified surface area(s) or subsurface region(s). The agreement also states the lessee obligation to reimburse the lessor in rentals and/or royalties, and specifies the length of time the lessee has the rights.*) SUBTYPE OF (contract); total_cost : OPTIONAL ndt_money (*<desc> This is the total cost, including bonuses and payments, for all items obtained by lessee from lessor.*); UNIQUE si: identifier; END_ENTITY; ALTER ENTITY ref_mineral_agreement_acq AS ref_license_right_acquisition (*<desc> The reference entity that defines the types of acquisition types for license rights.*) (*<change> Renamed from ref_mineral_agreement_acq to ref_license_right_acquisition as part of the merger of surface and mineral concepts for the license model.*); INVERSE ALTER mineral_agreement AS license_right ALTER TYPE AS license_right ALTER FOR AS ref_license_right_acquisition; END_ENTITY; DROP ENTITY mineral_right; DROP ENTITY surface_right; ALTER ENTITY general_land_right AS license_right DROP ABSTRACT (*<desc><APPEND> This represents the non-spatial concepts of leases, licenses and concessions, and may apply to multiple portions of the Earth. *) (*<change> Renamed from general_land_right to license_right and made non-abstract as part of the merger of surface and subsurface rights into this entity.*); ADD ref_license_right : OPTIONAL ref_license_right (*<desc> This defines the type of license right.*) (*<verb>have type defined by*); ADD ref_license_right_acquisition : OPTIONAL ref_license_right_acquisition (*<desc> The method of acquisition, e.g., purchase, farm-in, etc.*) (*<verb>have acquisition method defined by*); ADD award_date : OPTIONAL ndt_date (*<desc> This is the date the license right was awarded.*); ADD effective_date : OPTIONAL ndt_date (*<desc> This is the date at which this license right becomes effective. This is usually when the license right is defined and may be prior to its initial sale.*); ADD expiry_date : OPTIONAL ndt_date (*<desc> This is the date at which this license right expires. This is usually when the license right is no longer of commercial interest, such as after the final relinquishment.*); ADD application_date : OPTIONAL ndt_date (*<desc> The date on which an application for the license was made.*); ADD rental_due_date : OPTIONAL ndt_date (*<desc> The due date for the rental payment.*); ALTER identifier (*<desc> The identifier assigned to a license right.*); DROP ref_land_right_retention_class; DROP title_agreement; INVERSE ADD lease_association : SET[0:?] OF license_right_lease_assn FOR license_right (*<desc> This defines the portions of the Earth that are included in this license right. Over time and due to business activity, the portions of the Earth included in a license right may change.*) (*<verb>include*); ALTER divestment_package ALTER FOR AS license_right (*<desc> These are the sale packages that include this license right as part of the offering for sale. Typically, this will record the licensing rounds in which this license right was offered.*) (*<verb>be offered in*); ADD license_payment : SET[0:?] OF license_payment FOR license_right (*<desc> This records the payments made by the licensee to the licensor for this license.*) (*<verb>cost*); DROP pty_area; ALTER pty_economic_gor_limit ALTER FOR AS license_right; ALTER pty_economic_limit_money ALTER FOR AS license_right; ALTER pty_economic_oil_cut_limit ALTER FOR AS license_right; ALTER pty_economic_water_cut_limit ALTER FOR AS license_right; ALTER pty_economic_wor_limit ALTER FOR AS license_right; ADD nominal_area : SET[0:?] OF pty_transient_area FOR license_right (*<desc> These are the nominal areas assigned to the license right. These areas are measured on the surface of the Earth. These may change with time as the license right is amended. The first value is considered to be the original license area. The last area is considered to be the current license area.*) (*<verb>have*); ADD license_right_classification : SET[0:?] OF license_right_classification FOR license_right (*<desc> These are the classifications that describe this license right. These classifications describe the status of the right, its retention desirability, how it was acquired, etc.*) (*<verb>be classified by*); UNIQUE ADD si: identifier, ref_license_right; END_ENTITY; DROP ENTITY ref_mineral_right; ALTER ENTITY ref_surface_right AS ref_license_right (*<desc> The reference entity that defines the types of rights associated with license rights.*) (*<change> Renamed from ref_surface_right to ref_license_right as part of the merger of surface and subsurface rights.*); INVERSE ALTER surface_right AS license_right ALTER TYPE AS license_right ALTER FOR AS ref_license_right; END_ENTITY; ADD ENTITY license_right_classification (*<desc> An association classifying a license right. The classification may be for a period of time, and the license right may have several classifications at one time and over its life.*) SUBTYPE OF (transient_association); license_right : license_right (*<desc> This is the license right that is being classified.*) (*<verb>classify*); license_right_class : license_right_class (*<desc> This is the class that is applied to the license right.*) (*<verb>class*); UNIQUE si: license_right, license_right_class, start_time, end_time; END_ENTITY; ADD ENTITY license_right_class (*<desc> This is a class of license right, describing a grouping of license rights based upon a range of common characteristics.*) SUBTYPE OF (classification_class); INVERSE license_right_members : SET [0:?] OF license_right_classification FOR license_right_class (*<desc> These describe the license rights to which this class has been assigned. These instances of license_right_classification identifies this class and the license_rights that they have been applied to.*) (*<verb>classify*); be_a_member_of :SET [0:?] OF license_right_class_clsn FOR have_as_a_member (*<desc> This provides the classes that this license right class is part of. In a hierarchy of classes, these define the parents.*) (*<verb>be a member of*); classify :SET [0:?] OF license_right_class_clsn FOR be_classified_as (*<desc> This provides the other license right classes that this instance is the parent class for. In a hierarchy of classes, these define the children.*) (*<verb>classify*); UNIQUE si: identifier, naming_system; END_ENTITY; ADD ENTITY license_right_class_clsn (*<desc> This defines which child classes are part of which parent classes. When a child class is applied to an instance, the parent classes of that child class are applied as well.*) SUBTYPE OF (class_classification ); be_classified_as : license_right_class (*<desc> This designates the parent class.*) (*<verb>be classfied as*); have_as_a_member : license_right_class (*<desc> This designates the child class.*) (*<verb>have as a member*); UNIQUE si: be_classified_as, have_as_a_member; END_ENTITY; ALTER ENTITY application_for_permit; INVERSE ALTER general_land_right AS license_right (*<desc> This defines the leases and licenses for which this application for permit has been submitted. *); END_ENTITY; ALTER ENTITY application_right_submittal; ALTER general_land_right AS license_right; END_ENTITY; ALTER ENTITY divestment_package; ALTER general_land_right AS license_right (*<desc> These are the license rights that are part of this offering.*); END_ENTITY; ALTER ENTITY divestment_right_inclusion; ALTER general_land_right AS license_right; END_ENTITY; ALTER ENTITY pty_area; DROP general_land_right; UNIQUE ALTER si DROP general_land_right; END_ENTITY; ALTER ENTITY pty_economic_gor_limit; ALTER general_land_right AS license_right; END_ENTITY; ALTER ENTITY pty_economic_limit_money; ALTER general_land_right AS license_right; END_ENTITY; ALTER ENTITY pty_economic_oil_cut_limit; ALTER general_land_right AS license_right; END_ENTITY; ALTER ENTITY pty_economic_water_cut_limit; ALTER general_land_right AS license_right; END_ENTITY; ALTER ENTITY pty_economic_wor_limit; ALTER general_land_right AS license_right; END_ENTITY; ALTER ENTITY title_agreement; DROP general_land_right; END_ENTITY; ADD ENTITY pty_transient_area (*<desc> The amount of surface occupied by an object expressed in units of length squared. This value exists at a point in time.*) SUBTYPE OF (pty_transient_property); data_value : ndt_area (*<desc> A value of area. Examples: 450 acres, 4.567 km2.*); license_right : OPTIONAL license_right (*<desc> This is the license right for which this is the area.*) (*<verb>be a property of*); UNIQUE si: end_time, ref_transient_period, start_time, license_right, activity; END_ENTITY; DROP ENTITY ref_land_right_retention_class; ADD ENTITY license_payment (*<desc> This is a payment made by the licensee to the licensor, usually to satisfy an obligation for a license right.*) SUBTYPE OF (business_object); license_right : license_right (*<desc> This is the license right for which this payment was made.*) (*<verb>be made for*); kind : OPTIONAL ref_license_payment (*<desc> This details the kind of payment made.*) (*<verb>define the type of*); amount : ndt_money (*<desc> This is the amount of the license payment.*); payment_date : OPTIONAL ndt_date (*<desc> This is the actual date upon which the payment was made.*); due_date: OPTIONAL ndt_date (*<desc> This is the due date for this payment.*); UNIQUE si: license_right, kind, payment_date; END_ENTITY; ADD ENTITY ref_license_payment (*<population>OPEN*) (*<desc> This records the types of payments which may be made for a license right.*) SUBTYPE OF (ref_code); INVERSE license_payment : SET[0:?] OF license_payment FOR kind (*<DESC>These are the instances which utilize the semantics of this instance.*) (*<VERB>be referenced by*); UNIQUE si: identifier; END_ENTITY; ADD ENTITY license_right_lease_assn (*<desc> This connects a license right to a portion of the Earth for a period of time. This association means that the portion of the Earth is included as part of the license for the specified time period.*) SUBTYPE OF (transient_association); license_right : license_right (*<desc> This defines the license right which includes the leaseable object.*) (*<verb>describe*); leaseable_earth_feature : leaseable_earth_feature (*<desc> This defines the portion of the Earth being included in the license right.*) (*<verb>include*); UNIQUE si: license_right, leaseable_earth_feature, end_time, start_time; END_ENTITY; ALTER ENTITY leaseable_earth_feature; INVERSE ADD license_right_association : SET [0:?] OF license_right_lease_assn FOR leaseable_earth_feature (*<desc> These define the license rights that have included this leaseable earth object.*) (*<verb>be described by*); END_ENTITY; ALTER ENTITY geopolitical_feature DROP SUBTYPE OF (pfnu); INVERSE ADD offshore_feature : SET [0:?] OF offshore_legal_survey_area FOR country (*<desc> These are the offshore area, blocks, etc. that are within the domain of this country. Note: This inverse only applies to countries.*) (*<verb>have sovereign rights for*); END_ENTITY; -- clean up redundant relationship DROP ENTITY well_surface_feature_role; DROP ENTITY ref_well_surface_feature_role; ALTER ENTITY technical_earth_feature; INVERSE DROP well_surface_feature_role; END_ENTITY; ALTER ENTITY well; INVERSE DROP well_surface_feature_role; END_ENTITY; END_CHANGE;