The project The Phone Book Diver provides several tools to analyze and visualize data from 25 years of public German telephone books. These tools can be used to display the distribution of names on a heatmap, search and merge the data across multiple editions, and perform further analysis using a Jupyter Notebook.
Special credits to Prof. Weber-Wulff of the University of Applied Sciences Berlin and Erdgeist for the project support and the provision of the telephone book data.
Unless otherwise stated, this project is licensed under CC-BY 4.0.
(using terminal - follow on your own risk ;-) )
These steps must be performed separately for each tool.
These folders are api/, jupyter/ and tools/.
( - install python3 if not already done > brew install python)
( - or upgrade current version > brew upgrade python)
-
move to your project directory
> cd "path/projectName" -
create virtual environment within project directory
> python3 -m venv .env --copies -
activate virtual environment
> source .env/bin/activate -
install requirements
> pip install -r requirements -
when done working - deactivate virtual environment
> deactivate
This project was bootstrapped with Create React App.
To start the project, in the project directory, run:
Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.
The page will reload if you make edits.
You will also see any lint errors in the console.
Runs the API for database requests
Open http://localhost:5000 to view in browser.
Examples for API requests:
- http://localhost:5000/search?collection=2020&key=lastname&value=Schmidt
Used for Heatmap requests - will return a list of Latitude and Longitude - http://localhost:5000/search?start=1990&end=2020&key=lastname&value=Schmidt
Will return all entries within the search range (similar entries will appear once with list of appearance)