Datasetpublic

THULab/africa_telecom_mobility_trace_datasets_nigeria

Africa Telecom Mobility Trace Datasets Nigeria (TsFile) This dataset is converted from electricsheepafrica/africa-synth-telecom-mobility-trace-datasets-nigeria to Apache TsFile format. Modalities: Time-series. Source Dataset Original dataset: electricsheepafrica/africa-synth-telecom-mobility-trace-datasets-nigeria Authors: electricsheepafrica (Hugging Face) Source license metadata: gpl Source file used for conversion: mobility_trace_datasets.parquet The source… See the full description on the dataset page: https://huggingface.co/datasets/THULab/africa_telecom_mobility_trace_datasets_nigeria.

sourceHugging Faceotherupdated 1mo agoView on Hugging Face

0likes25downloads

Dataset Card

Africa Telecom Mobility Trace Datasets Nigeria (TsFile)

This dataset is converted from `electricsheepafrica/africa-synth-telecom-mobility-trace-datasets-nigeria` to Apache TsFile format.

Modalities: Time-series.

Source Dataset

—Original dataset: `electricsheepafrica/africa-synth-telecom-mobility-trace-datasets-nigeria`
—Authors: electricsheepafrica (Hugging Face)
—Source license metadata: gpl
—Source file used for conversion: mobility_trace_datasets.parquet

The source is a synthetic Nigerian telecom mobility trace table. Each row describes one timestamped subscriber mobility observation with geographic coordinates, cell tower/city metadata, movement speed/direction, and contextual labels.

Converted Data

—Format: Apache TsFile
—File: mobility_trace_datasets.tsfile
—Row count: 500,000
—Source columns: 13 scalar columns
—Nested columns: none
—Time precision: milliseconds (ms)
—Conversion path: Java TsFile parquet tool in schema mode

TsFile Schema

Table name: mobility_trace_datasets

Role	Column	Type	Notes
Time	`timestamp`	INT64 / timestamp[ns] source	Parsed as TsFile time with millisecond precision.
TAG	`customer_id`	STRING	Subscriber / moving-entity identifier.
FIELD	`trace_id`	STRING	Trace event identifier.
FIELD	`latitude`	DOUBLE	Latitude coordinate.
FIELD	`longitude`	DOUBLE	Longitude coordinate.
FIELD	`city`	STRING	City label.
FIELD	`tower_id`	STRING	Telecom tower identifier.
FIELD	`movement_speed_kmh`	DOUBLE	Movement speed in km/h.
FIELD	`direction_degrees`	INT64	Direction angle in degrees.
FIELD	`user_density`	STRING	Density category.
FIELD	`time_of_day`	STRING	Time-of-day category.
FIELD	`day_of_week`	STRING	Day-of-week label.
FIELD	`location_type`	STRING	Location category.

Conversion Notes

—timestamp is used as the TsFile time column with millisecond precision.
—customer_id is declared as the TAG column. It is the natural subscriber/moving-entity dimension for mobility traces, and (customer_id, timestamp) is unique in the inspected source.
—All non-time source columns are preserved in the TsFile either as TAG (customer_id) or FIELD columns.
—No source columns are intentionally dropped.
—No nested columns needed flattening.

Usage

Read the TsFile with Apache TsFile tooling or SDKs. Example path in this repository:

text

mobility_trace_datasets.tsfile

Example SQL-style intent:

sql

SELECT latitude, longitude, movement_speed_kmh
FROM mobility_trace_datasets
WHERE customer_id = 'CUST4954603';