Skip to content

uwescience/ADUniverse

Repository files navigation

ADUniverse

Accessory dwelling units (ADUs), often called backyard cottages and in-law apartments, provide a way for the City of Seattle to address housing affordability. This project is about aiding owners of single-family homes to assess the eligibility and desirability of building an ADU. We illustrate our vision via a prototype software tool for homeowners. Further details are provided in a white paper.

See project web page.

For a demonstration of the app, visit ADUniverse Web App Demonstration

By using the dataset (adunits.db) from this repository, you agree to the City of Seattle's Terms of Use and Policy, as well as to the King County Assessors', the US Census Bureau's and Zillow's, from whom this data was acquired.

Installation and Running

  1. Your machine should have the following installed already:

  2. First, clone ADU repository repository.

    • git clone https://github.com/uwescience/ADUniverse
    • cd ADUniverse
  3. You will be working in a "virtual environment".

    • conda create -n test_adu python=3.6
    • conda activate test_adu
  4. This code works for python 3.6. You should have miniconda installed. Then issue the following commands:

    • conda install -f -y -q --name test_adu -c conda-forge --file requirements.txt
    • pip install dash-dangerously-set-inner-html
  5. You just installed all the necessary dependencies needed but LFS (large file system). Now let's install lfs with the following commands:

    • git lfs install
  6. Clone ADUniverse again.

    • cd ..
    • mv ADUniverse ADUniverse_old
    • git clone https://github.com/uwescience/ADUniverse
    • cd ADUniverse
  7. To run the code

    • Change directories to the subfolder within ADUniverse by doing cd ADUniverse
    • Run the application. python index.py.
    • You will see a URL like http://127.0.0.1:8050. Browse to this URL and the application will load.
  8. When you are done,

    • conda deactivate

Notes for Windows 10 users

  • You should have python 3.7 installed already.
  • Open a gitbash command prompt from the search bar. You will do the git clone from this prompt. Then close it.
  • Install the 64 bit version of miniconda for python 3. This will run an installer. When this finishes, you will have an anaconda prompt available to you from the command search.
  • Open the Anaconda prompt as administrator. Change directories to the clone of the ADUniverse. This should be in c:\Users<user name>\ADUniverse
  • Resume with item (3) above.
  • In step 6, you will use move instead of mv.