diff --git a/_sources/quickstarter.rst.txt b/_sources/quickstarter.rst.txt index e2d563e79c..71e4a88a49 100644 --- a/_sources/quickstarter.rst.txt +++ b/_sources/quickstarter.rst.txt @@ -8,20 +8,14 @@ Data input 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. -Clone git repository --------------------- +Either check out our interactive `quickstarter `_, or continue below to run `naturf` using a python file. -.. code:: bash - - git clone https://github.com/IMMM-SFA/naturf.git - -Install dependencies --------------------- -In the directory where the *naturf* repository was cloned, run the following command to install all dependencies in the current environment. +Install ``naturf` +----------------- .. code:: bash - pip install . + pip install naturf Edit config file ---------------- @@ -33,11 +27,26 @@ The *config.py* file in the naturf/ directory sets the default names for variabl data_id_field_name data_height_field_name +Create a python script called `run.py` to run `naturf` + +.. code:: python3 + + from importlib.resources import files + from naturf import driver + + input_shapefile_path = str(files("naturf.data").joinpath("C-5.shp")) + inputs = {"input_shapefile": input_shapefile_path} + outputs = ["write_binary", "write_index"] + model = driver.Model(inputs, outputs) + + df = model.execute() + model.graph() + -Run `naturf` using hamilton ---------------------------- -This will run all functions required to create the output specified in `hamilton_run.py` `output_columns` variable. Currently `write_binary` and `write_index`. The `path` variable should point towards the input shapefile. +Run `naturf` +------------ +This will run all functions required to create the output specified in the `run.py` `output_columns` variable. Currently `write_binary` and `write_index`. The `path` variable should point towards the input shapefile. .. code:: bash - python hamilton_run.py + python run.py diff --git a/objects.inv b/objects.inv index 81d39ae3c3..d5a423236b 100644 Binary files a/objects.inv and b/objects.inv differ diff --git a/quickstarter.html b/quickstarter.html index 1112a20444..26cb75debb 100644 --- a/quickstarter.html +++ b/quickstarter.html @@ -60,10 +60,9 @@