From 1e380d0a034c633d39df384ddab380f79ea2f279 Mon Sep 17 00:00:00 2001
From: Magne Sjaastad <magne.sjaastad@ceetronsolutions.com>
Date: Sat, 24 Oct 2026 13:51:32 +0200
Subject: [PATCH] #15021: Document units of well diameter, radius and width

---
 .../ProjectDataModel/Completions/RimEllipseFractureTemplate.h | 3 ++-
 ApplicationLibCode/ProjectDataModel/Completions/RimFracture.h | 4 ++--
 .../ProjectDataModel/Completions/RimFractureTemplate.h        | 4 ++--
 .../Completions/RimNonDarcyPerforationParameters.h            | 4 ++--
 4 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/ApplicationLibCode/ProjectDataModel/Completions/RimEllipseFractureTemplate.h b/ApplicationLibCode/ProjectDataModel/Completions/RimEllipseFractureTemplate.h
index 5c0cf99424..47f4556a39 100644
--- a/ApplicationLibCode/ProjectDataModel/Completions/RimEllipseFractureTemplate.h
+++ b/ApplicationLibCode/ProjectDataModel/Completions/RimEllipseFractureTemplate.h
@@ -58,6 +58,7 @@ public:
 
     double halfLength() const;
     double height() const;
+    // Width in template units: [m] for metric, [inches] for field
     double width() const;
 
     double computeLegacyWellDepthAtFracture() const;
@@ -89,6 +90,6 @@ private:
 private:
     caf::PdmField<double> m_halfLength;
     caf::PdmField<double> m_height;
-    caf::PdmField<double> m_width;
+    caf::PdmField<double> m_width; // [m] for metric, [inches] for field
     caf::PdmField<double> m_permeability;
 };
diff --git a/ApplicationLibCode/ProjectDataModel/Completions/RimFracture.h b/ApplicationLibCode/ProjectDataModel/Completions/RimFracture.h
index b09b9ad0ec..d821abd5d5 100644
--- a/ApplicationLibCode/ProjectDataModel/Completions/RimFracture.h
+++ b/ApplicationLibCode/ProjectDataModel/Completions/RimFracture.h
@@ -84,7 +84,7 @@ public:
 
     void setStimPlanTimeIndexToPlot( int timeIndex );
 
-    double                        wellRadius() const;
+    double                        wellRadius() const; // [m] for metric, [ft] for field (converted from inches)
     cvf::Vec3d                    anchorPosition() const;
     void                          setAnchorPosition( const cvf::Vec3d& pos );
     RiaDefines::EclipseUnitSystem fractureUnit() const;
@@ -178,7 +178,7 @@ protected:
     caf::PdmField<double> m_azimuth;
     caf::PdmField<double> m_perforationLength;
     caf::PdmField<double> m_perforationEfficiency;
-    caf::PdmField<double> m_wellDiameter;
+    caf::PdmField<double> m_wellDiameter; // [m] for metric, [inches] for field
     caf::PdmField<int>    m_stimPlanTimeIndexToPlot;
 
 private:
diff --git a/ApplicationLibCode/ProjectDataModel/Completions/RimFractureTemplate.h b/ApplicationLibCode/ProjectDataModel/Completions/RimFractureTemplate.h
index ee4e2517fa..efbcbf1d74 100644
--- a/ApplicationLibCode/ProjectDataModel/Completions/RimFractureTemplate.h
+++ b/ApplicationLibCode/ProjectDataModel/Completions/RimFractureTemplate.h
@@ -136,7 +136,7 @@ public:
     FracOrientationEnum                         orientationType() const;
     float                                       azimuthAngle() const;
     float                                       skinFactor() const;
-    double                                      wellDiameter() const;
+    double                                      wellDiameter() const; // [m] for metric, [inches] for field
     FracConductivityEnum                        conductivityType() const;
     double                                      perforationLength() const;
     bool                                        useUserDefinedPerforationLength() const;
@@ -218,7 +218,7 @@ protected:
     caf::PdmField<bool>                                        m_userDefinedPerforationLength;
     caf::PdmField<double>                                      m_perforationLength;
     caf::PdmField<double>                                      m_perforationEfficiency;
-    caf::PdmField<double>                                      m_wellDiameter;
+    caf::PdmField<double>                                      m_wellDiameter; // [m] for metric, [inches] for field
     caf::PdmField<caf::AppEnum<FracConductivityEnum>>          m_conductivityType;
     caf::PdmChildField<RimFractureContainment*>                m_fractureContainment;
 
diff --git a/ApplicationLibCode/ProjectDataModel/Completions/RimNonDarcyPerforationParameters.h b/ApplicationLibCode/ProjectDataModel/Completions/RimNonDarcyPerforationParameters.h
index ef7e46335c..e85d8c63e7 100644
--- a/ApplicationLibCode/ProjectDataModel/Completions/RimNonDarcyPerforationParameters.h
+++ b/ApplicationLibCode/ProjectDataModel/Completions/RimNonDarcyPerforationParameters.h
@@ -39,7 +39,7 @@ public:
     NonDarcyFlowEnum nonDarcyFlowType() const;
     double           userDefinedDFactor() const;
     double           gridPermeabilityScalingFactor() const;
-    double           wellRadius() const;
+    double           wellRadius() const; // [m] in all unit systems
     double           relativeGasDensity() const;
     double           gasViscosity() const;
     double           inertialCoefficientBeta0() const;
@@ -55,7 +55,7 @@ private:
     caf::PdmField<double>                         m_userDefinedDFactor;
 
     caf::PdmField<double> m_gridPermeabilityScalingFactor;
-    caf::PdmField<double> m_wellRadius;
+    caf::PdmField<double> m_wellRadius; // [m] in all unit systems
     caf::PdmField<double> m_relativeGasDensity;
     caf::PdmField<double> m_gasViscosity;