locswarm

locswarm is a clustering function to find halts in time series location data. can be used for any time-series location data.

Install

npm i @intugine-technologies/locswarm

Test

npm run test

Usage

const calc_halts = require('@intugine-technologies/locswarm').all_halts;

let testData = [
	{ name: 'A', loc: [10, 10], createdAt: new Date('2020-01-01') },
	{ name: 'A', loc: [10, 10], createdAt: new Date('2020-01-02') },
	{ name: 'A', loc: [10, 10], createdAt: new Date('2020-01-03') },
	{
		name: 'B',
		loc: [100, 100],
		createdAt: new Date('2020-01-04'),
	},
	{
		name: 'B',
		loc: [100, 100],
		createdAt: new Date('2020-01-05'),
	},
	{
		name: 'C',
		loc: [500, 500],
		createdAt: new Date('2020-01-06'),
	},
	{
		name: 'C',
		loc: [500, 500],
		createdAt: new Date('2020-01-07'),
	},
	{
		name: 'C',
		loc: [500, 500],
		createdAt: new Date('2020-01-08'),
	},
	{
		name: 'D',
		loc: [1000, 1000],
		createdAt: new Date('2020-01-09'),
	},
	{
		name: 'E',
		loc: [1200, 1200],
		createdAt: new Date('2020-01-10'),
	},
];
const halts = calc_halts(
	testData.map((i) => ({
		loc: i.loc || i.gps,
		time: new Date(i.time || i.createdAt),
	})),
	1000
);
console.log(halts);

// halts = [
//     {
//       from_time: 2020-01-01T00:00:00.000Z,
//       to_time: 2020-01-03T00:00:00.000Z,
//       duration: 172800000,
//       loc: [ 10, 10 ]
//     },
//     {
//       from_time: 2020-01-04T00:00:00.000Z,
//       to_time: 2020-01-05T00:00:00.000Z,
//       duration: 86400000,
//       loc: [ 100, 100 ]
//     },
//     {
//       from_time: 2020-01-06T00:00:00.000Z,
//       to_time: 2020-01-08T00:00:00.000Z,
//       duration: 172800000,
//       loc: [ 500, 500 ]
//     }
//   ]