{"repo":"bellingcat/ShadowFinder","free":true,"listed":false,"github":"https://github.com/bellingcat/ShadowFinder","clone":"git clone https://github.com/bellingcat/ShadowFinder.git","description":"Find possible locations of shadows around the world","language":"Python","stars":599,"topics":["command-line","geolocation","notebook","open-source-research","python"],"license":"MIT","category":"cli-tools","readme_excerpt":"ShadowFinder A lightweight tool and Google Colab notebook for estimating the points on the Earth's surface where a shadow of a particular length could occur, for geolocation purposes. Using an object's height, the length of its shadow, the date and the time, ShadowFinder estimates the possible locations where that shadow could occur. These possible locations are shown as a bright band on a map of the Earth: Usage - Google Colab Notebook 🚀 No installation necessary, just try it out using the Google Colab notebook here! Installation :magic wand: ShadowFinder is built with the interactive notebook in mind, which can be downloaded and used in a local Jupyter environment, the package also provides a Python API and a command-line interface. ShadowFinder is published on PyPi so can be installed via pip with: Usage - Python Library 🐍 If you want to use ShadowFinder directly from Python, the usage is as follows. Usage - Command Line Interface 🐌 [!IMPORTANT] Using the CLI is not the recommended way of using ShadowFinder as it is quite slow (there is currently not a caching strategy for the timezone grid, so this is generated every run which is resource intesive) Where the arguments are OBJECT HEIGHT , SHADOW LENGTH , DATE , and TIME respectively. You can also use the angle to the sun directly (above the horizon, in degrees): Where the arguments are SUN ALTITUDE ANGLE , DATE , and TIME respectively. More complete help information can be found by running: Development :octocat: Expand ","default_branch":null,"files":null,"tree":[],"storefront":"/r/bellingcat","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/bellingcat/ShadowFinder/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}