Configuring your environment
One JSON file - the environment - adapts the views to a customer, country or asset: units, engineering criteria, standards references, names, colours, print settings and your own lexicons, code lists and data mappings.
Step by step
- Start from the template (every setting with its default) or a sample.
- Keep only the settings you change; everything else keeps its default.
- Write measurements with their unit:
{ "value": 5, "unit": "m" }. - Open the file in an editor that understands the JSON Schema to get completion and error highlighting.
- Give the file to the application (your administrator configures where it is loaded). Mistyped keys and invalid values are reported, not silently ignored.
The two examples below are regional: they show how practice in Kuwait and on the Norwegian continental shelf looks in a file. Every country has a preset (see
countries) - start from yours with "extends": "country:XX" and override only what differs.
Example: a Kuwait profile
{
// Kuwait (sample) - feet, Arabic display names for formations, PPDM-style source codes
"name": "Kuwait (sample)",
"culture": "ar-KW",
"units": { "depthUnit": "ft", "pressureUnit": "psi" },
"printing": { "paper": "A3", "headerFields": { "Country": "Kuwait" } },
"resources": {
"vocabularyFiles": [ "ppdm-codes.vocabulary.sample.json" ],
"lexiconFiles": [ "kuwait.lexicon.sample.json" ],
"mappingProfilesFolder": "profiles"
}
}
Example: a Norwegian Continental Shelf profile
{
// Norwegian Continental Shelf (sample) - only the keys that differ from the defaults
"name": "NCS (sample)",
"culture": "nb-NO",
"units": { "depthUnit": "m", "diameterUnit": "in", "pressureUnit": "bar" },
"conversion": { "depthMode": "True" },
"barriers": { "acceptanceReferences": { "CASING": "NORSOK D-010 Rev 5 (verify table)" } },
"resources": { "lexiconFiles": [ "ncs.lexicon.sample.json" ], "labelFiles": [ "labels.company.sample.json" ] }
}
What you should review for your company
| Area | Settings | Why |
|---|---|---|
| Units | units.* |
depth unit, pressure, diameter and weight display units |
| Barrier criteria | barriers.* |
required barriers per leak path, impaired rule, acceptance-criteria references (your standard and revision) |
| MAASP screening | annuli.* |
burst and collapse deratings used for screening |
| Cement | cement.* |
CBL calibration, bond-index cutoffs, required isolation length, logged coverage |
| Pressure | pressure.* |
fluid-typing gradients, zoning rules, fit quality |
| Mud gas | gasRatios.* |
Haworth bands and show threshold |
| Names | resources.lexiconFiles, culture |
layer names used by your company / country and the display language |
| Codes | resources.vocabularyFiles |
your data model's codes (packer types, string kinds, statuses...) |
A company file and country or asset files
Keep company-wide settings in one file and let each country or asset file extend it with only what differs:
{ "extends": "../company/company.environment.json", "units": { "depthUnit": "m" } }
A country file wins over the company file; colour lists merge (change one colour, keep the others). Your administrator can ask the software where any value came from.
Screen themes
Set theme.preset to dark, print or highContrast (default light). The software warns when text would be hard to read.
Checking your files before use
wellbore-config validate <your file> checks the environment, the files it extends, your lexicons, code lists, labels and
data mappings, and explains every problem (see the WR messages under Validation messages).
Starting from your country
Ready-made environments exist for 62 countries (see Countries), one complete file each: units by typical
national practice, the tubular catalogue (API 5CT / ISO 11960, or GOST in Russia and the CIS, with Russian log mnemonics such
as ГК, ПС, КС, ДС grouped into the right tracks), paper size, the code page of older files, and the country's regulators for
reference. Start from one and change only what differs
for your company; wellbore-config show tells you where every value came from.
{ "extends": "country:NO", "units": { "pressureUnit": "psi" } }
A unit system alone also works: "units": { "system": "metric-mpa" } (oilfield, metric-kpa, metric-bar, metric-mpa); any
unit set explicitly wins.
Your own units, unit systems, paper sizes and countries
Nothing is fixed in the libraries: add or change units (units.definitions, for example the US survey foot or kgf/mm2), unit
systems (units.systems), paper sizes (printing.papers), and countries - a folder of your own country files
(resources.countryFolders) is searched before the built-in ones, and a file there may build on the built-in country.
{
"resources": { "countryFolders": [ "countries" ] },
"units": { "definitions": { "kgf/mm2": { "dimension": "Pressure", "factor": 9806650 } } },
"printing": { "papers": { "B4": { "width": 708.66, "height": 1000.63 } } }
}
Your own equipment, barrier and contact types
The lists of equipment (component) types, well barrier element types and fluid contact types are configuration too. Add your
own or change a built-in one in a file listed under resources.modelCatalogFiles; entries with the same code replace the
built-in ones, new codes are added.
{ "componentTypes": [ { "code": "DOWNHOLE_FLOWMETER", "category": "Monitoring", "name": "Downhole flowmeter" } ],
"contactTypes": [ { "code": "HCWC", "name": "Hydrocarbon-water contact", "color": "#224488", "rank": 2, "limit": 0 } ] }
Your own symbols in checks and templates
Barrier templates, annulus detection, P&A checks, validation and the schematic layout recognise items by role - tubing,
production casing, packer, safety valve, wellhead, tubing head, tree, BOP, cement plug, plug foundation, control line, open
hole and others. Each role lists component types, symbols, symbol prefixes and exclusions (schematic.roles). When you
use your own symbols, add them to the role they play; a role you set replaces the built-in definition of that role.
{ "schematic": { "roles": { "tubing": { "symbols": [ "str_tubing", "acme_tubing" ] } } } }
Host slots are configured the same way: schematic.hostRadii (where a slot sits) and schematic.hostFamilies (how it is
drawn: tubing, linerInCasing, liner or casing).
Your own leak-path networks
The leak-path diagrams are built from networks defined in JSON: cavities (reservoir, tubing, annuli, surroundings...),
fixed edges, and links - "every barrier element of this type (in this envelope) joins these two cavities". Add networks or
replace a built-in one by name in a file listed under resources.leakPathFiles, with selection rules that choose it by
words in the barrier set's phase or well type (your rules are checked first).
{ "networks": { "gasStorage": { "cavities": [ { "id": "R", "label": "Storage", "kind": "Source" }, { "id": "E", "label": "Surroundings", "kind": "Sink" } ],
"links": [ { "type": "CASING", "a": "R", "b": "E" } ] } },
"selection": [ { "contains": [ "storage" ], "network": "gasStorage" } ] }
Your own barrier templates
The typical barrier sets (production, injection, drilling, workover, permanent abandonment) are templates in JSON. A template
names the items it works with by symbol role, which of them are required, and the elements of each envelope - with depths
as expressions over named points (casing.toc, casing.cementBottom, packer.top, dhsv.top, plug.base, doc.bottom,
max(a, b), min(a, b)) and conditions (liner, casing.cemented, casing.toc < packer.top, joined with and). Change
a built-in template or add your own by name in a file listed under resources.barrierTemplateFiles; for example, a
production standard that does not require a downhole safety valve:
{ "templates": { "production": {
"phase": "Production", "wellType": "Producer (company standard)",
"bind": { "casing": { "role": "productionCasing", "kind": "string" }, "tree": { "role": "tree" } },
"require": [ "casing" ],
"envelopes": { "Primary": [ { "type": "CASING", "target": "casing", "top": "casing.top", "bottom": "casing.bottom" } ],
"Secondary": [ { "type": "PRODUCTION_TREE", "target": "tree", "when": "tree" } ] } } } }
A misspelt point stops the template with a message naming it.
Saving the whole configuration
wellbore-config save environment.json folder (or WellboreServices.SaveConfiguration(folder) in code) writes the complete
configuration - the environment and every part it uses: vocabulary, lexicon and label layers in their order, component
symbols, equipment / barrier / contact types, leak-path networks, barrier templates, your own countries, units, and copies of
the lithology and symbol-catalogue files - as JSON files referenced by relative paths. Load folder/environment.json to get
the same configuration anywhere; the folder can be moved, zipped or put under version control. Parts a program supplied in
code rather than as JSON are listed as skipped.
North reference and coordinate systems
Each well records the north its survey azimuths refer to (surveyNorth: Magnetic, True or Grid), the magnetic declination
and the grid convergence (well columns survey_north, magnetic_declination, grid_convergence; WITSML aziRef,
magDeclUsed, gridCorUsed). Trajectories, maps and sections work in one north (survey.workingNorth, Grid by default):
magnetic to true adds the declination, true to grid subtracts the convergence (survey.gridConvergencePositiveEast sets the
sign convention). A correction that needs a missing value is reported, never guessed; a well without north information is
treated as grid, as before. Maps and sections warn when wells use different coordinate systems (WV060) or when only some
declare one (WV061). Each country file lists the coordinate systems commonly used there.
Well identifier formats
Country files carry the national well identifier format where one exists - US API numbers (42-501-20130-03-00), Canadian
UWIs (DLS 100/06-12-045-12W5/00 and NTS 200/A-001-B/094-G-01/00), Norwegian wellbore names (15/9-F-12) and UK well
names (211/29-A12). When a well is loaded, its UWI (and, for Norway and the UK, its name) must match one of them;
otherwise the load reports WI001 with the expected formats. Set your own list in region.wellIdentifiers (name, regular
expression, example, fields) - it replaces the country's.
Abandonment rule sets
The P&A checks and the permanent-abandonment barrier set apply a named rule set (abandonment.ruleSet); the checklist and
every message name it. Built in, each with the source of every value in its notes:
| Rule set | Plug (no foundation) | On bridge plug / retainer | Environmental plug | Environmental plug top |
|---|---|---|---|---|
| default - NORSOK D-010 | 100 m | 50 m | 50 m | 50 m below the depth zero |
US-BSEE - 30 CFR 250.1715 |
200 ft | 50 ft of cement on top | 150 ft | 150 ft below the mudline |
UK-OEUK - OEUK Well Decommissioning Guidelines |
100 ft MD | 100 ft MD | 100 ft | 100 ft below the mudline (a check value: OEUK sets no fixed depth) |
RU - Rostekhnadzor order No. 534 |
50 m | 50 m | 50 m | at the sea bed / surface |
The US, UK and Russia / CIS country files select their rule set. Depths "below the mudline / surface" use the schematic's
surface depth (from the datum and ground / seabed elevations, datum codes GL, SB, ML); when it is unknown the check says so
(WP009). Add your own rule set under abandonment.ruleSets; a value you leave empty is reported (WP008) and the checks that
need it are skipped, never filled with another rule set's numbers. Always confirm the values against the current edition
and your regulator's requirements for the well.
Checking a configuration: verify
wellbore-config verify environment.json runs two kinds of check and exits 0 (clean), 1 (warnings) or 2 (errors or a failed
case) for use in CI:
- Reference cases (
verification.cases): calculations with known answers - unit conversions, a straight inclined hole and a quarter-circle build (exact minimum-curvature results), magnetic-to-grid azimuth, the image-log sinusoid of a 45 deg dip. Each case reports PASS / FAIL with the deviation. A wrong unit definition, for example, fails the conversion cases. Add your own, for example ISCWSA test-well uncertainties (kinduncertainty, expected 1-sigma values). - Cross-checks of every configured part (codes CV...): leak-path links to unknown cavities, selection rules naming
unknown networks, invalid identifier patterns, rule sets with empty values, duplicate catalog codes, roles naming unknown
component types or symbols, and barrier templates - unknown bindings, roles, envelopes, element types and every depth point
or condition (for example
casing.tocc).
Survey tool error models
Position uncertainty uses a survey tool error model (survey.toolModel, default MWD+SRGM, the OWSG standard MWD model A001Mc).
Built in: the ISCWSA MWD Rev 5 model (35 terms, reproducing the ISCWSA example spreadsheets for test wells 1 and 2 at every
station) and 53 models of the OWSG Tool Group A (Rev 5.1): MWD with standard, high-definition or in-field referencing, axial
correction (AX), sag, multi-station, EMS, gyro (stationary), dipmeter, film, inclination-only, blind and unknown tools.
MWD+SRGM reproduces Copsegrove's ISCWSA diagnostics for test wells 1 to 3; every OWSG weighting function agrees with welleng, an
independent implementation, except where the official formulas are followed and welleng differs (ABIZ, the vertical-station forms
of CNA / XYM3 / XYM4, and XCLA, where welleng and Copsegrove use the sine of the azimuth change). Models warn when the survey
leaves their inclination range or, for axial correction, enters the horizontal east / west exclusion zone. Gyro models switch
between stationary and continuous surveying at staticGyroEndInclination (negative: continuous from surface): terms can be limited
to an inclination zone (incMin, incMax), carry a stationary initialisation error into continuous surveying (carryAboveMax)
or be an initialisation seed (carryOnly); continuous drift and random walk accumulate with the running speed and restart when
the well drops back below the switch and is re-initialised (SPE 90408 Appendix C). The six SPE 90408 example models reproduce the
paper's Appendix E on ISCWSA wells 1 and 3 (Model #4 on well 3 from 3000 m excepted: the published values there are
inconsistent). Built in: GYRO-NS-CT and the CB_Film GMS / GSS continuous models.
A term can also be given by formulas instead of a built-in function (depthFormula, inclinationFormula, azimuthFormula and the
northSingularity / eastSingularity / verticalSingularity forms for vertical stations), written as the ISCWSA and OWSG models
write them - for example Sin(AzT) / (EarthRate * Cos(Latitude) * Cos(Inc)) - with the variables MD, MDPrev, Inc, IncPrev, AzT,
AzTPrev, AzM, Az, TVD, Dip, Gfield, BField, Latitude, EarthRate, NoiseReductionFactor, XCLTortuosity, RAD, pi and the model's own
parameters. ToolErrorModel.FromIscwsaJson reads the ISCWSA error-model JSON format. An unknown name or a syntax error is
reported and the term left out.
A well surveyed with several tools has a survey program: legs from a start depth, each with its tool model (WellModel.SurveyProgram),
or the tool of each survey station (CSV column survey_tool, WITSML trajectoryStation/modelToolError) from which the legs are
derived. Random errors are independent at every station, systematic errors are correlated within a leg and independent between
legs, and well-by-well and global errors are correlated across all legs (SPE 67616). A tool that is not one of
survey.toolModels is reported (WV064) and replaced by survey.toolModel. Add your own models under survey.toolModels: each term has a code, a weighting function (DREF, DSF, DST, ABXY-TI1,
ABXY-TI2, ABZ, ASXY-TI1..3, ASZ, MBXY-TI1..2, MBZ, MSXY-TI1..3, MSZ, AZ, DBH, AMIL, SAGE, XYM1..2, XYM3L, XYM4L, XCLH, XCLA),
a magnitude with its unit (m, -, 1/m, m/s2, nT, deg, deg.nT) and a propagation (random, systematic, global). The sensor terms
need the well's magnetic field (total field and dip) and declination: taken from the well header (magneticTotalField,
magneticDip, magneticDeclination, gravity) when given, otherwise computed at the well's location and survey date with the
World Magnetic Model 2025 (embedded; resources.geomagneticModelFile loads another model in NOAA .COF format) and WGS84 normal
gravity. Without a location the simple error model is used; the view's validation says so (WV062), and when no survey date is
given the field is computed for today (WV063).
Coverage: what your data holds that the environment does not resolve
wellbore-config coverage <environment.json> <source> [--worksheet file] loads the wells of a configured data source and lists every
value that does not resolve, by area, with how often it occurs, a well holding it and the setting that fixes it: codes that are not
string kinds or statuses (fix: dataSources.<source>.codes), component types that are not in the model catalog or have no
schematic symbol (codes, resources.modelCatalogFiles, resources.componentSymbolsFile), contact types, formation tops not in any
stratigraphic lexicon (resources.lexiconFiles), lithologies not in the lithology library (resources.lithologyFile), unknown units
(units.aliases) and, for LAS / DLIS / WITSML sources, curve mnemonics that match no curve rule (logs.mnemonicAliases).
--worksheet writes the unresolved codes as a codes skeleton to fill in and to-do lists for the rest - a working file, not
configuration. The command exits with 1 while anything is unresolved, so a CI step can require full coverage. From code:
DataCoverage.Analyse(source) (and MappedWellDataProvider.ObserveAsync for the raw and resolved values of one well).
Standard stratigraphy and your own
Formation tops resolve through stratigraphic lexicons in layers: your lexicon files first (resources.lexiconFiles - your formations,
groups and members with their aliases and local names), then the published standards in resources.standardLexicons - built in: ICS,
the International Chronostratigraphic Chart v2020/01 (178 units from eons to ages, with ranks, hierarchy, boundary ages in Ma, the
official CGMW colours and names in 20 languages; "Upper Jurassic" and "Late Jurassic" both resolve). Your names always win. A unit can
name its rank, its parent (a company formation can sit in a chart stage: "parent": "Albian") and its base and top ages. Tops show on schematics and log
views alike, named and coloured by their unit (styles.topMarkerColor for tops outside the lexicons); with
display.chronostratigraphyRank set (Period, Epoch, Age ...) the views add chronostratigraphy zones - each top's chart unit of that
rank, with its colour and age range. Set
"standardLexicons": [] to use only your own; to use a newer ICS edition, rebuild the layer with tools/standards/build_ics_lexicon.py
or add it as one of your lexicon files.
Toolboxes
Toolboxes are libraries on top of the core, each its own package: Integrity (wall loss, corroded-pipe re-rating, sustained casing
pressure, integrity status), Drilling (well planning, torque and drag, hydraulics, performance), Production (decline curves,
inflow and nodal analysis, pressure tests), DataAI (legacy document extraction, well identity reconciliation, OSDU ingestion) and
Training (scenario exercises on the views). Each keeps its settings in the same environment file, under toolboxes:
"toolboxes": { "integrity": { ... }, "drilling": { ... } }
They merge through extends and presets like every other section, are validated with the rest (messages start toolboxes.<name>:),
and appear in the template and schema with their defaults. A company can add its own toolbox section too.
They behave like every other section in the tools: wellbore-config validate reports a mistyped key (unknown key 'toolboxes.integrity.wallBasisX' (ignored),
also inside extends files) and checks the files and folders a toolbox points to; show and diff report each toolbox's effective settings - its defaults with
your values over them - and where each came from; template lists every toolbox; and the name of a section may be written in any case. A section of your own
toolbox (one this release does not know) is left alone.
Nothing a company may want to change is fixed in the code. Weights, tolerances, limits, resolutions, ports and typical values are settings of the environment; the numeric constants that remain are physics, mathematics or structure, each justified in a test that fails when a new one appears.
Time zone
Times are stored in UTC. Displayed and printed times use locale.timeZone (an IANA or Windows id such as Europe/Oslo or America/Denver; empty: the
machine's own zone) - so a report printed on a server running in UTC carries the company's date, not the server's.
Every view follows the environment
Schematics, log tracks and templates, the composite well view, correlation panels, cross-sections, well maps, crossplots, the symbol
view and every print take their colours from the theme and styles, their numbers and dates from the display culture, their depths
from the depth unit and their curve colours from the curve rules (logs.styles, also for the curves the library builds itself - triple
combo, gas, core, cement bond). Text on coloured badges (barrier and annulus status, leak paths, flags, change markers) is black or
white, whichever reads on the badge's configured colour. Diameters in barrier tables and generated names (open hole) follow units.diameterUnit:
oilfield fractions when it is inches ("9 5/8 in"), converted values otherwise ("244,5 mm"). New annotations use styles.annotationColor, markers and tops without a unit
colour styles.topMarkerColor, Pickett plots crossplots.pickettWaterLine / pickettSwLine. A test renders every view family in a
company environment and fails if a default colour, a decimal point in a comma culture or a fixed unit shows through.
National lithology standards
The lithology library carries the FGDC (USA) pattern numbers. resources.lithologyStandards layers national standards on top:
"GOST 21.302-2013" is built in (the Russia / CIS interstate standard, adopted by Azerbaijan, Armenia, Belarus, Kazakhstan, Kyrgyzstan,
Moldova, Russia, Tajikistan and Uzbekistan; the AZ, BY, KZ, RU and UZ presets select it). Its Table 4 numbers and names become
aliases - Песчаник, ГОСТ 21.302-28 and GOST 21.302-28 all mean sandstone - for the 29 entries that are rocks of the library;
the other entries (marl, gypsum, loess, peat, tuff ...) stay unmapped and appear in the coverage report rather than being drawn with a
guessed pattern.
The standard's drawings are images in the standard and are not reproduced. A company that draws to GOST 21.302 uses its own approved
CAD hatch library - the AutoCAD .pat file its drawings pass review with: list it in a standard file and name a pattern per rock -
{ "name": "ACME GOST", "patFiles": [ "acme-gost.pat" ], "entries": [],
"overrides": [ { "code": "sandstone", "hatchPattern": "PESCHANIK", "hatchScale": 4, "foreground": "#000000", "background": "#ffffff" } ] }
hatchScale is the number of pixels per pattern unit (about 4 for a pattern drawn in millimetres). The .pat format is read as Autodesk
documents it (angle, origin, offset between lines, dashes; dots and gaps). A pattern name that is not in the file is reported and the
rock keeps its drawing. Other drawings can also be given directly -
{ "name": "...", "entries": [ ... ], "overrides": [ { "code": "sandstone", "pattern": "Dots", "spacing": 6, "foreground": "#000000",
"background": "#ffffff" } ] }. The standard sets no symbol sizes (clause 3.1) and black as the base colour (clause 3.8).
Standards behind the defaults
The default abandonment rule set follows NORSOK D-010:2021+AC:2024 (rev. 5): cement plugs 100 m MD (open hole: at least 50 m above any source of
inflow), 50 m MD on a mechanical or cement foundation, the environmental (open hole to surface) plug 100 m MD - or 50 m MD on a mechanical
plug (abandonment.environmentalPlugFoundationLength). Only some standards allow that reduction: a rule set without environmentalPlugFoundationLength keeps its full environmental-plug
minimum on a mechanical plug (the built-in US-BSEE - 150 ft, 30 CFR 250.1715 - UK-OEUK and RU rule sets state theirs explicitly).
Country presets select their national rule set where one is built in (US, GB, Russia / CIS); the others use NORSOK D-010. The API tubular catalogue follows API Spec 5CT 10th edition / ISO 11960 (grades of
its scope with the usual type designations - L80-13Cr, N80Q ...; M65 was withdrawn); the GOST catalogue GOST 632-80 / 633-80. Pressure
gradients can be given in any gradient unit of the catalogue (psi/ft, psi/100ft, kPa/m, bar/m, MPa/m, MPa/100m, kgf/cm2/m) or as a
density (equivalent mud weight); a pressure setting in any other unit is a validation error, never misread. New tops, pressure points
and other model objects start in units.depthUnit / units.pressureUnit; image logs assume logs.imageBoreholeDiameter when the image
gives no hole size. Curve values meaning "no data" are loaders.nullValues (default -999.25) wherever curves are drawn and checked,
and the DLIS default; LAS files use their own declared NULL. A WITSML store client needs its endpoint set - there is no default
server. Its request timing is live.witsmlTimeoutSeconds (30), live.witsmlRetries (3) and live.witsmlRetryDelaySeconds (1, doubled per
retry) - raise them for slow links such as satellite. Schematic tracks use conversion.dimensioning (Scaled or Schematic) unless a view sets its own, schematic labels
theme.labelFontSize; depth units anywhere (LAS, WITSML, documents) accept the spellings of units.aliases. Curve rules (logs.styles) can set a company's standard scale - "min": 0, "max": 150, "unit": "gAPI" - used for
loaded logs (converted into each curve's unit, e.g. a density rule in g/cm3 on a curve in kg/m3) and for the built-in templates;
without one, loaded curves are scaled to their data. A conductivity curve (a Russian ИК in mS/m, a CILD in mmho/m) that belongs on a resistivity track is drawn as resistivity,
R = 1 / σ (100 mS/m -> 10 ohm.m), with "(from conductivity)" in its name; the data itself is not changed. Analysis reads curves in their units too: water saturation and the Pickett plot take resistivity in any resistivity unit
or from a conductivity curve (1 / σ), and porosity in %, pu or v/v; the porosity curve is the petrophysics.inputs.porosity
role (default PHIT, then PHID), so a company's own mnemonic (e.g. КП) is used. Crossplot axes are crossplots.pickettRtRange (0.1-1000 ohm.m), pickettPorosityRange (0.01-1), densityNeutronNeutronRange
(-0.05-0.45) and densityNeutronDensityRange (1.95-2.95 g/cm3); points outside them are reported with the setting to widen, not
dropped silently. Shale volume compares the gamma ray with petrophysics.grClean / grShale in petrophysics.grUnit (default gAPI;
uR/h - мкР/ч - for Russian / CIS gamma-ray logs, with clean / shale values in that unit). A GR curve in a unit that cannot be
converted to it is reported and shale volume skipped, rather than reading every zone as clean. The cement bond index reads the CBL in cement.amplitudeUnit (mV, the unit of the free-pipe and bonded amplitudes): a CBL in
V or uV is converted; a curve whose unit is not an amplitude (e.g. %) gives no bond index, with the reason in the curve's name. Every text the views draw themselves - track titles, legend title and entries, empty-track messages, crossplot names
and axes, view and accessibility names, header fields - comes from resources.labelFiles (key -> text, e.g.
"legend.title": "Tegnforklaring"), with the English text when a key is not given; a test fails if drawing code writes a word
that bypasses the labels. Dogleg severity is expressed per survey.doglegCourseLength (none: 100 ft for
surveys in feet, 30 m in metres; the Russia / CIS presets use 10 m, the national practice, with the equivalent 5 deg / 10 m warning).
Your libraries and catalogues
The built-in lithologies also answer to the lithologic pattern numbers of the US federal standard FGDC-STD-013-2006 (USGS
Techniques and Methods 11-A2, section 37) where the standard has an exact equivalent: sandstone FGDC-607 / 608, siltstone 616,
shale 620 (clay or clay shale), limestone 627, dolomite 642, chalk 626, salt 668, coal 658, conglomerate 601 / 602 - so data coded with
those numbers resolves without a code map. Anhydrite (FGDC has gypsum, 667), basement and claystone (620 is shale) have no exact
equivalent and are not mapped. resources.lithologyFile replaces the built-in lithology library and resources.symbolCatalogFile the built-in symbol catalog for
every view, track, conversion, validation and print (a file that is missing or broken is reported in the warnings and the built-in
one is used). The tubular catalogue (tubulars: API 5CT / ISO 11960 by default, GOST 632-80 / 633-80 in the Russia / CIS country
files ...) is what schematic validation checks strings against: a casing or tubing outside diameter that is not a standard size
(WS080, with the nearest size), or a grade or connection not in the catalogue (WS081, WS082) is reported for review; conductors and
other sizes outside the catalogue are not judged. Every setting of the environment is used by the libraries - a test fails if one is
added that nothing reads.
Your data sources
The company's own data is part of the environment (dataSources): each source has a kind (csv folder, excel workbook, edmXml export,
las, dlis, witsml file - or a kind your application registers, such as a database), a path relative to the environment file, the
mapping profile it is read with, and your overrides over that profile - your code values (codes: entity, field, source code ->
canonical code, for example your PPDM tubing types) and row filters (where, for example the EDM design case). wellbore-config
sources <environment.json> loads each source once and says what came out. To confirm a source in CI, add verification cases of kind
dataSource (expected well name, counts, curve values at given indices, most warnings allowed - 0 means every code mapped); vendor
dip picks go in as dipCorrection cases. Saving a configuration keeps the data paths pointing at the same files; data is not copied.
Excel workbooks
An Excel workbook (.xlsx) is a data source like a CSV folder: each worksheet is a table named by the sheet and its first row holds
the column names, so the same mapping profile serves both (new ExcelTabularSource(path)). Numbers, text, booleans and dates
(recognised by the cell's number format, in the 1900 or 1904 date system) are read; formulas give the values Excel last saved;
error cells are empty. No extra software or package is needed.
Landmark EDM and OpenWells
EdmXmlTabularSource reads a Landmark EDM XML export (each element a row of its table: CD_WELL, CD_WELLBORE, CD_HOLE_SECT...), and
the built-in edm profile maps it - or the same tables in an EDM database - to wells, wellbores, hole sections, casing strings,
formation tops and definitive survey stations. It is a starter profile (marked verify): its table and column names come from an
EDM export and the welleng EDM reader, and its notes list what was observed and what follows the EDM convention. EDM does not
record the casing role in its hole sections, so add a code map for the kind; a database with several design cases (PLAN / ACTUAL)
needs a where filter on hole_sect_group_id. OpenWells keeps these entities in the same EDM tables; its reporting tables are not
mapped.
Any profile can filter rows ("where": { "column": "value" }), compute fields from the numeric columns of a row
("top": "=md_shoe - length") and join related tables of a normalised model ("joins": { "EQUIPMENT": { "on": "EQUIPMENT_ID" } },
then fields such as "type": "EQUIPMENT.EQUIPMENT_TYPE"). The built-in ppdm39 profile uses only tables and columns that exist in
PPDM 3.9 (checked against the PPDM 3.9 model, and by a test); the code values of your PPDM implementation still need code maps.
DLIS files
DLIS (API RP66 version 1) files load like LAS (DlisReader.LoadFile): the ORIGIN object names the well, every frame becomes a log
set indexed by its first channel (depth, or time), and scalar channels become curves; array channels such as waveforms and images
stay in the decoded file (DlisLoadResult.File) and are listed in the warnings. Every object and attribute is available from
DlisFile (all 27 representation codes, including IBM and VAX floats). Storage unit labels after leading bytes, several storage
units, Tape Image Format wrapping, padding, checksums and trailing lengths are handled; encrypted records are skipped and said; a
broken file gives a clear error and never crashes the host. DLIS has no standard "no data" value: DlisReadOptions.NullValues
(default -999.25). Verified against dlisio on its 158 test files (tools/verification/dlis).
Numbers and dates on screen
locale.culture sets how numbers look on screen and in printed output (for example de-DE: decimal comma); empty keeps the
invariant format (decimal point). locale.dateFormat and locale.dateTimeFormat are .NET date patterns (default yyyy-MM-dd and
yyyy-MM-dd HH:mm; empty: the culture's own short date and time). locale.calendar is Gregorian (default - also for cultures
whose own calendar differs, such as ar-SA or th-TH) or Culture. Every country environment sets its culture, so
"extends": "country:DE" gives decimal commas and dd.MM.yyyy on screen. Files - CSV, LAS, WITSML, JSON, saved views and
configuration - never follow the locale or the machine's culture; tallies and casing programmes stay invariant too, because the
same table is exported as CSV.
Dip conventions
Dip picks may be true dips (against the horizontal) or borehole-relative (against the plane across the hole, as dipmeters and
image logs measure them), with azimuths from north or from the high side of the hole (clockwise looking down-hole), referred to
true, grid or magnetic north. Each pick can say so (frame, azimuthReference, northReference); picks that do not use the
environment's dips section (default: true dips, azimuths from north, the well's survey north). Dip tracks show true dips in the
working north (borehole-relative picks converted with the well's survey; without one a vertical hole is assumed and said); image
logs draw each pick's sinusoid from its dip relative to the hole, in the image's own orientation (North or TopOfHole). verify
checks the conversion against reference picks (kind dipCorrection); built in are analytic cases.
Files from other countries
LAS and CSV files are read correctly whatever their text encoding. Files marked as Unicode, and files in UTF-8, need no setting.
Older files use a regional code page: set the one your files use, for example Cyrillic files from Russia and the CIS (often
windows-1251, sometimes cp866), Chinese (gbk), Japanese (shift_jis), Arabic (windows-1256); the default is Western
European (windows-1252). When a file is read with this code page, a message says so; a single file can override it.
{ "files": { "legacyEncoding": "windows-1251" } }
Equipment details and the completion table
Say which details each kind of equipment must or may have - ratings, materials, serial numbers, or your own fields - and
what values are acceptable. Rules for * apply to all equipment, PACKER_* to every packer type, an exact code to that type
only. Problems appear with the other validation messages (WE001-WE005). The completion table shows the columns you list,
your own fields included.
{ "equipment": {
"attributes": { "PACKER_*": [ { "key": "pressureRating", "label": "Working pressure", "kind": "quantity", "unit": "psi", "required": true, "max": 15000 },
{ "key": "elastomer", "label": "Elastomer", "kind": "choice", "choices": [ "HNBR", "FKM", "AFLAS" ] } ] },
"tallyColumns": [ { "key": "no", "header": "#" }, { "key": "name", "header": "Component" }, { "key": "top", "header": "Top" },
{ "key": "pressureRating", "header": "WP" }, { "key": "elastomer", "header": "Elastomer" }, { "key": "serial", "header": "S/N" } ] } }
By default nothing is required, so existing wells show no new messages, and the table keeps its usual columns.
Trademark footnote and logo
Every print and export (PDF, SVG, PNG - single wells, correlation panels, cross-sections), every view on screen and the
documentation carry a small footnote with the logo, "The Tech Idea™" and the built-in The Tech Idea logo by default. Set the
branding section to change the text, use another logo (PNG or JPEG next to the environment file), hide the logo, or switch
the footnote off for exports or for the screen:
{ "branding": { "footnote": "The Tech Idea™", "logoFile": "logo.png", "showLogo": true, "showInExports": true, "showOnScreen": true } }
Page templates
Name the page layouts you print often; each changes only what it names (paper, orientation, margin, scale, header block, legend, title, footer, extra header fields). Footer texts take tokens: {well}, {title}, {reference}, {range}, {scale}, {page}, {pages}, {date}.
{ "printing": { "templates": {
"a3-log": { "paper": "A3", "scaleRatio": 200, "title": "Completion log", "footerLeft": "{title} · {well}" },
"overview": { "scaleRatio": 0, "landscape": true, "includeLegend": false } } } }
Correlation panels print at the same scale across several pages (a flattened panel is printed on one page); cross-sections print on one page.
Changing the words on screen
Track titles, table headers, print header fields, legend groups and status badges can use your company wording or
language. Put the texts you want to change in a labels file and list it under resources.labelFiles; anything you leave
out keeps the text below.
| Key | Built-in text ({0}, {1} = filled in) |
|---|---|
abandonment.noData | No schematic |
abandonment.title | PERMANENT ABANDONMENT CHECKLIST |
anticollision.cylinderNote | distance normal to the reference well, direction from north |
anticollision.distance | Centre-to-centre distance and MASD |
anticollision.noData | No offset wells scanned |
anticollision.referenceMd | Reference MD |
anticollision.sf | Separation factor |
barriers.annuli | Annuli |
barriers.noData | No well barrier data |
barriers.noReading | no reading |
barriers.notes | Notes: |
barriers.title | WELL BARRIER SCHEMATIC |
casing.burst | Burst |
casing.collapse | Collapse |
casing.notRated | Not rated |
casing.tension | Tension |
corrosion.joint | Joint |
corrosion.penetration | Penetration |
crossplot.densityNeutron | Density-neutron |
crossplot.densityNeutron.x | Neutron porosity (v/v, limestone units) |
crossplot.densityNeutron.y | Bulk density (g/cm3) |
crossplot.pickett | Pickett |
crossplot.pickett.x | Deep resistivity Rt (ohm.m) |
crossplot.pickett.y | Porosity (v/v) |
curve.bondIndex | Bond index |
curve.bondIndex.notAmplitude | CBL unit is not an amplitude |
curve.fromConductivity | {0} (from conductivity) |
depth.md | MD |
depth.tvd | TVD |
header.depthReference | Depth reference |
header.depthUnit | Depth unit |
header.field | Field |
header.fitToPage | fit to page |
header.interval | Interval |
header.operator | Operator |
header.printed | Printed |
header.scale | Scale |
header.uwi | UWI / API |
header.well | Well |
integrity.nonCompliant | not compliant |
integrity.wells | wells |
leakpaths.holding | holding |
leakpaths.met | MET |
leakpaths.noData | No barrier data |
leakpaths.none | none |
leakpaths.notMet | NOT MET |
leakpaths.summary | Weakest leak path: {0} barrier(s) — requirement {1}: {2}{3} |
leakpaths.unverified | (relies on unverified elements) |
legend.annulus.fluids | Annulus fluids |
legend.azimuth | Azimuth (0-360°) |
legend.borehole.image | Borehole image |
legend.completion.equipment | Completion equipment |
legend.core.point.data | Core / point data |
legend.curves | Curves |
legend.dips | Dips |
legend.dogleg | Dogleg severity |
legend.gasGradient | Gas gradient |
legend.group.pressure | Pressure |
legend.group.trajectory | Trajectory |
legend.inclination | Inclination (0-90°) |
legend.lithology | Lithology |
legend.oilGradient | Oil gradient |
legend.pressure | Pressure |
legend.shading | Shading |
legend.title | Legend |
legend.trajectory | Trajectory |
legend.waterGradient | Water gradient |
legend.well.barriers | Well barriers |
live.live | LIVE |
live.stale | STALE |
live.waiting | WAITING |
mapping.azimuth | azimuth |
mapping.bubbleRule | Area is proportional to the value |
mapping.contourInterval | Contour interval |
mapping.degrees | degrees |
mapping.easting | Easting |
mapping.elevation | Elevation |
mapping.elevationAngle | elevation |
mapping.noScene | Nothing to show |
mapping.noSurface | No surface |
mapping.north | N |
mapping.northing | Northing |
mapping.planned | planned |
mapping.surfaces | surfaces |
mapping.verticalExaggeration | Vertical exaggeration |
mapping.wells | wells |
pay.cutoffs | cutoffs |
pay.gross | Gross |
pay.hcColumn | HC column |
pay.netPay | Net pay |
pay.netReservoir | Net res. |
pay.ntg | N/G |
pay.porosity | PHI |
pay.sw | Sw |
pay.vsh | Vsh |
pressure.axis | Pressure [{0}] |
program.col.bottom | Bottom |
program.col.connection | Connection |
program.col.grade | Grade |
program.col.hole | Hole |
program.col.id | ID |
program.col.name | String |
program.col.no | # |
program.col.od | OD |
program.col.source | Source |
program.col.toc | TOC |
program.col.top | Top |
program.col.weight | Weight |
program.title | Casing & tubing program |
tally.col.bottom | Bottom |
tally.col.connection | Connection |
tally.col.grade | Grade |
tally.col.id | ID |
tally.col.length | Length |
tally.col.manufacturer | Manufacturer |
tally.col.name | Component |
tally.col.no | # |
tally.col.od | OD |
tally.col.part | Part no. |
tally.col.serial | Serial no. |
tally.col.source | Source |
tally.col.top | Top |
tally.col.tvd | Top TVD |
tally.col.type | Type |
tally.col.weight | Weight |
tally.title | Completion tally |
timeDepth.days | Days |
timeDepth.depth | Depth |
timeDepth.noData | No report |
track.abandonment | P&A checklist |
track.barriers | Well barriers |
track.bondFlags | Bond |
track.bondIndex | Bond index |
track.casingDesign | Casing design |
track.cbl | CBL |
track.changes | Changes |
track.chromatograph | Chromatograph |
track.chronostratigraphy | Chronostratigraphy |
track.corePermeability | Core permeability |
track.corePorosity | Core porosity |
track.corrosion | Corrosion |
track.cuttings | Cuttings |
track.depth | Depth |
track.dips | Dips |
track.flags | Flags |
track.gasCharacter | Fluid (Haworth) |
track.gasRatios | Gas ratios |
track.image | Image |
track.intervals | Zones |
track.leakpaths | Leak paths |
track.paySummary | Pay summary |
track.pressure | Formation pressure |
track.schematic | Completion |
track.tally | Completion table |
track.trajectory | Deviation |
track.waveform | VDL |
track.wellpath | Well path |
training.correct | Correct. |
training.incorrect | Not correct. |
training.notAnswered | Not answered. |
training.partlyCorrect | Partly correct. |
trajectory.noSurvey | no survey |
trajectory.td | TD |
view.contourMap | Contour map |
view.correlation | Well Correlation |
view.correlation.accessible | Correlation panel |
view.crossSection | Cross-section |
view.crossplot | Crossplot |
view.integrityBoard | Well integrity |
view.ladderPlot | Ladder plot |
view.scene3d | 3D scene |
view.timeDepth | Time-depth |
view.travellingCylinder | Travelling cylinder |
view.wellLog | Well Log Canvas |
view.wellMap | Well map |
view.wellbore | Wellbore View |
view.wellbore.accessible | Wellbore view |
waveform.timeAxis | time [µs] |
wellPath.noData | No survey / schematic |
All settings
| Key | Type | Default | Meaning |
|---|---|---|---|
| Top level | |||
schemaVersion | int | 1 | Environment file schema version. |
extends | list | null | Base environment file(s) this one extends (a company base, then country / asset overlays); later files win, objects merge key by key, lists are replaced. Paths are relative to this file. |
name | string | "Default" | Name of this environment, e.g. customer or country profile. |
culture | string | "en-US" | Culture for labels and localized layer names, e.g. en-US, nb-NO. |
description | string | null | Free text description. |
units - Units. | |||
units.system | string | null | Unit system filling the unit settings not set explicitly (a key of units.systems). |
units.systems | map | {"oilfield": {"depthUnit": "ft", "pressureUnit": "psi", "diameterUnit": "in", "weightUnit": "lbm/ft", "forceUnit": "klbf"}, "metric-kpa":… | Unit systems by name (depth, pressure, diameter, weight units); add your own. |
units.definitions | map | {"m": {"dimension": "Length", "factor": 1, "offset": 0, "aliases": ["meter", "meters", "metre", "metres"]}, "ft": {"dimension": "Length",… | Unit definitions by symbol (dimension, factor to SI, offset, aliases); add or override units. |
units.aliases | map | {} | Other spellings of known units (spelling -> unit symbol, e.g. "FEET": "ft"); adds names without redefining the unit. |
units.depthUnit | string | "ft" | Default depth unit for new views and conversions: ft or m. |
units.pressureUnit | string | "psi" | Pressure display unit (tables, readouts): psi, kPa, MPa, bar. |
units.diameterUnit | string | "in" | Diameter display unit in tables: in or mm. |
units.weightUnit | string | "lbm/ft" | Linear weight display unit in tables: lbm/ft or kg/m. |
units.forceUnit | string | "klbf" | Force display unit (tension ratings and loads): klbf, lbf, kN, daN, tf. |
display - Display defaults. | |||
display.minZoomSpan | measure | {"value": 0.5, "unit": "ft"} | Deepest zoom: the smallest depth span a view shows, converted to each axis's unit. |
display.chronostratigraphyRank | string | null | Chart rank shown as chronostratigraphy zones beside the tops (Period, Epoch, Age ...); empty: no zones. |
display.trackGap | float | 6 | Gap between tracks (px). |
display.headerHeight | float | 28 | Minimum track header height (px); tracks may grow it. |
display.depthScaleMode | string | "True" | Default depth scale of new axes: True or Compressed. |
display.compressionPower | float | 0.5 | Compressed depth: exponent applied to gaps between features (0-1; lower compresses more). |
display.minGapPx | float | 8 | Compressed depth: minimum height of a compressed gap (px). |
theme - Theme colours and fonts. | |||
theme.presets | map | {"light": {}, "dark": {"trackBackground": "#161b22", "depthTrackBackground": "#0f141a", "grid": "#30363d", "headerFill": "#1f2630", "head… | Theme presets by name (colour keys filled under the explicit ones); add your own or change the built-in ones. |
theme.preset | string | null | Theme preset applied under the explicit keys: a name from theme.presets (light, dark, print, highContrast or your own). |
theme.trackBackground | string | "#f8f9fc" | Track background colour. |
theme.depthTrackBackground | string | "#f1f4f9" | Depth track background colour. |
theme.grid | string | "#c8ced8" | Grid line colour. |
theme.headerFill | string | "#e4e9f1" | Header fill colour. |
theme.headerBorder | string | "#aab0ba" | Header border colour. |
theme.text | string | "#262e3a" | Text colour. |
theme.depthLabel | string | "#2c343e" | Depth label colour. |
theme.frame | string | "#a6aeb8" | Frame colour. |
theme.selection | string | "#0078d7" | Selection highlight colour. |
theme.cursor | string | "#c82828" | Depth cursor colour. |
theme.frameWidth | float | 1.25 | Frame line width (px). |
theme.titleFontSize | float | 12 | Track title font size (px). |
theme.subtitleFontSize | float | 10 | Track subtitle font size (px). |
theme.labelFontSize | float | 10 | Label font size (px) of schematic equipment labels. |
theme.depthFontSize | float | 11 | Depth label font size (px). |
theme.markerWidth | float | 1.4 | Top / marker line width (px). |
theme.surface | string | "#fdfdfd" | Canvas surface colour. |
theme.surfaceBorder | string | "#b1b6bf" | Canvas surface border colour. |
theme.sectionHeader | string | "#505a69" | Section header bars in tables (e.g. Annuli). |
styles - Domain styles (barriers, contacts, dips, fluids, palettes). | |||
styles.topMarkerColor | string | "#6b5b3a" | Colour of a formation top whose stratigraphic unit has no colour. |
styles.annotationColor | string | "#e65100" | Colour of new annotations. |
styles.barrierPrimary | string | "#1f5fa8" | Primary well barrier colour (NORSOK D-010 convention: blue). |
styles.barrierSecondary | string | "#c0392b" | Secondary well barrier colour (NORSOK D-010 convention: red). |
styles.barrierEnvironmental | string | "#2e8b57" | Environmental (surface) barrier colour (P&A convention: green). |
styles.changeAdded | string | "#2e963c" | State comparison: added item colour. |
styles.changeModified | string | "#e68200" | State comparison: modified item colour. |
styles.changeRemoved | string | "#c81e1e" | State comparison: removed item colour. |
styles.contactColors | map | {"GOC": "#d63a2f", "GWC": "#2e8b57", "OWC": "#1f5fa8", "FWL": "#0b3d91", "GDT": "#d63a2f", "ODT": "#8a5a10", "OUT": "#8a5a10", "WUT": "#1… | Fluid contact colours by code (GOC, GWC, OWC, FWL, GDT, ODT, OUT, WUT). |
styles.dipColors | map | {"Bedding": "#282828", "CrossBedding": "#8c6e1e", "FractureOpen": "#d63a2f", "FractureHealed": "#2e8b57", "Fault": "#8e44ad", "Unconformi… | Dip pick colours by type (Bedding, CrossBedding, FractureOpen, FractureHealed, Fault, Unconformity, Unknown). |
styles.annulusFluidColors | map | {"Brine": "#9fd3f0", "Water": "#bfe3f7", "WaterBasedMud": "#b89a6a", "OilBasedMud": "#7a5a3a", "Diesel": "#f0dc82", "PackerFluid": "#8fc9… | Annulus fluid fill colours by fluid (Brine, Water, WaterBasedMud, OilBasedMud, Diesel, PackerFluid, Nitrogen, Gas, Cement, Unknown). |
styles.gasCharacterColors | map | {"VeryDryGas": "#f2b6b0", "Gas": "#d63a2f", "GasWithOil": "#e07b39", "Oil": "#2e8b3c", "ResidualOil": "#6b5b3a"} | Mud-gas fluid character colours (VeryDryGas, Gas, GasWithOil, Oil, ResidualOil). |
styles.pressureFluidColors | map | {"Gas": "#d63a2f", "Oil": "#2e8b3c", "Water": "#1f5fa8", "Unknown": "#5a5a5a"} | Pressure gradient colours by fluid (Gas, Oil, Water, Unknown). |
styles.bondColors | map | {"Good": "#2e7d32", "Partial": "#f0a020", "Poor": "#c62828"} | Cement bond quality colours (Good, Partial, Poor). |
styles.statusColors | map | {"Intact": "#2e7d32", "Unverified": "#787878", "Impaired": "#dc8200", "Failed": "#c81e1e", "Open": "#969696", "Pass": "#2e7d32", "Fail": … | Status colours: barrier elements (Intact, Unverified, Impaired, Failed, Open), requirement (Pass, Fail), annuli (Ok, AboveMawop, AboveMaasp, NoData), live feed (Live, Stale, Waiting), documents (Planned, AsBuilt), off-line wells (OffLine). |
styles.sectionColors | map | {"Steel": "#3a3f47", "Cement": "#c9c3b5", "OpenHoleFill": "#f3efe6", "OpenHoleEdge": "#787878", "Equipment": "#141414", "WellPath": "#1e1… | Well-path / cross-section drawing colours (Steel, Cement, OpenHoleFill, OpenHoleEdge, Equipment, WellPath). |
styles.correlationPalette | list | ["#6b5b3a", "#b8a600", "#c0392b", "#1f5fa8", "#2e8b57", "#8e44ad"] | Correlation-line colours for tops, cycled in top order (contacts keep their contact colour). |
styles.zoneTints | list | ["#d6c496", "#facd78", "#aacdeb", "#c8e1af", "#e1bed2"] | Cross-section zone tints for zones without a lithology, cycled. |
styles.trajectoryColors | map | {"Inclination": "#146e3c", "Azimuth": "#783caa", "Dogleg": "#d27814"} | Trajectory track colours (Inclination, Azimuth, Dogleg). |
styles.leakPathColors | map | {"Source": "#ffe0b2", "Sink": "#c8e6ff", "Highlight": "#ff5050"} | Leak-path diagram colours (Source, Sink, Highlight). |
styles.imagePalette | list | [{"at": 0, "color": "#000000"}, {"at": 0.25, "color": "#5a280a"}, {"at": 0.5, "color": "#be6414"}, {"at": 0.75, "color": "#f5be3c"}, {"at… | Borehole image palette: colour stops from 0 (low) to 1 (high); default 'heated'. |
logs - Log curve families, styles and log validation thresholds. | |||
logs.families | list | [{"name": "Gamma Ray", "order": 0, "match": {"contains": ["GR", "GAMMA", "SGR", "CGR"], "startsWith": [], "exact": ["SP", "NGT", "VSH"], … | Curve families (tracks) and the mnemonics that belong to them; first match wins; unmatched curves go to FallbackFamily. |
logs.mnemonicAliases | map | {} | Other names for mnemonics (e.g. Russian ГК -> GR): grouped and styled as the canonical mnemonic; not used as petrophysics inputs. |
logs.imageBoreholeDiameter | measure | {"value": 8.5, "unit": "in"} | Hole size assumed for image logs (dip sinusoid amplitude) when the image does not give its own. |
logs.fallbackFamily | string | "Other" | Family for curves matching no rule. |
logs.fallbackOrder | int | 5 | Order of the fallback family. |
logs.styles | list | [{"match": {"contains": ["GR", "GAMMA"], "startsWith": [], "exact": [], "family": null}, "color": "#009688", "brush": "gamma_ray", "scale… | Curve styles; first matching rule wins. |
logs.maxClippedFraction | double | 0.2 | Validation: fraction of values outside the scale above which a curve is flagged (WL009). |
logs.gapFactor | double | 10 | Validation: a depth step larger than this multiple of the median step is a data gap (WL008). |
loaders - File loader settings. | |||
loaders.lasIndexMnemonics | list | ["DEPT", "DEPTH", "MD", "TVD", "TVDSS"] | LAS index curve mnemonics, in priority order. |
loaders.lasDefaultNull | double | -999.25 | LAS null value when the file does not declare NULL. |
loaders.nullValues | list | [-999.25] | Curve sample values meaning no data (log tracks, checks, DLIS default; LAS files use their declared NULL). |
survey - Survey quality control. | |||
survey.toolModel | string | "MWD+SRGM" | Survey tool error model used for position uncertainty (a key of survey.toolModels; default the OWSG standard MWD model MWD+SRGM, A001Mc). |
survey.toolModels | map | {"ISCWSA MWD Rev5": {"name": "ISCWSA MWD Rev5", "source": "ISCWSA MWD (Fixed Rig) Rev 5 model table (same as OWSG MWD Rev 2), from the IS… | Survey tool error models by name (built in: ISCWSA MWD Rev5 and 53 OWSG Tool Group A Rev 5.1 models); add your own. |
survey.workingNorth | string | "Grid" | North that trajectories, maps and sections work in (Grid or True); survey azimuths are corrected to it. |
survey.gridConvergencePositiveEast | bool | true | Grid convergence sign: true = positive when grid north is east of true north (grid azimuth = true azimuth - convergence). |
survey.doglegWarning | double | 15 | Dogleg severity above which a survey station is flagged, in deg per survey.doglegCourseLength (WV013). |
survey.doglegCourseLength | measure | null | Course length dogleg severity is expressed per (none: 100 ft / 30 m; Russia / CIS: 10 m). |
survey.uncertainty.sigma | double | 2 | Confidence multiplier of the ellipses (2 = two standard deviations). |
survey.uncertainty.ellipseCount | int | 10 | Most ellipses drawn along a path; drawn at survey stations (where the uncertainty is defined), evenly spread. |
survey.uncertainty.sources | list | [{"code": "DRF", "description": "Depth reference", "mode": "random", "magnitude": 0.35, "unit": "m", "weight": "depth"}, {"code": "DSF", … | Error sources (default: simplified MWD subset in the ISCWSA structure; use your tool model's values). |
barriers - Well barriers. | |||
barriers.requiredBarriers | int | 2 | Barriers required on every leak path (two-barrier principle). |
barriers.countImpaired | bool | false | Count impaired elements as barriers in leak-path analysis. |
barriers.acceptanceReferences | map | {"FLUID_COLUMN": "NORSOK D-010 Rev 3 Table 1", "CASING": "NORSOK D-010 Rev 3 Table 2", "DRILLING_BOP": "NORSOK D-010 Rev 3 Table 4", "WEL… | Acceptance-criteria reference per WBE type (standard + table). Defaults: only NORSOK D-010 Rev 3 tables verified; set your revision / company standard. |
annuli - Annuli / MAASP screening. | |||
annuli.burstDerating | double | 0.8 | MAASP screening: derating applied to the outer casing burst rating (0-1). |
annuli.collapseDerating | double | 1 | MAASP screening: derating applied to the inner string collapse rating (0-1). |
pressure - Formation pressure analysis. | |||
pressure.gasOilBoundary | measure | {"value": 0.2, "unit": "psi/ft"} | Gradient below which a fluid is typed as gas. |
pressure.oilWaterBoundary | measure | {"value": 0.4, "unit": "psi/ft"} | Gradient at or above which a fluid is typed as water. |
pressure.minGradientContrast | measure | {"value": 0.05, "unit": "psi/ft"} | Automatic zoning: minimum gradient difference between adjacent zones. |
pressure.splitImprovement | double | 0.5 | Automatic zoning: a further split must reduce the squared error by at least this fraction. |
pressure.maxZones | int | 3 | Automatic zoning: maximum number of fluid zones. |
pressure.minPointsPerZone | int | 3 | Automatic zoning: minimum tests per zone. |
pressure.maxRmsResidual | measure | {"value": 3, "unit": "psi"} | Gradient fit RMS residual above which a fit is flagged (WL031). |
gasRatios - Mud-gas ratio interpretation. | |||
gasRatios.veryDryGasWetness | double | 0.5 | Haworth: wetness (Wh) below this is very dry gas. |
gasRatios.gasWetnessMax | double | 17.5 | Haworth: upper wetness of the gas band. |
gasRatios.oilWetnessMax | double | 40 | Haworth: upper wetness of the oil band (above: residual oil). |
gasRatios.characterOilThreshold | double | 0.5 | Haworth: character (Ch) at or above which gas is associated with oil. |
gasRatios.minShowGas | double | 1000 | Minimum total gas for ratios to be interpreted (below: background). |
cement - Cement bond evaluation. | |||
cement.freePipeAmplitude | float | 62 | CBL amplitude in free pipe (mV) — replace with your tool / casing calibration. |
cement.bondedAmplitude | float | 2 | CBL amplitude at 100 % bond (mV). |
cement.amplitudeUnit | string | "mV" | Unit of freePipeAmplitude / bondedAmplitude (mV); CBL curves in another voltage unit are converted. |
cement.goodBondIndex | float | 0.8 | Bond index at or above which bond is good. |
cement.poorBondIndex | float | 0.3 | Bond index below which bond is poor. |
cement.minIsolationLength | measure | {"value": 10, "unit": "ft"} | Continuous good bond required for a cement barrier element to be verified. |
cement.minCoverage | double | 0.5 | Minimum fraction of a cement element that must be logged to verify it. |
history - Well history comparison. | |||
history.matchTolerance | measure | {"value": 200, "unit": "ft"} | State comparison: items of the same type within this distance are the same item. |
history.stringMatchFactor | double | 5 | State comparison: tolerance multiplier for strings (long objects). |
validation - Other validation thresholds. | |||
validation.cuttingsTotalTolerance | double | 5 | Cuttings: allowed deviation of a sample's lithology total from 100 % (WL070). |
correlation - Correlation panels. | |||
correlation.wellGap | float | 70 | Gap between wells (px). |
correlation.showWellheads | bool | false | Show wellhead stacks above the plots. |
correlation.reference | string | "TVDSS" | Default vertical reference: MD, TVD or TVDSS. |
crossSection - Cross-sections. | |||
crossSection.maxOffset | double | 0 | Flag wells farther than this from the section line (0 = no limit), in the panel unit. |
crossSection.verticalExaggeration | float | null | Fixed vertical exaggeration; null = fit the panel. |
printing - Printing and export. | |||
printing.papers | map | {"A4": {"width": 595.28, "height": 841.89}, "A3": {"width": 841.89, "height": 1190.55}, "Letter": {"width": 612, "height": 792}, "Tabloid… | Paper sizes by name in points (portrait); add your own. |
printing.paper | string | "A4" | Paper: a name from printing.papers (A4, A3, Letter, Tabloid or your own). |
printing.landscape | bool | false | Landscape orientation. |
printing.margin | float | 28 | Page margin (pt). |
printing.scaleRatio | float | 500 | Depth scale 1:N (0 = fit to page). |
printing.includeHeaderBlock | bool | true | Print the well header block on page 1. |
printing.headerBlockHeight | float | 118 | Header block height (pt). |
printing.includeLegend | bool | true | Print the legend. |
printing.footerHeight | float | 16 | Footer height (pt). |
printing.dpi | float | 150 | Raster export resolution (dpi). |
printing.headerFields | map | {} | Extra header-block fields (label -> value), e.g. company, rig, revision. |
printing.footerLeft | string | "{well} · {reference} {range} · scale {scale}" | Left footer text. Tokens: {well}, {title}, {reference}, {range}, {scale}, {page}, {pages}, {date}. |
printing.footerRight | string | "page {page} / {pages}" | Right footer text (same tokens). |
printing.templates | map | {} | Named page templates (for example "a3-log"): each changes only the settings it names. |
live - Real-time display. | |||
live.staleAfterSeconds | double | 120 | Seconds without new data before a live feed is shown as STALE. |
live.witsmlTimeoutSeconds | double | 30 | Seconds allowed for one WITSML store request (raise for slow links, e.g. satellite). |
live.witsmlRetries | int | 3 | WITSML retries after a transient failure (network error, timeout, HTTP 5xx). |
live.witsmlRetryDelaySeconds | double | 1 | Seconds before the first WITSML retry; doubled for each further retry. |
live.followSpan | float | 200 | Depth span shown in follow mode (axis units). |
imageLogs - Borehole image logs. | |||
imageLogs.normalization | string | "Dynamic" | Default normalization: Static or Dynamic. |
imageLogs.dynamicWindow | measure | {"value": 6, "unit": "ft"} | Dynamic normalization window. |
imageLogs.levels | int | 16 | Colour levels. |
dataSources | map | {} | The company's data sources by name, with their profile overrides (code values, row filters). |
locale - How numbers and dates look on screen (files stay invariant). | |||
locale.culture | string | "" | Culture for numbers on screen (for example de-DE: decimal comma); empty: invariant. Files are never affected. |
locale.dateFormat | string | "yyyy-MM-dd" | Date pattern on screen (.NET custom format, for example dd.MM.yyyy); empty: the culture's short date. |
locale.dateTimeFormat | string | "yyyy-MM-dd HH:mm" | Date and time pattern on screen; empty: the culture's short date and time. |
locale.timeZone | string | "" | Time zone for displayed and printed times (IANA or Windows id, e.g. UTC, Europe/Oslo, America/Denver); empty: the machine's own. |
locale.calendar | string | "Gregorian" | Calendar of dates on screen: Gregorian (default) or Culture (the culture's own, e.g. Hijri for ar-SA). |
dips - Conventions of dip picks that do not state their own. | |||
dips.frame | string | "True" | Frame of dip angles: True or BoreholeRelative. |
dips.azimuthReference | string | "North" | What dip azimuths are measured from: North or HighSide. |
dips.northReference | string | null | North of north-referenced dip azimuths: True, Grid or Magnetic; none: the well's survey north. |
conversion - Model-to-view conversion defaults. | |||
conversion.depthMode | string | "Compressed" | Depth scale of converted views: True or Compressed. |
conversion.dimensioning | string | "Scaled" | Schematic dimensioning: Scaled (real diameters) or Schematic. |
conversion.installedOnly | bool | true | Show only installed items (not removed / abandoned). |
conversion.addCasingShoes | bool | true | Add casing shoes at string bottoms. |
conversion.labelComponents | bool | true | Label components with their names. |
conversion.generateBarriers | bool | false | Generate a typical barrier set when the source has none (marked Planned). |
conversion.generateAnnuli | bool | false | Identify annuli from strings when the source has none. |
conversion.showTrajectory | bool | true | Add a deviation track when a survey exists. |
conversion.showBarrierTable | bool | true | Add the barrier / integrity table when barrier or annulus data exists. |
petrophysics - Computed petrophysical curves (shale volume, porosity, water saturation). | |||
petrophysics.grClean | double | 20 | Gamma ray of clean formation (API) - shale volume. |
petrophysics.grShale | double | 120 | Gamma ray of shale (API) - shale volume. |
petrophysics.grUnit | string | "gAPI" | Unit of grClean / grShale (gAPI; uR/h for Russian / CIS gamma-ray logs). |
petrophysics.cutoffs.vshMax | double | null | Maximum shale volume (v/v) of net reservoir. |
petrophysics.cutoffs.porosityMin | double | null | Minimum porosity (v/v) of net reservoir. |
petrophysics.cutoffs.swMax | double | null | Maximum water saturation (v/v) of net pay. |
petrophysics.zoneCutoffs | map | {} | Cutoffs per zone (formation name), overriding cutoffs field by field. |
petrophysics.vshMethod | string | "Linear" | Shale volume from the gamma-ray index: Linear, LarionovTertiary, LarionovOlder, Clavier or Steiber. |
petrophysics.matrixDensity | measure | {"value": 2.65, "unit": "g/cm3"} | Matrix density (sandstone 2.65, limestone 2.71, dolomite 2.87 g/cm3). |
petrophysics.fluidDensity | measure | {"value": 1, "unit": "g/cm3"} | Pore fluid density (fresh water 1.0, salt mud filtrate about 1.1 g/cm3). |
petrophysics.densityNeutronMethod | string | "Average" | Density-neutron combination: Average or RootMeanSquare (gas zones). |
petrophysics.archieA | double | 1 | Archie tortuosity factor a. |
petrophysics.archieM | double | 2 | Archie cementation exponent m. |
petrophysics.archieN | double | 2 | Archie saturation exponent n. |
petrophysics.rw | double | 0.05 | Formation water resistivity Rw at formation temperature (ohm.m). |
petrophysics.inputs | map | {"gammaRay": "GR", "density": "RHOB", "neutron": "NPHI", "resistivity": "RT", "porosity": "PHIT"} | Input curve mnemonics (after the curve-mnemonic vocabulary): gammaRay, density, neutron, resistivity. |
antiCollision - Anti-collision: ISCWSA separation rule parameters and levels. | |||
antiCollision.scalingFactor | double | 3.5 | Dimensionless scaling factor k (SPE-187073: 3.5). |
antiCollision.surfaceMargin | measure | {"value": 0.3, "unit": "m"} | Surface margin Sm (SPE-187073: 0.3 m). |
antiCollision.projectAhead | measure | {"value": 0.5, "unit": "m"} | Project-ahead uncertainty, 1 sigma (SPE-187073: 0.5 m). |
antiCollision.scanStep | measure | {"value": 10, "unit": "m"} | MD step of the reference-well scan. |
antiCollision.geomagneticCorrelation | bool | true | Correct for geomagnetic reference errors shared by both wells (ISCWSA technical supplement on partial correlations). |
antiCollision.scanRadius | measure | {"value": 5000, "unit": "m"} | Offset wells whose wellhead is farther than this are left out. |
antiCollision.levels | list | [{"name": "Stop", "below": 1, "color": "#b71c1c"}, {"name": "Adjust plan", "below": 1.25, "color": "#e65100"}, {"name": "Shut in / adjust… | Separation-factor levels (defaults: the ISCWSA e-book's documented operator rules). |
antiCollision.offsetColors | list | ["#00897b", "#6a1b9a", "#ef6c00", "#2e7d32", "#ad1457", "#283593"] | Colours of offset wells on the plots, in turn. |
casingDesign - Casing design checks: rating method, grade yields, design factors, pipe dimensions. | |||
casingDesign.method | string | "API 5C3" | Rating method: API 5C3 (ISO/TR 10400 ductile rupture not yet implemented). |
casingDesign.gradeYield | map | {"H40": 40, "J55": 55, "K55": 55, "N80": 80, "L80": 80, "C90": 90, "R95": 95, "T95": 95, "C110": 110, "P110": 110, "Q125": 125} | Minimum yield strength per grade (ksi), API Spec 5CT; add your grades. |
casingDesign.designFactors.burst | double | 1.25 | Burst design factor (default 1.25, Devon Energy example, EPA workshop 2011). |
casingDesign.designFactors.collapse | double | 1.1 | Collapse design factor (default 1.1, same source). |
casingDesign.designFactors.tension | double | 1.4 | Tension design factor (default 1.4, same source). |
casingDesign.pipeDimensions | list | [{"outerDiameter": 9.625, "weight": 32.3, "wall": 0.312}, {"outerDiameter": 9.625, "weight": 36, "wall": 0.352}, {"outerDiameter": 9.625,… | Nominal weight -> wall thickness (in, lb/ft, in) for strings without an inside diameter. |
casingDesign.steelDensity | measure | {"value": 7.85, "unit": "g/cm3"} | Steel density for buoyancy (carbon steel 7.85 g/cm3). |
osdu - OSDU export: data partition, ACL groups, legal tags, countries. | |||
osdu.dataPartition | string | "" | Data partition id: the namespace of record and reference-data ids (e.g. opendes). |
osdu.viewers | list | [] | ACL viewer groups (e.g. data.default.viewers@opendes.yourcompany.com). |
osdu.owners | list | [] | ACL owner groups. |
osdu.legalTags | list | [] | Legal tags of the records. |
osdu.countries | list | [] | Other relevant data countries (ISO 3166 two-letter); none: the environment's country. |
toolboxes | map | {} | Settings of toolboxes (well integrity, drilling, production, data and AI, training, or your own), one object per toolbox. |
abandonment - Permanent plug and abandonment checks. | |||
abandonment.ruleSet | string | null | Rule set in effect: a key of abandonment.ruleSets; empty = the values of this section (the default rule set, NORSOK D-010). |
abandonment.environmentalPlugDepthFrom | string | "datum" | For this section's rule set: what the environmental plug depth is measured from (datum as before, or surface). |
abandonment.ruleSets | map | {"US-BSEE": {"name": "US offshore (BSEE, 30 CFR 250.1715)", "reference": "30 CFR 250.1715 - How must I permanently plug a well?", "status… | Other named rule sets; built in: US-BSEE (30 CFR 250.1715), UK-OEUK (OEUK guidelines), RU (Rostekhnadzor order No. 534); add your own. |
abandonment.minPlugLength | measure | {"value": 100, "unit": "m"} | Minimum cement plug length (NORSOK D-010 rev. 5: 100 m MD; open hole: at least 50 m MD above any source of inflow). |
abandonment.foundationPlugLength | measure | {"value": 50, "unit": "m"} | Minimum plug length when set on a mechanical or cement foundation (NORSOK D-010 rev. 5, cased hole: 50 m MD). |
abandonment.foundationTolerance | measure | {"value": 5, "unit": "m"} | A foundation counts when its top is within this distance of the plug base. |
abandonment.environmentalPlugMaxDepth | measure | {"value": 50, "unit": "m"} | An environmental (surface) plug must have its top shallower than this depth. |
abandonment.environmentalPlugMinLength | measure | {"value": 100, "unit": "m"} | Minimum length of the environmental (surface) plug (NORSOK D-010 rev. 5: 100 m MD; on a mechanical plug see environmentalPlugFoundationLength). |
abandonment.environmentalPlugFoundationLength | measure | {"value": 50, "unit": "m"} | Minimum length of the environmental plug when set on a mechanical plug (NORSOK D-010 rev. 5: 50 m MD). |
abandonment.sourceTypes | list | ["PERFORATION", "OPEN_HOLE"] | Interval / component types treated as sources of inflow (plus open hole). |
abandonment.reference | string | "NORSOK D-010:2021+AC:2024 (rev. 5)" | Standard referenced by the checks (shown in the checklist). |
map - Well map (plan view). | |||
map.wellColor | string | "#263238" | Well surface location marker colour. |
map.pathColor | string | "#1f5fa8" | Plan-view well path colour. |
map.sectionLineColor | string | "#d81b60" | Section line colour. |
map.showGrid | bool | true | Draw a coordinate grid. |
map.pickRadius | float | 10 | Pixel radius within which a click selects a well. |
crossplots - Crossplots (density-neutron, Pickett). | |||
crossplots.densityNeutronLines | list | [{"name": "Sandstone", "matrixDensity": 2.65, "neutronAtMatrix": -0.035, "color": "#c9a227"}, {"name": "Limestone", "matrixDensity": 2.71… | Density-neutron lithology lines. Limestone is exact for a limestone-calibrated neutron; sandstone and dolomite offsets are approximate defaults - replace them with your tool's chart values. |
crossplots.pickettSwLines | list | [1, 0.5, 0.25] | Water saturations drawn as Pickett lines (fractions). |
crossplots.pickettRtRange | list | [0.1, 1000] | Pickett resistivity axis [min, max] (ohm.m, logarithmic); points outside are reported. |
crossplots.pickettPorosityRange | list | [0.01, 1] | Pickett porosity axis [min, max] (v/v, logarithmic). |
crossplots.densityNeutronNeutronRange | list | [-0.05, 0.45] | Density-neutron neutron axis [min, max] (v/v, limestone units). |
crossplots.densityNeutronDensityRange | list | [1.95, 2.95] | Density-neutron density axis [min, max] (g/cm3). |
crossplots.pointSize | float | 2.5 | Point radius (px). |
crossplots.pointColor | string | "#37474f" | Colour of points without zone or colour curve. |
crossplots.rampLow | string | "#2e7d32" | Colour-curve ramp, low end. |
crossplots.pickettWaterLine | string | "#1565c0" | Pickett plot: colour of the Sw = 1 (water) line. |
crossplots.pickettSwLine | string | "#78909c" | Pickett plot: colour of the other Sw lines. |
crossplots.rampHigh | string | "#c62828" | Colour-curve ramp, high end. |
verification - Reference cases run by wellbore-config verify. | |||
verification.cases | list | [{"name": "foot to metre (exact)", "kind": "unit", "tolerance": 1e-12, "value": 1, "expected": 0.3048, "from": "ft", "to": "m", "survey":… | Reference cases run by wellbore-config verify; the built-in ones have exact or closed-form answers. |
schematic - Schematic layout geometry (host slot radii). | |||
schematic.roles | map | {"tubing": {"componentTypes": [], "symbols": ["str_tubing"], "symbolPrefixes": [], "excludeSymbols": []}, "productionCasing": {"component… | Symbol roles (tubing, packer, safety valve, wellhead, cement plug...): component types, symbols, prefixes, exclusions. |
schematic.hostFamilies | map | {"tubing": "tubing", "tubing_in_casing": "tubing", "tubing_in_open_hole": "tubing", "dual_tubing_in_casing": "tubing", "liner_in_casing":… | How each host slot is drawn: tubing, linerInCasing, liner or casing. |
schematic.overlayReach | float | 24 | How far an overlay reaches outward from its slot (symbol units). |
schematic.hostRadii | map | {"tubing": 9, "tubing_in_casing": 9, "tubing_in_open_hole": 9, "casing": 24, "liner": 17, "lower_completion": 17, "liner_in_casing": 17, … | Radius of each equipment host slot (symbol units). |
tubulars - Tubular catalogue (casing and tubing sizes, grades, connections) of the standard in use. | |||
tubulars.standard | string | "API 5CT / ISO 11960" | Standard the catalogue follows (information). |
tubulars.sizeUnit | string | "in" | Unit of the sizes (in or mm). |
tubulars.casingSizes | list | ["4 1/2", "5", "5 1/2", "6 5/8", "7", "7 5/8", "7 3/4", "8 5/8", "9 5/8", "10 3/4", "11 3/4", "13 3/8", "16", "18 5/8", "20"] | Casing outside diameters. |
tubulars.tubingSizes | list | ["1.050", "1.315", "1.660", "1.900", "2 3/8", "2 7/8", "3 1/2", "4", "4 1/2"] | Tubing outside diameters. |
tubulars.grades | list | ["H40", "J55", "K55", "N80", "N80-1", "N80Q", "L80", "L80-1", "L80-9Cr", "L80-13Cr", "C90", "R95", "T95", "C110", "P110", "Q125"] | Steel grades / strength groups. |
tubulars.connections | list | ["STC", "LTC", "BTC", "NUE", "EUE", "Premium"] | Connection types. |
tubulars.notes | string | null | Notes (edition followed, other standards in use). |
region - The country or region the environment is for. | |||
region.wellIdentifiers | list | [] | Well identifier formats of the country; a well's identifier must match one (WI001). Empty: not checked. |
region.coordinateSystems | list | [] | Coordinate systems commonly used in the country (information; confirm with your survey department). |
region.country | string | null | ISO 3166 two-letter country code (for example US, RU, NO). |
region.name | string | null | Country or region name. |
region.regulators | list | [] | Regulators and standards commonly referred to there (information). |
region.notes | string | null | Notes on the preset (what is typical practice and should be confirmed). |
files - Reading text files: legacy code page. | |||
files.legacyEncoding | string | "windows-1252" | Code page for text files that are neither marked (BOM) nor valid UTF-8: windows-1252, windows-1251, cp866, gbk, shift_jis, windows-1256... |
files.encodingAliases | map | {"cp1251": "windows-1251", "cp1252": "windows-1252", "cp1256": "windows-1256", "utf8": "utf-8", "latin1": "iso-8859-1", "sjis": "shift_jis"} | Other names for encodings (cp1251 -> windows-1251...). |
equipment - Equipment attribute rules and completion tally columns. | |||
equipment.attributes | map | {"*": [{"key": "manufacturer", "label": "Manufacturer", "kind": "text", "unit": null, "required": false, "choices": null, "min": null, "m… | Attribute rules by component type ("*" = all types, "PACKER_*" = prefix). |
equipment.programColumns | list | [{"key": "no", "header": "#"}, {"key": "name", "header": "String"}, {"key": "top", "header": "Top"}, {"key": "bottom", "header": "Bottom"… | Casing and tubing program columns, in order. |
equipment.programExcludedSymbols | list | ["str_control_line"] | String symbols left out of the casing and tubing program. |
equipment.tallyColumns | list | [{"key": "no", "header": "#"}, {"key": "name", "header": "Component"}, {"key": "type", "header": "Type"}, {"key": "top", "header": "Top"}… | Completion tally columns, in order. |
branding - Trademark footnote and logo on exports, prints and views. | |||
branding.footnote | string | "The Tech Idea™" | Trademark footnote on every export, print and view. |
branding.logoFile | string | null | Logo file drawn before the footnote (PNG or JPEG, relative to the environment file); null = the built-in The Tech Idea logo. |
branding.showLogo | bool | true | Draw a logo before the footnote. |
branding.showInExports | bool | true | Show the footnote in PDF / SVG / PNG exports and prints. |
branding.showOnScreen | bool | true | Show the footnote in the corner of interactive views. |
resources - External files overriding built-in resources (paths relative to this file). | |||
resources.lithologyFile | string | null | Lithology library JSON (replaces the built-in library). |
resources.lithologyStandards | list | [] | National lithology standards layered on the library: GOST 21.302-2013 (built in) or a standard JSON file; FGDC is built into the library. |
resources.toolModelFiles | list | [] | Survey tool error models as ISCWSA error-model JSON files; they join survey.toolModels by model name. |
resources.standardLexicons | list | ["ICS"] | Published stratigraphic standards layered under the lexicon files (built in: ICS); empty: none. |
resources.symbolCatalogFile | string | null | Symbol catalog JSON (replaces the built-in catalog). |
resources.componentSymbolsFile | string | null | Component type -> symbol JSON (same format as the built-in component-symbols.json). |
resources.geomagneticModelFile | string | null | Geomagnetic model coefficient file in NOAA .COF format; none: the embedded WMM2025. |
resources.barrierTemplateFiles | list | [] | Barrier template files merged over the built-in templates by name. |
resources.leakPathFiles | list | [] | Leak-path network files merged over the built-in networks by name (their selection rules first). |
resources.modelCatalogFiles | list | [] | Model catalog files (component, barrier element and fluid contact types) merged over the built-in catalog by code. |
resources.countryFolders | list | [] | Folders with company country environments (<CODE>.json); "country:XX" looks here before the built-in countries. |
resources.vocabularyFiles | list | [] | Code vocabulary files (source codes -> canonical), first match wins. |
resources.lexiconFiles | list | [] | Stratigraphic lexicon files (local layer names -> canonical units). |
resources.labelFiles | list | [] | UI label files (per culture / company). |
resources.mappingProfilesFolder | string | null | Folder searched for data-source mapping profiles (<name>.profile.json) before the built-in ones. |