Bump version to v0.1.0 for release

.github/actions/setup-venv/action.yml

@@ -30,7 +30,8 @@ runs:
       id: virtualenv-cache
       with:
         path: .venv
-        key: ${{ inputs.cache-prefix }}-${{ runner.os }}-${{ env.PYTHON_VERSION }}-${{ hashFiles('Pipfile.lock') }}
+        key: ${{ inputs.cache-prefix }}-${{ runner.os }}-${{ env.PYTHON_VERSION }}-${{ hashFiles('requirements.txt', 'dev-requirements.txt') }}
+
     - if: steps.virtualenv-cache.outputs.cache-hit != 'true'
       shell: bash
       run: |

.github/workflows/main.yml

@@ -74,7 +74,7 @@ jobs:
     name: Release
     runs-on: ubuntu-latest
     needs: [checks]
-    if: startsWith(github.ref, 'refs/tags/')
+    # if: startsWith(github.ref, 'refs/tags/')
     steps:
       - uses: actions/checkout@v1
 

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022, Stichting Bellingcat
+Copyright (c) 2022, Felix Spöttel
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -39,12 +39,6 @@ pip install .
 ```
 Usage: geoclustering [OPTIONS] FILENAME
 
-  Tool to cluster geolocations. A cluster is created when a certain number of
-  points (--size) each are within a given distance (--distance) of at least
-  one other point in the cluster. Input is supplied as a csv file. At a
-  minimum, each row needs to have a 'lat' and a 'lon' column. Other rows are
-  reflected to the output.
-
 Options:
   -d, --distance FLOAT            (in km) Max. distance between two points in
                                   a cluster.  [required]
@@ -56,9 +50,6 @@ Options:
                                   Clustering algorithm to be used. `optics`
                                   produces tighter clusters but is slower.
                                   Default: dbscan
-  --open                          Open the generated visualization in the
-                                  default browser automatically.
-  --debug                         Print debug output.
   --help                          Show this message and exit.
 ```
 

geoclustering/__main__.py

@@ -1,6 +1,4 @@
-from pathlib import Path
 import click
-import os
 import webbrowser
 
 import geoclustering.clustering as clustering
@@ -8,13 +6,7 @@ import geoclustering.encoding as encoding
 import geoclustering.io as io
 
 
-def print_debug(s):
-    click.secho(s, fg="bright_black")
-
-
-@click.command(
-    help="Tool to cluster geolocations. A cluster is created when a certain number of points (--size) each are within a given distance (--distance) of at least one other point in the cluster. Input is supplied as a csv file. At a minimum, each row needs to have a 'lat' and a 'lon' column. Other rows are reflected to the output."
-)
+@click.command()
 @click.option(
     "--distance",
     "-d",
@@ -46,20 +38,9 @@ def print_debug(s):
     default="dbscan",
     help="Clustering algorithm to be used. `optics` produces tighter clusters but is slower. Default: dbscan",
 )
-@click.option(
-    "--open",
-    is_flag=True,
-    help="Open the generated visualization in the default browser automatically.",
-)
-@click.option("--debug", is_flag=True, help="Print debug output.")
 @click.argument("filename", type=click.Path(exists=True))
-def main(distance, size, output, filename, algorithm, open, debug):
-    if debug:
-        print_debug(f"Reading input from {Path(filename).absolute()}")
-
+def main(distance, size, output, filename, algorithm):
     df = io.read_csv_file(filename)
