Configuration
All customer-adjustable values live in one model, WellboreEnvironment, loadable from JSON per customer, country or tenant.
What is configurable - and what is not
Configurable: units, standards references, engineering thresholds and criteria, classification rules, colours and styles, print, live, correlation and conversion defaults, and paths to your own lexicons, vocabularies, labels, symbol maps and mapping profiles.
Not configurable, by design: physical constants and unit definitions (0.3048 m/ft, 0.052 psi/ft per ppg, the US survey foot), algorithm internals (iteration counts, tolerances) and pure drawing geometry. A typo in a JSON file must never change physics.
The file
- Only list what differs from the defaults; missing keys keep them.
- Comments (
//) and trailing commas are allowed. - Measurements carry their unit:
{ "value": 10, "unit": "ft" }; gradients acceptpsi/ftorkPa/m. - Unknown keys are reported with their path (
cement.goodBondIndx) instead of being silently ignored. Validate()checks ranges and consistency (for example good bond index above poor, gas/oil boundary below oil/water).- Relative resource paths resolve against the environment file's folder.
Downloads: template with every key - JSON Schema - samples.
Loading and scoping
// Desktop / single customer
WellboreServices.Global = WellboreServices.Load(path);
// Server: per request / tenant
using (WellboreServices.Scope(servicesOfThisCustomer)) { ... }
// Tests: temporary overrides
using (WellboreServices.Scope(WellboreEnvironment.FromJson(@"{ ""barriers"": { ""requiredBarriers"": 3 } }"))) { ... }
WellboreServices.Warnings lists unknown keys, invalid values and missing resource files. Nothing throws for a bad file
except a schema version newer than the library supports.
When values are read
- Thresholds used in calculations (fluid typing, gas ratios, deratings, leak-path counting, validation limits) are read when the calculation runs, so switching scope changes results immediately.
- Object defaults (a new track's settings, conversion options, print options) are read when the object is created and remain normal properties.
Company base and overlays (extends)
An environment can extend one or more base files - typically a company base, then a country or asset overlay:
{ "extends": "../../company/company.environment.json", "units": { "depthUnit": "m" }, "cement": { "goodBondIndex": 0.75 } }
- Later files win; objects (sections and maps such as
styles.contactColors) merge key by key; lists (logs.families) replace. - Map entries also merge onto the built-in defaults, so overriding one contact colour keeps the others.
- Relative resource paths in a base file stay relative to that file, so a shared company lexicon works from every overlay.
- Missing bases and cycles are warnings, never failures.
WellboreEnvironment.SourceOf("cement.goodBondIndex")(andProvenance) tells which file - or preset, or the default - supplied each value.
Theme presets
theme.preset: light (default), dark, print or highContrast. Explicit theme keys still win over the preset.
Validate() flags text / background contrast below 4.5:1 (WCAG AA); the highContrast preset reaches at least 7:1.
Checking resource files
Lexicons, vocabularies and labels are checked when they load; problems are listed in WellboreServices.Issues (with the file)
and in Warnings, with the WR codes of the validation catalog. A lexicon name claimed by two
units is reported and resolves to the first one - it is never overwritten silently.
wellbore-config (command line)
wellbore-config validate acme-kw.environment.json # exit 0 clean, 1 warnings, 2 errors - use it in CI
wellbore-config show acme-kw.environment.json cement # effective values with their source
wellbore-config diff ncs.environment.json kw.environment.json
wellbore-config template environment.template.json
wellbore-config schema environment.schema.json
wellbore-config save environment.json saved-configuration
wellbore-config verify acme-kw.environment.json # reference cases and cross-checks - use it in CI
wellbore-config where # where every configuration, sample and generator is, and the command that writes each
wellbore-config samples kuwait.environment.sample.json kw.json # a sample, a mapping profile or a country environment, as a file
wellbore-config samples --all starter # everything, in the layout of the published downloads
Install from the repository (tools/config-cli) or as the TheTechIdea.OilGas.ConfigTool .NET tool.
Finding the configuration resources from code
ConfigurationResources (TheTechIdea.OilGas.Wellbore.Loaders) is the one place that knows where each configuration resource is - the environment template and schema, the country environments, the samples and the built-in mapping profiles - and is what where and samples print and write. ConfigurationResources.All
lists them; each ConfigurationResource has a Name (a file name, country:KW, profile:csv), a Kind, a Description, what holds it (Where), the command that writes it, its path in the source repository (SourceTreePath) and in the published site (DocsPath), and Read(). Find(name) takes any of
those names, a bare country code or a bare profile name; Export(folder) writes them in the layout of the published downloads and refuses to overwrite unless told to; Describe(folder) is the text of wellbore-config where, and says which parts of a source checkout are missing. The samples are embedded in the library,
so they reach a host that has no source tree. A test keeps the catalogue equal to the files: a sample that is not embedded and described, a path that has moved, or a download that was not published fails it.
Recipes
Each recipe is backed by a test that keeps it working.
| Recipe | How | Proven by |
|---|---|---|
| Company base + country overlay | extends the company file; list only what the country changes |
Phase1Tests.Inheritance_OverlayWinsMapsMergeListsReplacePathsRebase |
| Country layer names | a lexicon in resources.lexiconFiles, culture for display names |
MappingTests.Tops_ResolveToUnitsAndShowTheCultureName |
| Your PPDM flavour | <name>.profile.json in resources.mappingProfilesFolder |
MappingTests.Profiles_EnvironmentFolderBeforeBuiltIn |
| SI units | units.depthUnit: "m", units.pressureUnit: "bar" |
Phase0Tests.Pressures_DisplayInTheEnvironmentUnit |
| Company wording | a labels file in resources.labelFiles |
Phase0Tests.Labels_ChangeWhatUsersSee |
| Dark or high-contrast screens | theme.preset |
Phase1Tests.ThemePresets_ApplyUnderExplicitKeysAndMeetContrast |
Contracts a host can replace
WellboreServices holds every service behind a contract: Vocabulary (ICodeVocabulary), Lexicon (IStratigraphicLexicon),
Symbols (ISymbolResolver), Curves (ICurveClassifier), Labels (ILabelProvider), UnitCatalog (IUnitCatalog),
Countries (ICountryCatalog) and ModelCatalog (IModelCatalog: component, barrier element and fluid contact types). Defaults come from the environment and the built-in data; set any of them to take that part
from your own system (for example units from a company database), for the whole process (WellboreServices.Global) or one
request (WellboreServices.Scope). The static helpers - Units.Convert, CountryPresets - go through the current services,
so existing code follows. An environment is always validated against its own definitions.
using (WellboreServices.Scope(new WellboreServices(environment) { UnitCatalog = myUnits, Countries = myCountries }))
{
var ok = Units.Convert(1, "furlong", "m"); // resolved by myUnits
}
Deterministic runs
Every new record id and every time stamp (audit entries, provenance, annotations, print date) comes from the services:
Ids (IIdGenerator, default random GUIDs) and Clock (IClock, default the system clock). For tests, reproducible
reports or lockstep hosts, set deterministic ones - the same inputs then give the same bytes:
var services = new WellboreServices(environment)
{
Ids = new SequentialIdGenerator("w"), // w000001, w000002...
Clock = new FixedClock(new DateTime(2026, 1, 1, 0, 0, 0, DateTimeKind.Utc))
};
using (WellboreServices.Scope(services)) { /* load, convert, build barrier sets... */ }
Barrier element ids are derived from their envelope, type and target (Primary-CASING_CEMENT-PROD), so building the same
set twice gives the same ids with any generator; documents saved with the earlier random ids still load.
Load and save: IJsonPersistable
Every configurable part reads JSON (FromJson) and saves it (ToJson, the IJsonPersistable contract): the environment,
symbol catalogue, lithology library, component-symbol map, mapping profiles, labels, vocabularies, lexicons, well models and
views. Load -> save -> load gives the same part; fields a part does not interpret (for example extra keys in a company symbol
catalogue) are kept. A test fails when a public type can load JSON but not save it.
Printing: templates, footer, footnote
WellborePrintOptions.FromTemplate("a3-log") builds print options from printing.templates (defaults, then what the
template sets); TemplateNames lists them. Footer texts expand tokens with PrintTokens.Expand. PanelExport.ToPdf prints
correlation panels (exact scale, CorrelationPages gives the depth windows) and cross-sections. Branding draws the
trademark footnote (branding section) on every export page and - through ViewSurface.Draw - in the corner of every view.
UI labels
Texts shown to users go through ILabelProvider (UiText.Get(key, fallback)); list files in resources.labelFiles
({ "culture": "nb-NO", "labels": { "track.depth": "Dybde" } }). Keys without an entry keep the built-in text below.
Validation messages are not labels: they carry stable codes (see Validation codes).
| 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 |
Full reference
| 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. |