Skip to content

Add missing docstrings#955

Merged
florian-wagner merged 7 commits intodevfrom
add_missing_docstrings
Mar 23, 2026
Merged

Add missing docstrings#955
florian-wagner merged 7 commits intodevfrom
add_missing_docstrings

Conversation

@florian-wagner
Copy link
Copy Markdown
Member

Hi @carsten-forty2,

@halbmy and me asked Claude to document functions without a docstring and document missing keywords in existing docstrings + remove some Sphinx warnings. It looks quite good at first sight. Can you also check, please? You know some functions much better.

Thanks and best wishes
Florian

florian-wagner and others added 4 commits March 18, 2026 15:31
Added NumPy-style docstrings to 100+ functions across 23 files that
had none. Key areas covered:

- core/logger.py: all public logging helpers (info, warn, error,
  critical, debug, verbose, setVerbose, setDebug, deprecated,
  renameKwarg, warnNonEmptyArgs, whereAmI, _msg, _get_class_from_frame)
- core/datacontainer.py: DataContainer monkey-patched methods
- math/matrix.py: ScaledMatrix, TransposedMatrix, Squared*Matrix,
  MultMatrix family, RealNumpyMatrix, NDMatrix __init__ methods and
  property accessors
- frameworks/inversion.py: ClassicInversion, MarquardtInversion,
  Block1DInversion, LBFGSInversion, LCInversion __init__ methods
- frameworks/modelling.py: MeshModelling.__init__
- physics/ert/ertScheme.py: DataSchemeBase and all seven concrete
  scheme subclasses (PolePole, DipoleDipole, PoleDipole, HalfWenner,
  WennerAlpha, WennerBeta, Schlumberger, MultipleGradient)
- physics/ert/ertModelling.py: ERTModelling, ERTModellingReference
- physics/SIP/siptools.py: DebyeModelling, DoubleColeColeModelling
- physics/SIP/models.py: ColeColeAbs
- physics/gravimetry/MagneticsModelling.py: RemanentMagneticsModelling
- physics/traveltime/modelling.py: TravelTimeDijkstraModelling and
  both FatrayDijkstra variants
- physics/em/tdem.py: TDEMSmoothModelling
- physics/sNMR/mrsprofile.py: MultiFOP
- utils/sparseMat2Numpy.py: toCSR, toCOO aliases
- utils/gps.py: _getXMLData
- viewer/mpl/meshview.py, overlayimage.py: singleton cache methods
- viewer/pv/pyqt/gwidgets/utils.py: GToolBar, GButton, GLineEdit,
  GComboBox, GSlider, GDoubleSpinBox, _GDoubleSlider methods
- viewer/pv/pyqt/show3d.py: showHotKeys, setupWidget, _enableSlicers,
  _allowSignals, _checkStatusPlaneSlice, _checkStatusVolumeSlice

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@florian-wagner florian-wagner merged commit 23e6544 into dev Mar 23, 2026
@florian-wagner florian-wagner deleted the add_missing_docstrings branch March 23, 2026 12:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant