Skip to content

Amsterdam-Internships/Venue-Accessibility-Google-Reviews

Repository files navigation

Venue Accessibility with Google Reviews

This project aims to highlight the perspective of people with Reduced Mobility (RM) living in Amsterdam via analysis of public venue reviews. This is done using Natural Language Processing (NLP) techniques such as Aspect Based Sentiment Analysis and Opinion Summarisation.

It is an extension of the work carried out by L. Da Rocha Bazilio, to understand how different models are able to extract aspects in reference to accessibility with data that is noisy e.g. a mixture of topics, instead of accessibility focused only.

In addition, understanding the impact of Opinion Summarisation on the reviews about accessibility. Also, how this can make activity and journey planning for those with RM easier.

This is an example of the UI of the application that pipeline will be connected to:


Project Folder Structure

There are the following folders in the structure:

  1. data: This folder includes data for the following purposes:
    1. external: This includes data from third party sources.
    2. interim: Intermediate data that has been transformed.
    3. processed: Finalised datasets for modelling.
    4. raw: The original immutable data.
  2. datasets: This is where you should place your data for training and testing.
  3. media: This is where results of each step of the pipeline are stored as images.
  4. models:Trained and serialized models, model predictions, or model summaries
  5. notebooks: This contains the notebooks of the pipeline.
  6. reports: Generated analysis as HTML, PDF, LaTeX, etc.
    1. figures: Generated graphics and figures to be used in reporting.
  7. results: Here you will find the txt form of the results.
  8. src: Folder for all source files specific to this project
  9. scripts: Folder with example scripts for performing different tasks (could serve as usage documentation)
  10. tests Here I store all of the tests for project

Installation

  1. Clone this repository:

    git clone git@github.com:Amsterdam-Internships/Venue-Accessibility-Google-Reviews.git
  2. Install all dependencies:

    conda install environment.yml or pip install requirements.txt

Setup

In order to setup the pipeline you need to download the google test data from here and the euan's guide data here

place the google test data in the test folder and the euans dataset in the train folder.

To setup the environment please create your own .env file with a variable called $LOCAL_ENV this is where you should keep the file path of your home directory. Then you will be able to connect this to the relative paths of this repo.

E.g. $LOCAL_ENV = /Users/yourname/Venue-Accessibility-Google-Reviews

To run this pipeline run the bash script titled 'full_pipeline.sh'

How it works

The image below displays the workflow of the pipeline, these steps correspond to the folder structure of the pipeline.


Acknowledgements

This repository was created in collaboration with Amsterdam Intelligence for the City of Amsterdam. It is based on the prior work of Lizzy Da Rocha Bazilio.