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

Forward-merge branch-23.08 to branch-23.10 #515

Closed
wants to merge 4 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 8 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,10 +18,6 @@ The current version of cuxfilter leverages jupyter notebook and bokeh server to

![layout architecture](./docs/_images/RAPIDS_cuxfilter.png)

### What is cuDataTiles?

cuxfilter implements cuDataTiles, a GPU accelerated version of data tiles based on the work of [Falcon](https://github.com/uwdata/falcon). When starting to interact with specific charts in a cuxfilter dashboard, values for the other charts are precomputed to allow for fast slider scrubbing without having to recalculate values.

### Open Source Projects

cuxfilter wouldn’t be possible without using these great open source projects:
Expand Down Expand Up @@ -56,14 +52,15 @@ cux_df = cuxfilter.DataFrame.from_arrow(DATA_DIR+'/auto_accidents.arrow')
cux_df.data['ST_CASE'] = cux_df.data['ST_CASE'].astype('float64')

label_map = {1: 'Sunday', 2: 'Monday', 3: 'Tuesday', 4: 'Wednesday', 5: 'Thursday', 6: 'Friday', 7: 'Saturday', 9: 'Unknown'}
cux_df.data['DAY_WEEK_STR'] = cux_df.data.DAY_WEEK.map(label_map)
gtc_demo_red_blue_palette = [ "#3182bd", "#6baed6", "#7b8ed8", "#e26798", "#ff0068" , "#323232" ]

#declare charts
chart1 = cuxfilter.charts.scatter(x='dropoff_x', y='dropoff_y', aggregate_col='DAY_WEEK', aggregate_fn='mean',
color_palette=gtc_demo_red_blue_palette, tile_provider='CartoLight', unselected_alpha=0.2,
pixel_shade_type='linear')
chart2 = cuxfilter.charts.multi_select('YEAR')
chart3 = cuxfilter.charts.bar('DAY_WEEK', x_label_map=label_map)
chart3 = cuxfilter.charts.bar('DAY_WEEK_STR')
chart4 = cuxfilter.charts.bar('MONTH')

#declare dashboard
Expand Down Expand Up @@ -96,26 +93,26 @@ datasets_check('mortgage', base_dir=DATA_DIR)

cux_df = cuxfilter.DataFrame.from_arrow(DATA_DIR + '/146M_predictions_v2.arrow')

MAPBOX_API_KEY= "<mapbox-api-key>"
geoJSONSource='https://raw.githubusercontent.com/rapidsai/cuxfilter/GTC-2018-mortgage-visualization/javascript/demos/GTC%20demo/src/data/zip3-ms-rhs-lessprops.json'

chart0 = cuxfilter.charts.choropleth( x='zip', color_column='delinquency_12_prediction', color_aggregate_fn='mean',
elevation_column='current_actual_upb', elevation_factor=0.00001, elevation_aggregate_fn='sum',
geoJSONSource=geoJSONSource, mapbox_api_key=MAPBOX_API_KEY, data_points=1000
geoJSONSource=geoJSONSource, data_points=1000
)
chart2 = cuxfilter.charts.bar('delinquency_12_prediction',data_points=50)
chart3 = cuxfilter.charts.range_slider('borrower_credit_score',data_points=50)
chart1 = cuxfilter.charts.drop_down('dti')

#declare dashboard
d = cux_df.dashboard([chart0, chart2],sidebar=[chart3, chart1], layout=cuxfilter.layouts.feature_and_double_base,theme = cuxfilter.themes.light, title='Mortgage Dashboard')
d = cux_df.dashboard([chart0, chart2],sidebar=[chart3, chart1], layout=cuxfilter.layouts.feature_and_double_base,theme = cuxfilter.themes.dark, title='Mortgage Dashboard')

# run the dashboard within the notebook cell
# Bokeh and Datashader based charts also have a `save` tool on the side toolbar, which can download and save the individual chart when interacting with the dashboard.
# d.app()

#run the dashboard as a webapp:
d.show('jupyter-notebook/lab-url')
# if running on a port other than localhost:8888, run d.show(jupyter-notebook-lab-url:port)
d.show()

```

Expand Down Expand Up @@ -182,15 +179,6 @@ See [build instructions](CONTRIBUTING.md#setting-up-your-build-environment).

## Troubleshooting

**libxcomposite.so.1 not found error**

If the `await d.preview()` throws a libxcomposite.so.1 not found error, execute the following commands:

```bash
apt-get update
apt-get install libxcomposite1 libxcursor1 libxdamage1 libxfixes3 libxi6 libxrandr2 libxtst6 libcups2 libxss1 libasound2 libpangocairo-1.0-0 libpango-1.0-0 libatk1.0-0 libgtk-3-0 libgdk-pixbuf2.0-0
```

**bokeh server in jupyter lab**

To run the bokeh server in a jupyter lab, install jupyterlab dependencies
Expand Down Expand Up @@ -233,11 +221,11 @@ Currently supported layout templates and example code can be found on the [layou

| Library | Chart type |
| ------------- | ------------------------------------------------------------------------------------------------ |
| bokeh | bar, line |
| bokeh | bar |
| datashader | scatter, scatter_geo, line, stacked_lines, heatmap, graph |
| panel_widgets | range_slider, date_range_slider, float_slider, int_slider, drop_down, multi_select, card, number |
| custom | view_dataframe |
| pydeck | choropleth(3d and 2d) |
| deckgl | choropleth(3d and 2d) |

## Contributing Developers Guide

Expand Down
11 changes: 5 additions & 6 deletions conda/environments/all_cuda-118_arch-x86_64.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ channels:
- conda-forge
- nvidia
dependencies:
- bokeh>=2.4.2,<=2.5
- bokeh>=3.1
- cuda-version=11.8
- cudatoolkit
- cudf==23.8.*
Expand All @@ -17,7 +17,8 @@ dependencies:
- dask-cudf==23.8.*
- datashader>=0.15
- geopandas>=0.11.0
- holoviews>=1.15.0,<=1.15.4
- holoviews>=1.16.0
- ipykernel
- ipython
- jupyter-server-proxy
- jupyter_sphinx
Expand All @@ -30,12 +31,10 @@ dependencies:
- numpydoc
- packaging
- pandoc<=2.0.0
- panel>=0.14.0,<=0.14.1
- panel >=1.0
- pre-commit
- pydata-sphinx-theme
- pydeck>=0.3,<=0.5.0
- pyppeteer>=0.2.6
- pyproj>=2.4,<=3.4
- pyproj>=2.4
- pytest
- pytest-cov
- pytest-xdist
Expand Down
11 changes: 5 additions & 6 deletions conda/environments/all_cuda-120_arch-x86_64.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ channels:
- conda-forge
- nvidia
dependencies:
- bokeh>=2.4.2,<=2.5
- bokeh>=3.1
- cuda-version=12.0
- cudf==23.8.*
- cugraph==23.8.*
Expand All @@ -16,7 +16,8 @@ dependencies:
- dask-cudf==23.8.*
- datashader>=0.15
- geopandas>=0.11.0
- holoviews>=1.15.0,<=1.15.4
- holoviews>=1.16.0
- ipykernel
- ipython
- jupyter-server-proxy
- jupyter_sphinx
Expand All @@ -29,12 +30,10 @@ dependencies:
- numpydoc
- packaging
- pandoc<=2.0.0
- panel>=0.14.0,<=0.14.1
- panel >=1.0
- pre-commit
- pydata-sphinx-theme
- pydeck>=0.3,<=0.5.0
- pyppeteer>=0.2.6
- pyproj>=2.4,<=3.4
- pyproj>=2.4
- pytest
- pytest-cov
- pytest-xdist
Expand Down
8 changes: 3 additions & 5 deletions conda/recipes/cuxfilter/meta.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -24,24 +24,22 @@ requirements:
- setuptools
- cuda-version ={{ cuda_version }}
run:
- bokeh >=2.4.2,<=2.5
- bokeh >=3.1
- cudf ={{ minor_version }}
- cupy >=12.0.0
- cuspatial ={{ minor_version }}
- dask-cudf ={{ minor_version }}
- datashader >=0.15
- geopandas >=0.11.0
- holoviews>=1.15.0,<=1.15.4
- holoviews>=1.16
- jupyter-server-proxy
- libwebp
- nodejs >=14
- numba >=0.57
- numpy >=1.21
- packaging
- panel >=0.14.0,<=0.14.1
- pydeck >=0.3,<=0.5.0
- panel >=1.0
- pyppeteer >=0.2.6
- pyproj >=2.4,<=3.4
- python
- {{ pin_compatible('cuda-version', max_pin='x', min_pin='x') }}

Expand Down
13 changes: 6 additions & 7 deletions dependencies.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,7 @@ dependencies:
common:
- output_types: [conda, requirements]
packages:
- ipykernel
- ipython
- jupyter_sphinx
- nbsphinx
Expand All @@ -128,6 +129,7 @@ dependencies:
packages:
- cugraph==23.8.*
- dask-cuda==23.8.*
- pyproj>=2.4
py_version:
specific:
- output_types: conda
Expand All @@ -147,21 +149,18 @@ dependencies:
common:
- output_types: [conda, requirements, pyproject]
packages:
- bokeh>=2.4.2,<=2.5
- bokeh>=3.1
- cudf==23.8.*
- cuspatial==23.8.*
- dask-cudf==23.8.*
- datashader>=0.15
- geopandas>=0.11.0
- holoviews>=1.15.0,<=1.15.4
- holoviews>=1.16.0
- jupyter-server-proxy
- numba>=0.57
- numpy>=1.21
- packaging
- panel>=0.14.0,<=0.14.1
- pydeck>=0.3,<=0.5.0
- pyppeteer>=0.2.6
- pyproj>=2.4,<=3.4
- panel >=1.0
- output_types: conda
packages:
- cupy>=12.0.0
Expand All @@ -174,7 +173,7 @@ dependencies:
common:
- output_types: [conda, requirements, pyproject]
packages:
- ipython
- pytest
- pytest-cov
- pytest-xdist

Binary file added docs/_images/auto-accidents-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/auto-accidents-notebook.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/auto-accidents.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/dashboard-show.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/_images/demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/_images/demo2.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/graphs.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/mortgage.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/nyc-taxi.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/theme-showcase-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/theme-showcase-default.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/theme-showcase-rapids-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_images/theme-showcase-rapids.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
13 changes: 6 additions & 7 deletions docs/source/conf.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
# Copyright (c) 2019-2023, NVIDIA CORPORATION.
import pydata_sphinx_theme

# -- Project information -----------------------------------------------------
project = "cuxfilter"
Expand All @@ -11,9 +10,9 @@
# built documents.
#
# The short X.Y version.
version = '23.08'
version = "23.08"
# The full version, including alpha/beta/rc tags
release = '23.08.00'
release = "23.08.00"

nbsphinx_allow_errors = True

Expand Down Expand Up @@ -63,9 +62,7 @@
# Removes sidebar
htmlhelp_basename = "cuxfilterdoc"

html_sidebars = {
"user_guide/index": []
}
html_sidebars = {"user_guide/index": []}

html_theme_options = {
"external_links": [],
Expand All @@ -79,4 +76,6 @@

def setup(app):
app.add_css_file("https://docs.rapids.ai/assets/css/custom.css")
app.add_js_file("https://docs.rapids.ai/assets/js/custom.js", loading_method="defer")
app.add_js_file(
"https://docs.rapids.ai/assets/js/custom.js", loading_method="defer"
)
2 changes: 1 addition & 1 deletion docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ cuxfilter enables GPU accelerated cross-filtering dashboards from notebooks, in
user_guide/index
api_reference/dataframe


Indices and tables
==================

Expand Down
Loading
Loading