mobipy is a Python 3 library for analyzing user movement patterns from geolocated data.

mobipy brings together metrics and functions frequently used to calculate user mobility patterns. It was developed with a focus on usability and compatibility with multiple data sets, facilitating the tasks of research and data analysis.

Mobipy is tested against Python 3.6 and 3.7.

Installation

Install using pip with:

pip install mobipy

Or, download a wheel or source archive from PyPI.

Available metrics

• Radius of gyration - Measures how far a user moves from the mid point, in meters;
• Home detection - Estimates the user home location;
• User displacement distance - Calculates total user displacement distance from dataframe.;
• Group by closeness - Groups items in dataframe_a with the nearest items in dataframe_b;
• Activity centers - Calculates the activity centers by applying the DBSCAN algorithm to the dataframe.;

Using mobipy metrics

dataIdentifier = Identifier("latitude", "longitude", "local_time", "start_time", "end_time", "item_id")
path = "data.csv"
dataframe = pd.read_csv(path)
result = metrics.radius_of_gyration(dataframe=dataframe,  ##use keyword parameters
                                        				 dataIdentifier=dataIdentifier, 
                                        				 selector= Selector())