# edirnandi/petrophysical-qc architecture

> Architecture diagram of the GitHub repository edirnandi/petrophysical-qc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/edirnandi/petrophysical-qc
- Repository: https://github.com/edirnandi/petrophysical-qc

## Overview

This repository is a collection of standalone petrophysical well-log utilities, not a single application with a shared runtime pipeline. Its workflows cover LAS conversion, validation and cleanup; DLIS validation and header extraction; log digitization and analysis; and well-survey geometry. Users generally run a script for a particular task, often selecting files through a dialog, then receive a report or transformed dataset. The README provides no architectural detail, and several listed utilities were not sampled, so their internal connections are not inferred.

Main entry points: [`ascii2las.py`](https://github.com/edirnandi/petrophysical-qc/blob/main/ascii2las.py) (ASCII Conversion), [`LASCheck-free.py`](https://github.com/edirnandi/petrophysical-qc/blob/main/LASCheck-free.py) (LAS Validation), [`LASCheck-v2-free.py`](https://github.com/edirnandi/petrophysical-qc/blob/main/LASCheck-v2-free.py) (LAS Validation v2), [`DLISCheck-free.py`](https://github.com/edirnandi/petrophysical-qc/blob/main/DLISCheck-free.py) (DLIS Validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_las["LAS Utilities"]
  node_ascii_convert["ASCII Conversion<br/>[ascii2las.py]"]
  node_las_validate_basic["LAS Validation<br/>[LASCheck-free.py]"]
  node_las_validate_full["LAS Validation v2"]
  node_las_header["Header Extraction"]
  node_null_replace["Null Replacement<br/>[ReplaceLASNull.py]"]
end

subgraph group_dlis["DLIS Utilities"]
  node_dlis_validate["DLIS Validation<br/>[DLISCheck-free.py]"]
  node_dlis_export["Header Export"]
end

subgraph group_analysis["Log Analysis"]
  node_digitize["Raster Digitization"]
  node_spike_detect["Spike Detection"]
  node_rock_typing["Rock Typing"]
  node_sonic_predict["Sonic Prediction"]
  node_porosity_predict["Porosity Prediction"]
  node_decline_analysis["Rate Decline Analysis"]
end

subgraph group_survey["Survey Geometry"]
  node_survey_calc["Survey Positioning"]
  node_survey_calc_v2["Survey Positioning v2"]
end

node_user(("User"))

node_user -->|"selects data"| node_ascii_convert
node_user -->|"selects files"| node_las_validate_basic
node_user -->|"selects files"| node_las_validate_full
node_user -->|"selects folder"| node_dlis_validate
node_user -->|"selects files"| node_dlis_export
node_user -->|"calibrates image"| node_digitize
node_user -->|"selects wells"| node_rock_typing
node_user -->|"selects survey"| node_survey_calc
node_user -->|"selects survey"| node_survey_calc_v2

click node_ascii_convert "https://github.com/edirnandi/petrophysical-qc/blob/main/ascii2las.py"
click node_las_validate_basic "https://github.com/edirnandi/petrophysical-qc/blob/main/LASCheck-free.py"
click node_las_validate_full "https://github.com/edirnandi/petrophysical-qc/blob/main/LASCheck-v2-free.py"
click node_las_header "https://github.com/edirnandi/petrophysical-qc/blob/main/LASExtract_header.py"
click node_null_replace "https://github.com/edirnandi/petrophysical-qc/blob/main/ReplaceLASNull.py"
click node_dlis_validate "https://github.com/edirnandi/petrophysical-qc/blob/main/DLISCheck-free.py"
click node_dlis_export "https://github.com/edirnandi/petrophysical-qc/blob/main/dlis_header_to_excel.py"
click node_digitize "https://github.com/edirnandi/petrophysical-qc/blob/main/digitize_log_dynamic_cv.py"
click node_spike_detect "https://github.com/edirnandi/petrophysical-qc/blob/main/LogsSpikeDetection_IsoForest.py"
click node_rock_typing "https://github.com/edirnandi/petrophysical-qc/blob/main/MultiWell_RockTyping_using_logs.py"
click node_sonic_predict "https://github.com/edirnandi/petrophysical-qc/blob/main/generate_SonicDT_log_x-val.py"
click node_porosity_predict "https://github.com/edirnandi/petrophysical-qc/blob/main/porosity_prediction.py"
click node_decline_analysis "https://github.com/edirnandi/petrophysical-qc/blob/main/Python-code-sample-for-Oil-rate-decline-analysis_RandomForestRegressor2.py"
click node_survey_calc "https://github.com/edirnandi/petrophysical-qc/blob/main/WellPosition-calc.py"
click node_survey_calc_v2 "https://github.com/edirnandi/petrophysical-qc/blob/main/WellPosition-calc_v2.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ascii_convert,node_las_validate_basic,node_las_validate_full,node_las_header,node_null_replace,node_user toneBlue
class node_dlis_validate,node_dlis_export toneAmber
class node_digitize,node_spike_detect,node_rock_typing,node_sonic_predict,node_porosity_predict,node_decline_analysis toneMint
class node_survey_calc,node_survey_calc_v2 toneRose
```

## Components

### LAS Utilities

- [ASCII Conversion](https://github.com/edirnandi/petrophysical-qc/blob/main/ascii2las.py): `ascii2las.py`
- [LAS Validation](https://github.com/edirnandi/petrophysical-qc/blob/main/LASCheck-free.py): `LASCheck-free.py`
- [LAS Validation v2](https://github.com/edirnandi/petrophysical-qc/blob/main/LASCheck-v2-free.py): `LASCheck-v2-free.py`
- [Header Extraction](https://github.com/edirnandi/petrophysical-qc/blob/main/LASExtract_header.py): `LASExtract_header.py`
- [Null Replacement](https://github.com/edirnandi/petrophysical-qc/blob/main/ReplaceLASNull.py): `ReplaceLASNull.py`

### DLIS Utilities

- [DLIS Validation](https://github.com/edirnandi/petrophysical-qc/blob/main/DLISCheck-free.py): `DLISCheck-free.py`
- [Header Export](https://github.com/edirnandi/petrophysical-qc/blob/main/dlis_header_to_excel.py): `dlis_header_to_excel.py`

### Log Analysis

- [Raster Digitization](https://github.com/edirnandi/petrophysical-qc/blob/main/digitize_log_dynamic_cv.py): `digitize_log_dynamic_cv.py`
- [Spike Detection](https://github.com/edirnandi/petrophysical-qc/blob/main/LogsSpikeDetection_IsoForest.py): `LogsSpikeDetection_IsoForest.py`
- [Rock Typing](https://github.com/edirnandi/petrophysical-qc/blob/main/MultiWell_RockTyping_using_logs.py): `MultiWell_RockTyping_using_logs.py`
- [Sonic Prediction](https://github.com/edirnandi/petrophysical-qc/blob/main/generate_SonicDT_log_x-val.py): `generate_SonicDT_log_x-val.py`
- [Porosity Prediction](https://github.com/edirnandi/petrophysical-qc/blob/main/porosity_prediction.py): `porosity_prediction.py`
- [Rate Decline Analysis](https://github.com/edirnandi/petrophysical-qc/blob/main/Python-code-sample-for-Oil-rate-decline-analysis_RandomForestRegressor2.py): `Python-code-sample-for-Oil-rate-decline-analysis_RandomForestRegressor2.py`

### Survey Geometry

- [Survey Positioning](https://github.com/edirnandi/petrophysical-qc/blob/main/WellPosition-calc.py): `WellPosition-calc.py`
- [Survey Positioning v2](https://github.com/edirnandi/petrophysical-qc/blob/main/WellPosition-calc_v2.py): `WellPosition-calc_v2.py`

### Other components

- **User**

## Connections

- User → ASCII Conversion: selects data (evidence: `ascii2las.py`)
- User → LAS Validation: selects files (evidence: `LASCheck-free.py`)
- User → LAS Validation v2: selects files (evidence: `LASCheck-v2-free.py`)
- User → DLIS Validation: selects folder (evidence: `DLISCheck-free.py`)
- User → Header Export: selects files (evidence: `dlis_header_to_excel.py`)
- User → Raster Digitization: calibrates image (evidence: `digitize_log_dynamic_cv.py`)
- User → Rock Typing: selects wells (evidence: `MultiWell_RockTyping_using_logs.py`)
- User → Survey Positioning: selects survey (evidence: `WellPosition-calc.py`)
- User → Survey Positioning v2: selects survey (evidence: `WellPosition-calc_v2.py`)
