pyTMD icon indicating copy to clipboard operation
pyTMD copied to clipboard

Enhancement idea: documentation around advanced `pyTMD.compute` params

Open robbibt opened this issue 3 months ago • 1 comments

I've been seeing some great new functionality added to pyTMD recently, particularly around the following pyTMD.compute.* params:

        CORRECTIONS: str | None = None,
        INFER_MINOR: bool = True,
        MINOR_CONSTITUENTS: list | None = None,
        APPEND_NODE: bool = False,
        APPLY_FLEXURE: bool = False,

However, as someone without a tide science backgorund, I don't have a great understanding of what these features do, and so am unsure of whether I should be simply using the defaults or turn on any of these features to improve the accuracy of my tide modelling.

It would be fantastic to have a page in the docs that describes these features, and provides some guidance on the advantages/limitations/reasons for using each of them for different applications. For example, important things to consider or keep in mind so that users can make an informed decision based on their use case. 🙂 I could imagine this perhaps living somethere like this:

https://pytmd.readthedocs.io/en/latest/getting_started/Getting-Started.html#programs https://pytmd.readthedocs.io/en/latest/getting_started/Background.html

robbibt avatar Oct 29 '24 23:10 robbibt