pytroll / pyresample

Geospatial image resampling in Python
http://pyresample.readthedocs.org
GNU Lesser General Public License v3.0
347 stars 94 forks source link

dunder methods missing from readthedocs API #394

Open gerritholl opened 2 years ago

gerritholl commented 2 years ago

The AreaDefinition methods support several special methods, for which documentation is missing on readthedocs. The most relevant ones for the user are __contains__, __eq__, and __getitem__.

I think there's a sphinx setting to control whether those are generated with API docs or not.

Problem description

Most users get their documentation from readthedocs. From the API documentation, one wouldn't it's possible (or should be) to check if a certain lat/lon is contained inside an area definition, despite this feature being potentially quite useful.

Versions of Python, package at hand and relevant dependencies

Current pyresample / online docs.

djhoese commented 2 years ago

https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#directive-option-automodule-special-members