Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/riatelab/magrit

Thematic cartography entirely in the browser ♥
https://github.com/riatelab/magrit

cartography d3js geography mapping maps solidjs

Last synced: 18 days ago
JSON representation

Thematic cartography entirely in the browser ♥

Host: GitHub
URL: https://github.com/riatelab/magrit
Owner: riatelab
License: gpl-3.0
Created: 2016-03-02T10:11:36.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2024-11-15T10:53:09.000Z (27 days ago)
Last Synced: 2024-11-17T04:04:22.861Z (25 days ago)
Topics: cartography, d3js, geography, mapping, maps, solidjs
Language: TypeScript
Homepage: https://magrit.cnrs.fr
Size: 273 MB
Stars: 128
Watchers: 11
Forks: 18
Open Issues: 5
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Citation: CITATION.cff
- Roadmap: ROADMAP.md
- Codemeta: codemeta.json

Awesome Lists containing this project

awesome-starred - riatelab/magrit - ♠ Thematic cartography ♠ (others)

README

        # Magrit - Thematic cartography

![Magrit - Banner](./src/assets/banner_green.jpg)

[en] [Magrit](https://magrit.cnrs.fr) is an online thematic mapping application developed by [UAR RIATE](https://riate.cnrs.fr/).  

[fr]  [Magrit](https://magrit.cnrs.fr) est une application de cartographie thématique développée par l'[UAR RIATE](https://riate.cnrs.fr/).

![GitHub Release](https://img.shields.io/github/v/release/riatelab/magrit?style=for-the-badge&color=00d1b2)

[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/9208/badge)](https://www.bestpractices.dev/projects/9208)

## Basics

- Magrit is a web application for thematic mapping (*cartography*).

- Everything happens in the browser, so **your data never leaves your computer**.

- It's intentionally simple (the UI follows the basic steps of map creation).

- It's **designed for teaching and learning cartography**.

- It lets you import **your own geometry dataset** (**Shapefile**, **GeoJSON**, **GML**, **GeoPackage**, etc.) and optionally your **tabular file** (CSV, XLS, XLSX, etc.).

- We also provide many sample datasets to try out the various representations and become familiar with the application.

- It allows you to **render and combine a wide variety of maps**: choropleth, proportional symbols, cartogram, discontinuity, smoothed maps, links, etc.

- It allows you to **customize the appearance of your maps** in various ways.

- It supports all the most popular modern desktop browsers.

- Magrit is written in modern JS and uses notably [solid.js](https://github.com/solidjs/solid) and [d3.js](https://github.com/d3/d3) libraries

  as well as various WebAssembly modules ([GDAL](https://github.com/bugra9/gdal3.js), [GEOS](https://github.com/chrispahm/geos-wasm), [Contour-wasm](https://github.com/mthh/contour-wasm), [go-cart-wasm](https://github.com/riatelab/go-cart-wasm)).

## Try it out

- Online version: [https://magrit.cnrs.fr](https://magrit.cnrs.fr)

- [Download the desktop version](https://magrit.cnrs.fr/download/)

## Examples

![Example map - Youth in Europe](./docs/public/example_map_europe_1.png)

![Example map - World wealth](./docs/public/example_map_world_wealth.png)

![Example map - Cinemas in Paris](./docs/public/example_map_cinema_paris.png)

## Latest changes

You can find the latest changes in the Changelog file, either in the source code (in [French](./docs/changelog.md) or in [English](./docs/en/changelog.md))

or directly on the Web site ([French](https://magrit.cnrs.fr/changelog.html) or [English](https://magrit.cnrs.fr/en/changelog.html)).

Information about changes are also available in the [release notes](https://github.com/riatelab/magrit/releases) of the GitHub repository.

## Development

Requirements:

- Node.js (>= 20) / NPM (>= 10).

### Installation

```bash

npm install

```

### Running for development

```bash

npm run dev

```

The application will be available at [http://localhost:3000](http://localhost:3000). 

### Running for development, with electron

```bash

npm run dev:electron

```

A window will open with the application running.

### Building for production

```bash

npm run build

```

The application and it's documentation will be built in the `dist` directory.

### Building for production, with electron

```bash

npm run build:electron

```

The application (for Windows and GNU/Linux) will be built in the `release` directory.

## Contributing to Magrit

Contributions are welcome! There are various ways to contribute to the project which are detailed in [CONTRIBUTING](CONTRIBUTING.md) file! You can notably:

- Report bugs or send us feedback.

- Add new translations or fix existing ones.

- Contribute code (you're in the right place! Clone the repo, fix what you want to be fixed and submit a pull request - note that for all non-trivial modifications, it's best to start by opening an issue to discuss it together!).

If you want to read more about what we are planning to do, you can check the [roadmap](ROADMAP.md)

of the project.

## License

GPL-3.0-or-later