https://github.com/rshipp/geodigger
Collect and filter location information from social network services.
https://github.com/rshipp/geodigger
geolocation human-mobility human-movement-analysis social-network-analysis twitter
Last synced: 3 months ago
JSON representation
Collect and filter location information from social network services.
- Host: GitHub
- URL: https://github.com/rshipp/geodigger
- Owner: rshipp
- License: bsd-3-clause
- Created: 2018-06-17T02:16:14.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2020-06-14T23:46:30.000Z (almost 6 years ago)
- Last Synced: 2025-10-18T01:10:25.005Z (8 months ago)
- Topics: geolocation, human-mobility, human-movement-analysis, social-network-analysis, twitter
- Language: Python
- Homepage: https://github.com/rshipp/geodigger/blob/master/docs/index.md
- Size: 206 KB
- Stars: 11
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
GeoDigger
=========
Collect and filter location information from social network services.
There is an optional web UI for GeoDigger
[here](https://github.com/rshipp/geodigger-ui), with some filtering
features.
[Read documentation](docs/index.md).
## Requirements
GeoDigger has only been tested on Linux. It may or may not work on
Windows or Mac OSX systems.
* Python 2.7
* MongoDB Server >= 2.4.6
### Python Modules
* Tweepy >= 2.1
* PyCrypto >= 2.6.1
* PyMongo >= 2.6.3
## Installation
To install the GeoDigger script and libraries, use:
python setup.py install
## Usage
1. Make sure you have a MongoDB server installed and running. Running
GeoDigger on the same machine as the database server is easiest, and
is recommended.
2. Obtain all the developer access secrets for the social networks you want to
use. (Currently, only Twitter is supported.)
3. Create a configuration file. See
[examples/conf/geodigger.conf](examples/conf/geodigger.conf) for an
example.
4. Run the GeoDigger script, passing in the paths to your configuration
and log files. GeoDigger will try to create the log file if it does
not already exist.
`geodigger --conf MY_CONFIG_FILE --log MY_LOG_FILE`
```
usage: geodigger [-h] [--log LOGFILE] [--config CONFIGFILE] [--source SOURCE]
[--list [LIST]]
Collect and filter location information from social network services.
optional arguments:
-h, --help show this help message and exit
--log LOGFILE file to store logs, default=geodigger.log
--config CONFIGFILE geodigger configuration file, default=geodigger.conf
--source SOURCE the social network from which to collect data
--list [LIST] list available sources
report bugs to: https://github.com/rshipp/geodigger/issues
```
## Support
To submit bug reports, use GeoDigger's GitHub
[issues](https://github.com/rshipp/geodigger/issues) page.
## Hacking
If you want to add functionality, such as support for a new social
network, see the [extending](docs/geodigger.md#extending) section of the
GeoDigger documentation. Pull requests are welcome.