From f20ea45c92eb909be604e6188e8bff7fb06a70cf Mon Sep 17 00:00:00 2001 From: Sandro Campos Date: Thu, 28 Mar 2024 17:58:38 -0400 Subject: [PATCH 1/3] Add description to landing page --- docs/gettingstarted/contributing.rst | 4 ++ docs/gettingstarted/installation.rst | 2 +- docs/index.rst | 56 +++------------------------- 3 files changed, 11 insertions(+), 51 deletions(-) create mode 100644 docs/gettingstarted/contributing.rst diff --git a/docs/gettingstarted/contributing.rst b/docs/gettingstarted/contributing.rst new file mode 100644 index 00000000..46b29ff7 --- /dev/null +++ b/docs/gettingstarted/contributing.rst @@ -0,0 +1,4 @@ +Contribution Guide +================== + +Under construction. \ No newline at end of file diff --git a/docs/gettingstarted/installation.rst b/docs/gettingstarted/installation.rst index c9f52bcf..a4e4833f 100644 --- a/docs/gettingstarted/installation.rst +++ b/docs/gettingstarted/installation.rst @@ -41,7 +41,7 @@ To install the package and a minimum number of dependencies you can run: python -m pip install pytest # to validate package installation In alternative, you can execute the `setup_dev` script which installs all the additional requirements -to setup a development environment. Read more about contributing to LSDB in our :doc:`Quickstart Guide `. +to setup a development environment. Read more about contributing to LSDB in our :doc:`Contribution Guide `. .. code-block:: bash diff --git a/docs/index.rst b/docs/index.rst index c0c64d21..dee10a03 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -2,59 +2,15 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -Welcome to lsdb's documentation! +LSDB - Large Survey DataBase ======================================================================================== -User Guide ----------- - -You can install LSDB with `conda` or `pip`: - -.. code-block:: bash - - >> # Conda installation - >> conda install -c conda-forge lsdb - >> # Pip installation - >> python3 -mpip install lsdb - -See `notebooks `_ for examples. - -Dev Guide - Getting Started ---------------------------- - -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. - -.. code-block:: console - - >> conda create -n python=3.10 - >> conda activate - - -Once you have created a new environment, you can install this project for local -development using the following commands: - -.. 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 `_. +LSDB is a framework that facilitates and enables spatial analysis for extremely large astronomical catalogs +(i.e. querying and crossmatching O(1B) sources). It is built on top of Dask to parallelize operations across +multiple surveys partitioned with an `HiPSCat `_ structure. +In this website you will find tutorials on how to get started with LSDB, as well as its API reference. If you +wish to contribute to the repository please visit our :doc:`Contribution Guide `. .. toctree:: :hidden: From 6bef25043235ae1d18623f2120619ef3f40b17bc Mon Sep 17 00:00:00 2001 From: Sandro Campos Date: Fri, 29 Mar 2024 09:36:07 -0400 Subject: [PATCH 2/3] Add contribution guide pointer --- docs/gettingstarted.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/gettingstarted.rst b/docs/gettingstarted.rst index a11705c7..0d5dde47 100644 --- a/docs/gettingstarted.rst +++ b/docs/gettingstarted.rst @@ -8,4 +8,5 @@ we encourage you to open an issue on the .. toctree:: Installing LSDB - Quickstart Guide \ No newline at end of file + Quickstart Guide + Contribution Guide From 32a687bd7dec8a8aafb32db6b2a1a18f637f8e23 Mon Sep 17 00:00:00 2001 From: Sandro Campos Date: Fri, 29 Mar 2024 19:17:37 -0400 Subject: [PATCH 3/3] Move dev guide to contribution guide --- docs/gettingstarted/contributing.rst | 36 +++++++++++++++++++++++++++- docs/index.rst | 19 +++++++++++---- 2 files changed, 49 insertions(+), 6 deletions(-) diff --git a/docs/gettingstarted/contributing.rst b/docs/gettingstarted/contributing.rst index 46b29ff7..01770c87 100644 --- a/docs/gettingstarted/contributing.rst +++ b/docs/gettingstarted/contributing.rst @@ -1,4 +1,38 @@ Contribution Guide ================== -Under construction. \ No newline at end of file +Dev Guide - Getting Started +--------------------------- + +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. + +.. code-block:: console + + >> conda create -n python=3.10 + >> conda activate + + +Once you have created a new environment, you can install this project for local +development using the following commands: + +.. 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 `_. \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst index dee10a03..6e4db927 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -5,12 +5,21 @@ LSDB - Large Survey DataBase ======================================================================================== -LSDB is a framework that facilitates and enables spatial analysis for extremely large astronomical catalogs -(i.e. querying and crossmatching O(1B) sources). It is built on top of Dask to parallelize operations across -multiple surveys partitioned with an `HiPSCat `_ structure. +LSDB is a framework that facilitates and enables fast spatial analysis for extremely large astronomical catalogs +(i.e. querying and crossmatching O(1B) sources). It aims to address large-scale data processing challenges, in +particular those brought up by `LSST `_. -In this website you will find tutorials on how to get started with LSDB, as well as its API reference. If you -wish to contribute to the repository please visit our :doc:`Contribution Guide `. +Built on top of Dask to efficiently scale and parallelize operations across multiple workers, it leverages +the `HiPSCat `_ data format for surveys in a partitioned HEALPix +(Hierarchical Equal Area isoLatitude Pixelization) structure. + +In this website you will find: + +- :doc:`Getting Started ` guides on how to install and run an example workflow +- :doc:`Tutorials `, and :doc:`Notebooks ` with more advanced usage examples +- The detailed :doc:`API Reference ` documentation + +Learn more about contributing to this repository in our :doc:`Contribution Guide `. .. toctree:: :hidden: