diff --git a/docs/source/index.rst b/docs/source/index.rst index 7594f1a9df..6ba7371598 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -8,9 +8,9 @@ naturf documentation **Useful links**: `Source Repository `_ | `Issues & Ideas `_ | -`Interactive Quickstarter `_ +`Interactive Quickstarter `_ -**naturf** is an open-source geospatial Python package for calculating urban building parameters to be compiled and input to the Weather Research and Forecasting model (WRF). **naturf** was created to: +**naturf** is an open-source geospatial Python package for calculating urban building parameters to be compiled and input to the Weather Research and Forecasting model (WRF). **naturf** was created to: 1) Calculate 132 urban parameters based on building footprints and height, @@ -34,9 +34,9 @@ The Neighborhood Adaptive Tissues for Urban Resilience Futures tool (**naturf**) :img-top: _static/index_quickstarter.svg :text-align: center - New to **naturf**? Follow the quickstarter for a quick start. + New to **naturf**? Run the quickstarter in your browser. - .. button-ref:: quickstarter + .. button-ref:: https://naturf.msdlive.org/ :click-parent: :color: primary :expand: diff --git a/docs/source/quickstarter.rst b/docs/source/quickstarter.rst index a1679f0f1d..ddf4730fa2 100644 --- a/docs/source/quickstarter.rst +++ b/docs/source/quickstarter.rst @@ -2,14 +2,17 @@ Quickstarter ============ +.. note:: + `Run the interactive Quickstarter in browser! `_ + + +Continue below to run `naturf` using a python file. Input data ---------- The only input data required for `naturf` is a shapefile with building footprints and height data. There should be a field with a unique ID for each building the shapefile, and it should be in a projected coordinate system such as Alber Equal Area Conic. For input to the Weather Research and Forecasting model (WRF), the computed parameters for each building will be projected into WGS 84. -Either run the ipynb `quickstarter `_, or continue below to run `naturf` using a python file. - .. note:: Users need to `download graphviz `_ to visualize the Directed Acyclic Graph (DAG). diff --git a/notebooks/quickstarter.ipynb b/notebooks/quickstarter.ipynb index 72185e3832..5f65d8a43e 100644 --- a/notebooks/quickstarter.ipynb +++ b/notebooks/quickstarter.ipynb @@ -7,7 +7,9 @@ "source": [ "# `naturf` Quickstarter\n", "\n", - "The Neighborhood Adaptive Tissues for Urban Resilience Futures tool (`naturf`) is a Python workflow that generates files readable by the Weather Research and Forecasting (WRF) model. `naturf` uses *geopandas* and *hamilton* to calculate 132 building parameters from shapefiles with building footprint and height information. These parameters can be collected and used in many formats, and the primary output is a binary file configured for input to WRF. This workflow is a flexible adaptation of the National/World Urban Database and Access Portal Tool (NUDAPT/WUDAPT) that can be used with any study area at any spatial resolution. The climate modeling community and urban planners can identify the effects of building/neighborhood morphology on the microclimate using the urban parameters and WRF-readable files produced by `naturf`. The source code for `naturf` can be found on [GitHub](https://github.com/IMMM-SFA/naturf/tree/main), and more information on the urban parameters calculated can be found in the [documentation](https://immm-sfa.github.io/naturf/). Cases 1 and 2 below illustrate using *hamilton* to pull different outputs from `naturf` using example data. Case 3 shows how to use `naturf` with user data." + "The Neighborhood Adaptive Tissues for Urban Resilience Futures tool (`naturf`) is a Python workflow that generates files readable by the Weather Research and Forecasting (WRF) model. `naturf` uses *geopandas* and *hamilton* to calculate 132 building parameters from shapefiles with building footprint and height information. These parameters can be collected and used in many formats, and the primary output is a binary file configured for input to WRF. This workflow is a flexible adaptation of the National/World Urban Database and Access Portal Tool (NUDAPT/WUDAPT) that can be used with any study area at any spatial resolution. The climate modeling community and urban planners can identify the effects of building/neighborhood morphology on the microclimate using the urban parameters and WRF-readable files produced by `naturf`. The source code for `naturf` can be found on [GitHub](https://github.com/IMMM-SFA/naturf/tree/main), and more information on the urban parameters calculated can be found in the [documentation](https://immm-sfa.github.io/naturf/). Cases 1 and 2 below illustrate using *hamilton* to pull different outputs from `naturf` using example data. Case 3 shows how to use `naturf` with user data.\n", + "\n", + "> **_NOTE:_** [Run this quickstarter interactively in browser!](https://naturf.msdlive.org)" ] }, { @@ -2025,7 +2027,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.9.19" + "version": "3.12.2" } }, "nbformat": 4,