-    if debug:
-        print_debug(f"Read {len(df)} valid coordinates")
 
     clusters = clustering.cluster_locations(
         df=df, algorithm=algorithm, radius_km=distance, min_cluster_size=size
@@ -69,19 +50,14 @@ def main(distance, size, output, filename, algorithm, open, debug):
         click.echo("Did not find clusters matching input parameters.")
         return
 
-    print_debug(f"Found {len(clusters)} valid clusters using {algorithm}")
-
     encoded = encoding.encode_clusters(clusters)
 
     io.write_output_file(output, "result.txt", encoded["string"])
     io.write_output_file(output, "result.json", encoded["json"])
     io.write_output_file(output, "result.geojson", encoded["geojson"])
     vis = io.write_visualization(output, "result.html", encoded["geojson"])
-    click.echo(f"Output files saved to {Path(output).absolute()}")
 
-    if open:
-        print_debug(f"Opening visualization in default browser")
-        webbrowser.open_new_tab("file://" + str(vis.absolute()))
+    webbrowser.open_new_tab("file://" + str(vis.absolute()))
 
 
 if __name__ == "__main__":

geoclustering/clustering.py

@@ -14,6 +14,8 @@ def to_cluster_dict(df, clustering):
     """
     clusters_by_id = {}
 
+    print(clustering.labels_)
+
     for idx, cluster_id in enumerate(clustering.labels_):
         # ignore "noise" locations that don't belong to any cluster.
         if cluster_id > -1:

geoclustering/io.py

@@ -2,22 +2,9 @@ from keplergl import KeplerGl
 from pathlib import Path
 from pkg_resources import resource_filename
 import json
+import json
 import pandas as pd
 import numpy as np
-import os
-import sys
-
-
-class HiddenPrints:
-    """Disables stdout prints for a block of code."""
-
-    def __enter__(self):
-        self._original_stdout = sys.stdout
-        sys.stdout = open(os.devnull, "w")
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        sys.stdout.close()
-        sys.stdout = self._original_stdout
 
 
 def is_valid_lat(val: str) -> bool:
@@ -77,10 +64,7 @@ def write_output_file(dirname, filename, data):
 
 def write_visualization(dirname, filename, data):
     """Write a visualization, ensuring parent directories."""
-    # Hide kepler stdout output.
-    with HiddenPrints():
-        map = KeplerGl()
-
+    map = KeplerGl()
     map.add_data(data=data, name="clusters")
 
     # config configures a default color scheme for our clusters layer.
@@ -89,9 +73,6 @@ def write_visualization(dirname, filename, data):
         map.config = json.loads(f.read())
 
     filepath = ensure_file_path(dirname, filename)
-
-    # Hide kepler stdout output.
-    with HiddenPrints():
-        map.save_to_html(file_name=str(filepath), center_map=True)
+    map.save_to_html(file_name=str(filepath), center_map=True)
 
     return filepath

geoclustering/kepler_config.json

@@ -9,7 +9,7 @@
           "config": {
             "dataId": "clusters",
             "label": "clusters",
-            "color": [248, 149, 112],
+            "color": [179, 173, 158],
             "highlightColor": [252, 242, 26, 255],
             "columns": { "geojson": "_geojson" },
             "isVisible": true,
@@ -19,30 +19,16 @@
               "thickness": 0.5,
               "strokeColor": null,
               "colorRange": {
-                "name": "Uber Viz Qualitative 4",
-                "type": "qualitative",
+                "name": "Global Warming",
+                "type": "sequential",
                 "category": "Uber",
                 "colors": [
-                  "#12939A",
-                  "#DDB27C",
-                  "#88572C",
-                  "#FF991F",
-                  "#F15C17",
-                  "#223F9A",
-                  "#DA70BF",
-                  "#125C77",
-                  "#4DC19C",
-                  "#776E57",
-                  "#17B8BE",
-                  "#F6D18A",
-                  "#B7885E",
-                  "#FFCB99",
-                  "#F89570",
-                  "#829AE3",
-                  "#E79FD5",
-                  "#1E96BE",
-                  "#89DAC1",
-                  "#B3AD9E"
+                  "#5A1846",
+                  "#900C3F",
+                  "#C70039",
+                  "#E3611C",
+                  "#F1920E",
+                  "#FFC300"
                 ]
               },
               "strokeColorRange": {

geoclustering/version.py

@@ -1,5 +1,5 @@
 _MAJOR = "0"
-_MINOR = "2"
+_MINOR = "1"
 # On main and in a nightly release the patch should be one ahead of the last
 # released build.
 _PATCH = "0"

setup.py

@@ -22,7 +22,6 @@ setup(
     author_email="tech@bellingcat.com",
     license="MIT",
     packages=["geoclustering"],
-    package_data={"geoclustering": ["kepler_config.json"]},
     keywords=["cluster", "gis", "pattern-analysis"],
     entry_points={"console_scripts": ["geoclustering = geoclustering.__main__:main"]},
     install_requires=[