LinkedEarth / Pyleoclim_util

Python Package for the Analysis of Paleoclimate Data. Documentation at
https://pyleoclim-util.readthedocs.io
GNU General Public License v3.0
84 stars 32 forks source link

Documentation glitches #389

Closed CommonClimate closed 1 year ago

CommonClimate commented 1 year ago

Describe the bug Lots of figures don't appear correctly. Most compound figures need fig.tight_layout() so the edges appear correctly. In addition, we need to fix:

CommonClimate commented 1 year ago

390 addresses the ensemble series plot_envelope() problem

khider commented 1 year ago

Sorry to re-open this, but we should probably change the front page saying that Pyleoclim natively speaks LiPD. Won't be true very soon and we do need to start moving people away from these two classes.

Pyleoclim natively “speaks” the language of Linked Paleo Data (LiPD), which enables it to handle most of the data transformations internally, taking a good chunk of the pain out of analyzing paleoclimate data. The package is aware of age ensembles stored via LiPD and uses them for time-uncertain analysis. Age ensembles can be generated through the GeoChronR package, which natively stores them as ensemble tables in LiPD.

While convenient for the representation of paleoclimate observations, LiPD is not the only point of entry into Pyleoclim. The Series class is very flexible, and allows to apply Pyleoclim functionality to virtually any timeseries, including instrumental or model-generated data, as Excel spreadsheets, numpy arrays or pandas dataframes. Indeed, Pyleoclim is the workhorse supporting more general machine-learning functionalities for all manner of timeseries.

CommonClimate commented 1 year ago

What phrasing would gain your approval?

khider commented 1 year ago

That the Series and GeoSeries class are very flexible and allows to apply Pyleoclim functionality to virtually any timeseries, including instrumental or model-generated data, as Excel spreadsheets, numpy arrays or pandas dataframes. It is also capable of working with datasets stored in the LiPD format, through the PyLiPD package.

CommonClimate commented 1 year ago

Good point, which also be echoed in this repo's ReadMe. I suggest moving this to a separate issue and letting this one rest in peace.