# agentmaps

> Geospatial agent-based modeling extension for Leaflet.

Latest version **2.2.2** (published 2018-11-08) · BSD-2-Clause license · 0 weekly downloads

## Install

```sh
npm install agentmaps
pnpm add agentmaps
yarn add agentmaps
bun add agentmaps
```

Provides the command `featuretool`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; large bundle.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.2.2 |
| Published | 2018-11-08 |
| First published | 2018-06-05 |
| Weekly downloads | 0 |
| License | BSD-2-Clause |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 17 |
| Unpacked size | 16.9 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 967 |
| Author | Andrew Gregory Tsesis |
| Maintainers | noncomputable |
| Keywords | agent-based, modeling, simulation, GIS, geographic, spatial |

## Links

- npm: https://www.npmjs.com/package/agentmaps
- Repository: https://github.com/noncomputable/AgentMaps
- Homepage: https://github.com/noncomputable/AgentMaps#readme
- Issues: https://github.com/noncomputable/AgentMaps/issues
- npm.io page: https://npm.io/package/agentmaps

## Dependencies (17)

- [leaflet](https://npm.io/package/leaflet.md) ^1.3.4
- [optimist](https://npm.io/package/optimist.md) ^0.6.1
- [@turf/along](https://npm.io/package/@turf/along.md) ^6.0.1
- [ngraph.path](https://npm.io/package/ngraph.path.md) ^1.0.2
- [@turf/buffer](https://npm.io/package/@turf/buffer.md) ^5.1.5
- [@turf/length](https://npm.io/package/@turf/length.md) ^6.0.2
- [ngraph.graph](https://npm.io/package/ngraph.graph.md) 0.0.14
- [@turf/bearing](https://npm.io/package/@turf/bearing.md) ^6.0.1
- [@turf/helpers](https://npm.io/package/@turf/helpers.md) ^6.1.4
- [@turf/centroid](https://npm.io/package/@turf/centroid.md) ^6.0.2
- [@turf/intersect](https://npm.io/package/@turf/intersect.md) ^6.1.3
- [@turf/line-slice](https://npm.io/package/@turf/line-slice.md) ^5.1.5
- [@turf/destination](https://npm.io/package/@turf/destination.md) ^6.0.1
- [@turf/line-distance](https://npm.io/package/@turf/line-distance.md) ^4.7.3
- [@turf/line-intersect](https://npm.io/package/@turf/line-intersect.md) ^6.0.2
- [@turf/nearest-point-on-line](https://npm.io/package/@turf/nearest-point-on-line.md) ^6.0.2
- [@turf/boolean-point-in-polygon](https://npm.io/package/@turf/boolean-point-in-polygon.md) ^6.0.1

## Alternatives

- [d3-force-3d](https://npm.io/package/d3-force-3d.md) — 1.0M weekly downloads
- [ng2-charts](https://npm.io/package/ng2-charts.md) — 486.8K weekly downloads
- [@arcgis/core](https://npm.io/package/@arcgis/core.md) — 257.8K weekly downloads
- [react-sparklines](https://npm.io/package/react-sparklines.md) — 249.3K weekly downloads
- [react-native-gifted-charts](https://npm.io/package/react-native-gifted-charts.md) — 182.3K weekly downloads

## Recent versions

- 2.2.2 (latest) — 2018-11-08
- 2.2.1 — 2018-11-08
- 2.2.0 — 2018-09-27
- 2.1.3 — 2018-09-13
- 2.1.2 — 2018-09-02
- 2.1.1 — 2018-09-02
- 2.1.0 — 2018-09-02
- 2.0.5 — 2018-09-01
- 2.0.4 — 2018-08-31
- 2.0.3 — 2018-08-31
- 2.0.2 — 2018-08-30
- 2.0.1 — 2018-08-30
- 1.0.1 — 2018-06-05
- 1.0.0 — 2018-06-05

## README

# AgentMaps - Social Simulations on Interactive Maps

<img src="resources/agentgif.gif" width="500" height="387" />

AgentMaps is a Javascript library for building and visualizing dynamic social systems on maps.
It is based on the [Leaflet](https://leafletjs.com/) interactive mapping [library](https://github.com/Leaflet/Leaflet).
Given a neighborhood, AgentMaps lets you quickly and easily:

* Build units along the streets.
* Spawn agents onto the map.
* Schedule them to move between places on the map.
* Change their appearance and properties.

AgentMaps lets you turn this:

<img src="resources/noagentmaps.png" width="500" height="387" />

into something like this:

<img src="resources/agentmaps.png" width="500" height="387" />

You can install it via npm (`npm install agentmaps`) and bundle it yourself, or you can get a premade bundle [here](https://unpkg.com/agentmaps@2/site/dist/agentmaps.js) to include directly in a webpage. 
You'll need to [include Leaflet](https://leafletjs.com/download.html) separately.

### Documentation

Docs for people who want to use AgentMaps are available [here](https://noncomputable.github.io/AgentMaps/docs/index.html).

Docs for people who want to understand its internals are [here](https://noncomputable.github.io/AgentMaps/devdocs/index.html).

A basic walkthrough for creating an AgentMaps simulation can be found [here](https://noncomputable.github.io/AgentMaps/docs/tutorial-quickstart.html). 

### Demos

[Simple](https://noncomputable.github.io/AgentMaps/demos/simple/simple.html): Shows all the different ways agents can travel around a map.

<!--[Epidemic](https://noncomputable.github.io/AgentMaps/demos/epidemic/epidemic.html): Agents commute between different parts of a neighborhood while an infection spreads between them.

You can find the corresponding code under _/demos_ in the gh-pages branch [here](https://github.com/noncomputable/AgentMaps/tree/gh-pages/demos).!-->

### Plugins

[IconAgents](https://github.com/noncomputable/AgentMaps-IconAgents): Lets you depict agents with custom icons instead of circles. 

---

Thank you to anyone who somehow benefits from this.

**AgentMaps: Geospatial Agent-based Modeling and Simulation for JavaScript.**

---
_Source: https://npm.io/package/agentmaps · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
