Joshua Sundance Bailey
commited on
Commit
·
2953cf8
1
Parent(s):
0688ea5
workflow badges
Browse files
README.md
CHANGED
@@ -15,8 +15,10 @@ tags: [geospatial, streamlit, docker]
|
|
15 |
[![python](https://img.shields.io/badge/Python-3.11-3776AB.svg?style=flat&logo=python&logoColor=white)](https://www.python.org)
|
16 |
![GitHub tag (with filter)](https://img.shields.io/github/v/tag/joshuasundance-swca/geospatial-data-converter)
|
17 |
|
18 |
-
[![Docker](https://
|
19 |
[![Docker Image Size (tag)](https://img.shields.io/docker/image-size/joshuasundance/geospatial-data-converter/latest)](https://hub.docker.com/r/joshuasundance/geospatial-data-converter)
|
|
|
|
|
20 |
[![Open HuggingFace Space](https://huggingface.co/datasets/huggingface/badges/raw/main/open-in-hf-spaces-sm.svg)](https://huggingface.co/spaces/joshuasundance/geospatial-data-converter)
|
21 |
|
22 |
![Code Climate maintainability](https://img.shields.io/codeclimate/maintainability/joshuasundance-swca/geospatial-data-converter)
|
@@ -30,3 +32,37 @@ tags: [geospatial, streamlit, docker]
|
|
30 |
|
31 |
[![security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)
|
32 |
![Known Vulnerabilities](https://snyk.io/test/github/joshuasundance-swca/geospatial-data-converter/badge.svg)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15 |
[![python](https://img.shields.io/badge/Python-3.11-3776AB.svg?style=flat&logo=python&logoColor=white)](https://www.python.org)
|
16 |
![GitHub tag (with filter)](https://img.shields.io/github/v/tag/joshuasundance-swca/geospatial-data-converter)
|
17 |
|
18 |
+
[![Push to Docker Hub](https://github.com/joshuasundance-swca/geospatial-data-converter/actions/workflows/docker-hub.yml/badge.svg)](https://github.com/joshuasundance-swca/geospatial-data-converter/actions/workflows/docker-hub.yml)
|
19 |
[![Docker Image Size (tag)](https://img.shields.io/docker/image-size/joshuasundance/geospatial-data-converter/latest)](https://hub.docker.com/r/joshuasundance/geospatial-data-converter)
|
20 |
+
|
21 |
+
[![Push to HuggingFace Space](https://github.com/joshuasundance-swca/geospatial-data-converter/actions/workflows/hf-space.yml/badge.svg)](https://github.com/joshuasundance-swca/geospatial-data-converter/actions/workflows/hf-space.yml)
|
22 |
[![Open HuggingFace Space](https://huggingface.co/datasets/huggingface/badges/raw/main/open-in-hf-spaces-sm.svg)](https://huggingface.co/spaces/joshuasundance/geospatial-data-converter)
|
23 |
|
24 |
![Code Climate maintainability](https://img.shields.io/codeclimate/maintainability/joshuasundance-swca/geospatial-data-converter)
|
|
|
32 |
|
33 |
[![security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)
|
34 |
![Known Vulnerabilities](https://snyk.io/test/github/joshuasundance-swca/geospatial-data-converter/badge.svg)
|
35 |
+
|
36 |
+
This project showcases a simple geospatial data converter using [Streamlit](https://streamlit.io) and [GeoPandas](https://geopandas.org/).
|
37 |
+
|
38 |
+
# Features
|
39 |
+
- User-friendly interface for easy data conversion
|
40 |
+
- Supports conversion from the following input formats:
|
41 |
+
- ArcGIS featurelayer URL
|
42 |
+
- Uploaded file: KML, KMZ, GeoJSON, ZIP
|
43 |
+
- Provides data in the selected output format
|
44 |
+
- Presents data preview (geometry omitted for display purposes)
|
45 |
+
- Download button for the converted data
|
46 |
+
|
47 |
+
# Deployment
|
48 |
+
`geospatial-data-converter` is deployed as a [Docker image](https://hub.docker.com/r/<your-dockerhub-username>/geospatial-data-converter) based on the `python:3.11-slim-bookworm` image.
|
49 |
+
|
50 |
+
## With Docker (pull from Docker Hub)
|
51 |
+
1. Run in terminal:
|
52 |
+
`docker run -p 8501:8501 <your-dockerhub-username>/geospatial-data-converter:latest`
|
53 |
+
2. Open http://localhost:8501 in your browser
|
54 |
+
|
55 |
+
## Docker Compose (build locally)
|
56 |
+
1. Clone the repo. Navigate to cloned repo directory
|
57 |
+
2. Run in terminal: `docker compose up`
|
58 |
+
3. Open http://localhost:8501 in your browser
|
59 |
+
|
60 |
+
## Kubernetes
|
61 |
+
1. Clone the repo. Navigate to cloned repo directory
|
62 |
+
2. Run bash script: `/bin/bash ./kubernetes/deploy.sh`
|
63 |
+
3. Get the IP address for your new service: `kubectl get service geospatial-data-converter`
|
64 |
+
|
65 |
+
# Links
|
66 |
+
- [Streamlit](https://streamlit.io)
|
67 |
+
- [GeoPandas](https://geopandas.org/)
|
68 |
+
- [Docker Hub](https://hub.docker.com/)
|