Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation #85

Merged
merged 171 commits into from
Mar 5, 2024
Merged

Documentation #85

merged 171 commits into from
Mar 5, 2024

Conversation

philipparubin
Copy link
Contributor

@philipparubin philipparubin commented Feb 28, 2024

Sphinx Documentation

Pages added (from home page)

  1. "Getting started"
    • "RoughPy: the absolute basics for beginners". Anagrams example.
  2. "User guide"
    • "Getting started"
      • "What is RoughPy?". Short introduction. Signatures of Streams clip. References.
      • "Installation". Basic installation with pip. Links to wheels, and building from source.
      • "RoughPy: the absolute basics for beginners". Anagrams example.
    • "Fundamentals and usage"
      • "RoughPy Fundamentals". All the following pages are of the form: What are X? How do X fit into RoughPy? How to work with X, with example constructors and functions. Literature references using X.
        • "Contexts".
        • "Streams"
        • "Intervals"
        • "Free Tensors"
        • "Shuffle Tensors"
        • "Lies"
      • "RoughPy Tutorials". Notebooks generated from here.
        • "Logsignature example"
        • "Controlled Neural Differential Equations - Time Series Classification"
        • "Path Signatures for Drone Classification using esig"
        • "Path Signautre Methodology for Landmark-based Human Action Recognition"
        • "Path Signatures for Handwritten Digit Classification Using Esig"
        • "Path Signatures for Natural Language Processing"
        • "Path Signatures for Early Sepsis Detection"
    • "Advanced usage"
      • "Building from source". Installation with vcpkg.
      • "Literature references". A list of references for using signature methods. Different to the literature references in bibiography, on each of the fundamentals pages.
  3. "API reference"
    • Autogenerated API reference using autodoc
  4. "Contributor's guide"
    • Note on contributing to RoughPy. Current status, "In the future, we will welcome pull requests to implement new features, fix bugs, add documentation or examples, or add tests to the project. However, at present, we do not have robust CI pipelines set up to rigorously test incoming changes, and therefore will not be accepting pull requests made from outside the current team."

Also has "Release notes", "Source Repository" and "Issue Tracker" from home page.

Notes

  • You have to use CMake to build the "Sphinx" target, introduced when tidying the notebooks
  • Videos and other files are stored using git-lfs

inakleinbottle and others added 30 commits August 18, 2023 14:15
* Added serialize method to StreamInterface and DynamicallyConstructedStream

* Sound path serialization

* Implemented serialization for the path type

* Serialization for SoundFileDatSource

* Added loading/dumping to stream chache files.

* removed file locks until I can figure out how they work

* Added cache-id function

* reformatting.

* removed print

* Added serialization methods to interval types.

* Added instantiations for the interval types.

* Added equality function for partitions

* Added tests for serialziation

* pickle support for dyadic

* Pickle support for interval types

* pickle support for partitions

* picke functions for algebra types

* typo

* test for lie pickle

* Pickle for free tensor types tests

* Added a default constructor.

* nominal pickle support for streams.

* Implementation of pickle not quit right for streams. Continue the research

* Fixed initialisation of effective domain

* Added __new__ to Stream type and modified pickle method

* Couple of changes to style.

* added tp_finalize to be safe

* Added methods to monomial for pickling

* added new macros for external library types

* added serialization for all the scalar types

* Fixed implementations detached from declaration

* added instantiations of the archive types

* Added serialization for enum types

* Add the specialization for polynomials

* Special load/save functions for JSON output.

* Added serialize method to StreamInterface and DynamicallyConstructedStream

* Sound path serialization

* Implemented serialization for the path type

* Serialization for SoundFileDatSource

* Added loading/dumping to stream chache files.

* removed file locks until I can figure out how they work

* Added cache-id function

* reformatting.

* removed print

* Added serialization methods to interval types.

* Added instantiations for the interval types.

* Added equality function for partitions

* Added tests for serialziation

* pickle support for dyadic

* Pickle support for interval types

* pickle support for partitions

* picke functions for algebra types

* typo

* test for lie pickle

* Pickle for free tensor types tests

* Added a default constructor.

* nominal pickle support for streams.

* Implementation of pickle not quit right for streams. Continue the research

* Fixed initialisation of effective domain

* Added __new__ to Stream type and modified pickle method

* Couple of changes to style.

* added tp_finalize to be safe

* Added methods to monomial for pickling

* added new macros for external library types

* added serialization for all the scalar types

* Fixed implementations detached from declaration

* added instantiations of the archive types

* Added serialization for enum types

* Add the specialization for polynomials

* Special load/save functions for JSON output.

* Added serialize method to StreamInterface and DynamicallyConstructedStream

* Sound path serialization

* Implemented serialization for the path type

* Serialization for SoundFileDatSource

* Added loading/dumping to stream chache files.

* removed file locks until I can figure out how they work

* Added cache-id function

* reformatting.

* removed print

* Added serialization methods to interval types.

* Added instantiations for the interval types.

* Added equality function for partitions

* Added tests for serialziation

* pickle support for dyadic

* Pickle support for interval types

* pickle support for partitions

* picke functions for algebra types

* typo

* test for lie pickle

* Pickle for free tensor types tests

* Added a default constructor.

* nominal pickle support for streams.

* Implementation of pickle not quit right for streams. Continue the research

* Fixed initialisation of effective domain

* Added __new__ to Stream type and modified pickle method

* Couple of changes to style.

* added tp_finalize to be safe

* Added methods to monomial for pickling

* added new macros for external library types

* added serialization for all the scalar types

* Fixed implementations detached from declaration

* added instantiations of the archive types

* Added serialization for enum types

* Add the specialization for polynomials

* Special load/save functions for JSON output.

* Added serialize method to StreamInterface and DynamicallyConstructedStream

* Sound path serialization

* Implemented serialization for the path type

* Serialization for SoundFileDatSource

* Added loading/dumping to stream chache files.

* removed file locks until I can figure out how they work

* removed print

* added new macros for external library types

* added serialization for all the scalar types

* added instantiations of the archive types

* Added serialization for enum types

* Special load/save functions for JSON output.

* Separate out implementations

* just so many improvements
@philipparubin philipparubin marked this pull request as ready for review March 5, 2024 10:34
@inakleinbottle inakleinbottle merged commit cbe3485 into main Mar 5, 2024
3 checks passed
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.

2 participants