Python library which helps users geocode locations and map longitude/latitude coordinates to the Metropolitan Statistical Areas (MSAs) defined by the Census Bureau.
The Python version used for development is 3.10.4. Below are a series of steps to follow before installation:
-
Create a Python virtual environment where the library can be installed
-
Clone this repository within a computer directory (folder) of your choice (please ensure Git is installed and an SSH key is specified for your profile):
git clone git@github.com:Ealameda31/msa-mapper.git
-
Initialize Git LFS and pull the files the library needs for certain functions:
git lfs install git lfs pull
After activating a Python virtual environment, users should navigate to the repository contents (i.e., cd msa-mapper/) and run the following command:
python setup.py bdist_wheel This should create a dist folder within your directory containing the wheel file. Then, the library can be installed within your environment by running the command below:
pip install dist/*If users are experiencing issues with geospatial packages, download them from Christoph Gohlke's Binaries. Download and install the wheel file that corresponds to the environment's Python version (i.e., Python 3.10.4 = cp310). Usually problems resolve after manually installing GDAL and Fiona.
Library structure, function documentation, and examples to follow can be found on this webpage.
Shapefiles are manually uploaded and are located within the internal directory of the library. These file are stored in Git LFS to avoid unnecessary data downloads. They are updated on an infrequent basis (every 10 years) but finding a way to cross-reference the shapefiles programmatically would be ideal. s
Feel free to create an issue within this GitHub repository if a bug is found or for additional enhancements. The developers will typically respond within 48 hours.
For additional questions and/or use-cases, please contact Enrique M. Alameda-Basora (emalameda96@gmail.com).