From e6f686b77a1ac4687d0e8f2f78695fde5b5f2a02 Mon Sep 17 00:00:00 2001 From: Michael Chow Date: Mon, 29 Aug 2022 18:45:11 -0400 Subject: [PATCH] basic updates --- _quarto.yml | 38 ++++++++++++++++++++++++++++-------- about/key_features.qmd | 7 ++++--- api/index.qmd | 7 ------- guide/workflows-backends.qmd | 5 ++--- 4 files changed, 36 insertions(+), 21 deletions(-) delete mode 100644 api/index.qmd diff --git a/_quarto.yml b/_quarto.yml index 21a770b..1c13381 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -6,7 +6,11 @@ project: - guide/*.qmd - api/*.qmd - examples/*.qmd - #- about/*.qmd + - about/*.qmd + - develop/*.qmd + - develop/*.ipynb + resources: + - api/** website: title: "Siuba" @@ -16,13 +20,15 @@ website: left: - text: "Guide" file: guide/overview.qmd -# - text: "API" -# href: api/index.qmd -# - text: "Examples" -# href: examples/index.qmd -# - text: "About" -# menu: -# - about/key_features.qmd + - text: "Reference" + href: api/ + - text: "Examples" + href: examples/index.qmd + - text: "Develop" + href: develop/index.qmd + - text: "About" + menu: + - about/key_features.qmd right: - icon: github href: https://github.com/machow/siuba/ @@ -73,6 +79,22 @@ website: contents: - guide/extra-r-to-python.qmd # - guide/guide_programming.qmd + - id: develop + style: floating + collapse-level: 2 + align: left + contents: + - develop/index.qmd + - section: "Backends" + contents: + - develop/backend_sql.qmd + - develop/backend_pandas.qmd + - section: "Core" + contents: + - develop/guide_programming.qmd + - develop/sql-translators.ipynb + - develop/call_trees.qmd + - develop/pandas-group-ops.qmd - id: dummy format: diff --git a/about/key_features.qmd b/about/key_features.qmd index 1a42699..3b99a3f 100644 --- a/about/key_features.qmd +++ b/about/key_features.qmd @@ -5,7 +5,6 @@ execute: format: html: toc-depth: 3 - toc-title: wat jupyter: jupytext: formats: 'qmd:quarto' @@ -81,7 +80,7 @@ table = tabulate.tabulate([ -### Built on pandas +## Built on pandas pandas is everywhere in python data analysis. The siuba library builds on this incredible work by using pandas Series methods as its reference implementation. This means that you use the pandas methods you've already learned! @@ -196,7 +195,7 @@ mtcars.assign(demeaned = g_cyl.obj.hp - g_cyl.hp.transform("mean")) Note that `g_cyl` does not have an `assign` method, and requires passing what operation you want to do (`"mean"`) as a string to `.transform()`. -### Going beyond +## Fast and flexible ### Fast grouped operations @@ -318,3 +317,5 @@ tagged = pd.DataFrame({ >> unnest("split_tags") ) ``` + +## Learning more diff --git a/api/index.qmd b/api/index.qmd deleted file mode 100644 index 1a7da92..0000000 --- a/api/index.qmd +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: API ---- - - -This page will diagram out key concepts - diff --git a/guide/workflows-backends.qmd b/guide/workflows-backends.qmd index d628660..a9c28e1 100644 --- a/guide/workflows-backends.qmd +++ b/guide/workflows-backends.qmd @@ -1,5 +1,5 @@ --- -title: Backend Examples 🚧 +title: "Backend Examples 🚧" jupyter: jupytext: formats: 'qmd:quarto' @@ -7,7 +7,7 @@ jupyter: extension: .qmd format_name: quarto format_version: '1.0' - jupytext_version: 1.14.0 + jupytext_version: 1.13.6 kernelspec: display_name: Python 3 (ipykernel) language: python @@ -55,6 +55,5 @@ tbl_filtered ``` ```{python} - q = tbl_filtered >> show_query(simplify=True) ```