Confusing docs for pvlib.clearsky.ineichen and lookup_linke_turbidity

[williamhobbs]

When I read this line in pvlib.clearsky.ineichen docs

pvlib-python/pvlib/clearsky.py

Line 31 in 6b9476b

Default values for monthly Linke turbidity provided by SoDa [4]_, [5]_.

it made me think that default Linke turbidity values from SoDa are included in pvlib.clearsky.ineichen, but they are not. Perhaps it should read something like

Default values for monthly Linke turbidity available in :py:class:`~pvlib.clearsky.lookup_linke_turbidity` are provided by SoDa [4]_, [5]_.

Related, the docs for lookup_linke_turbidity don't include a description/reference for where the data came from (I assume it was SoDa, references 4 and 5 in ineichen...).

[cwhanse]

That docstring could use an example showing that getting to clearsky is a two-step procedure (lookup_linke_turbidity then ineichen) unless one brings their own turbidity data.

[Rahi-padwal]

Hello @williamhobbs !
Is this issue still open, or is someone already working on it? If it’s available, I’d be happy to help.

[williamhobbs]

@Rahi-padwal, I am not working on it, so it's fine with me if you want to start. Thanks.

[kumaradityaapril]

I am able to work on this problem. My intention is to:

• Make it clear that SoDa turbidity values are accessed via lookup_linke_turbidity by rewording the ineichen docstring.
• To lookup_linke_turbidity, add a brief description of the data source (SoDa).
• Include a brief illustration of the two-step process (lookup_linke_turbidity → ineichen).

This will only be used for documentation.