From 935cdce8c6ff13302b773b8332df981c5dfb5d5e Mon Sep 17 00:00:00 2001 From: Doug Branton Date: Mon, 13 May 2024 10:45:50 -0700 Subject: [PATCH] revise intro --- README.md | 5 +- docs/index.rst | 51 ++++++++----------- docs/{notebooks.rst => tutorials.rst} | 4 +- docs/{notebooks => tutorials}/README.md | 0 docs/{notebooks => tutorials}/low_level.ipynb | 0 5 files changed, 25 insertions(+), 35 deletions(-) rename docs/{notebooks.rst => tutorials.rst} (61%) rename docs/{notebooks => tutorials}/README.md (100%) rename docs/{notebooks => tutorials}/low_level.ipynb (100%) diff --git a/README.md b/README.md index 05b70fd..8fbc77e 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,11 @@ # nested-pandas -Efficient pandas representation for nested associated datasets. +An extension of pandas for efficient representation of nested +associated datasets. Nested-Pandas extends the [pandas](https://pandas.pydata.org/) package with tooling and support for nested dataframes packed into values of top-level dataframe columns. [Pyarrow](https://arrow.apache.org/docs/python/index.html) -is used intrinsically to aid in scalability and performance. +is used internally to aid in scalability and performance. ![image](./nestedframe.png) diff --git a/docs/index.rst b/docs/index.rst index aefa712..6fd1647 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -2,45 +2,34 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -Welcome to nested-pandas's documentation! -======================================================================================== +Nested-Pandas +============= -Dev Guide - Getting Started ---------------------------- +An extension of pandas for efficient representation of nested +associated datasets. -Before installing any dependencies or writing code, it's a great idea to create a -virtual environment. LINCC-Frameworks engineers primarily use `conda` to manage virtual -environments. If you have conda installed locally, you can run the following to -create and activate a new environment. +Nested-Pandas extends the [pandas](https://pandas.pydata.org/) package with +tooling and support for nested dataframes packed into values of top-level +dataframe columns. [Pyarrow](https://arrow.apache.org/docs/python/index.html) +is used internally to aid in scalability and performance. -.. code-block:: console +![image](../nestedframe.png) - >> conda create env -n python=3.10 - >> conda activate +How to Use This Guide +===================== +Begin with the :doc:`Getting Started ` +guide to learn the basics of installation and walkthrough a simple example of +using nested-pandas. -Once you have created a new environment, you can install this project for local -development using the following commands: +The :doc:`Tutorials `_ +section showcases the fundamental features of nested-pandas. -.. code-block:: console - - >> pip install -e .'[dev]' - >> pre-commit install - >> conda install pandoc - - -Notes: - -1) The single quotes around ``'[dev]'`` may not be required for your operating system. -2) ``pre-commit install`` will initialize pre-commit for this local repository, so - that a set of tests will be run prior to completing a local commit. For more - information, see the Python Project Template documentation on - `pre-commit `_. -3) Installing ``pandoc`` allows you to verify that automatic rendering of Jupyter notebooks - into documentation for ReadTheDocs works as expected. For more information, see - the Python Project Template documentation on - `Sphinx and Python Notebooks `_. +API-level information about nested-pandas is viewable in the +:doc:`API Reference ` +section. +Learn more about contributing to this repository in our :doc:`Contribution Guide `. .. toctree:: :hidden: diff --git a/docs/notebooks.rst b/docs/tutorials.rst similarity index 61% rename from docs/notebooks.rst rename to docs/tutorials.rst index 7a3f9b3..606bd01 100644 --- a/docs/notebooks.rst +++ b/docs/tutorials.rst @@ -1,6 +1,6 @@ -Notebooks +Tutorials ======================================================================================== .. toctree:: - Lower-level interfaces + Lower-level interfaces diff --git a/docs/notebooks/README.md b/docs/tutorials/README.md similarity index 100% rename from docs/notebooks/README.md rename to docs/tutorials/README.md diff --git a/docs/notebooks/low_level.ipynb b/docs/tutorials/low_level.ipynb similarity index 100% rename from docs/notebooks/low_level.ipynb rename to docs/tutorials/low_level.ipynb