magnacarto

package module
Version: v1.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 17, 2021 License: Apache-2.0 Imports: 0 Imported by: 0

README

Magnacarto

Magnacarto is a CartoCSS map style processor that generates Mapnik XML and MapServer map files.

It is released as open source under the Apache License 2.0.

The development of Magnacarto is sponsored by Omniscale and development will continue as resources permit. Please get in touch if you need commercial support or if you need specific features.

Features

  • Easy to use map viewer

Magnaserv

  • Generate styles for Mapnik 2/3 and MapServer
MapServer

OSM-Bright MapServer

Mapnik

OSM-Bright Mapnik

Current status

  • Supports nearly all features of CartoCSS
    • Attachments
    • Instances
    • Classes
    • Color functions
    • Expressions
    • etc.
  • Can successfully convert complex styles (like the OSM Carto style)
Missing
  • Not all CartoCSS features are supported by the MapServer builder
  • Improved configuration
  • ...

Installation

Binary

There are binary releases available for Windows, Linux and Mac OS X (Darwin): http://download.omniscale.de/magnacarto/rel/

Source
Dependencies

You need Go>1.5 and git.

Compiling

First create a GOPATH directory for all your Go code, if you don't have one already:

mkdir -p go
cd go
export GOPATH=`pwd`

Then you need to enable GO15VENDOREXPERIMENT, if you are using Go 1.5. You can skip this if you are using 1.6 or higher:

export GO15VENDOREXPERIMENT=1

Next you can fetch the source code and build/install it:

go get -u github.com/omniscale/magnacarto
cd $GOPATH/src/github.com/omniscale/magnacarto
make install
Render Plugins

The web-frontend of Magnacarto can render map images with Mapserver and Mapnik.

Mapserver

The Mapserver plugin is already included in the default magnaserv installation and it requires the mapserv binary in your PATH on runtime.

Mapnik

The Mapnik plugin needs to be compiled as an additional binary (magnacarto-mapnik). You need to have Mapnik installed with all header files. It supports Mapnik 2.2 and 3.0. Make sure mapnik-config is in your PATH. Call make install to build the plugin binary.

Usage

magnacarto

magnacarto takes a single -mml file.

magnacarto -mml project.mml > /tmp/magnacarto.xml

To build a MapServer map file:

magnacarto -builder mapserver -mml project.mml > /tmp/magnacarto.map

See magnacarto -help for more options.

magnaserv

Magnaserv is a web-frontend for Magnacarto. Make sure the ./app directory is in your working directory or next to the magnaserv executable.

To start magnaserv on port 7070:

magnaserv

Magnaserv will search for .mml files in the current working directory or in direct sub-directories.

To start magnaserv on port 8080 with the Mapserver plugin enabled:

magnaserv -builder mapserver -listen 127.0.0.1:8080

You can configure the location of stylings, shapefiles or images, and database connection parameters with a configuration file. See example-magnacarto.tml:

magnaserv -builder mapserver -config magnacarto.tml

Documentation

See docs/examples for example files and usage instructions.

Refer to the Carto project for documentation of the CartoCSS format.

Refer to the following CartoCSS projects for larger .mml and .mss examples.

Please note that openstreetmap-carto relies on a few advanced Mapnik features that are not supported by Mapserver. Future versions of Magnacarto might work around these limitations.

Support

Please use GitHub for questions: https://github.com/omniscale/magnacarto/issues

For commercial support contact Omniscale.

Development

The latest developer documentation can be found here: http://godoc.org/github.com/omniscale/magnacarto

The source code is available at: https://github.com/omniscale/magnacarto/

You can report any issues at: https://github.com/omniscale/magnacarto/issues

Test
Unit tests
go test -short ./...
Regression tests

There are regression tests that generate Mapnik and MapServer map files, renders images and compares them. These tests require Image Magick (compare) and MapServer >=7 (shp2img).

go test ./...

Documentation

Overview

Magnacarto converts CartoCSS map styles to Mapnik and MapServer styles.

magnacarto -mml project.mml > mapnik.xml

Index

Constants

This section is empty.

Variables

View Source
var Version = "0.0.0-dev"

Version gets replaced while building with go build -ldflags "-X github.com/omniscale/magnacarto.Version 1.2.3"

Functions

This section is empty.

Types

This section is empty.

Source Files

Directories

Path Synopsis
Package builder implements converter from CartoCSS to Mapnik/MapServer styles.
Package builder implements converter from CartoCSS to Mapnik/MapServer styles.
mapnik
Package mapserver builds Mapnik .xml files.
Package mapserver builds Mapnik .xml files.
mapserver
Package mapserver builds MapServer .map files.
Package mapserver builds MapServer .map files.
sql
Package sql modifies SQL queries.
Package sql modifies SQL queries.
cmd
magnacarto
The magnacarto command converts CartoCSS to Mapnik/MapServer styles.
The magnacarto command converts CartoCSS to Mapnik/MapServer styles.
Package color implements color functions.
Package color implements color functions.
Package config implements configuration file parser for magnacarto.
Package config implements configuration file parser for magnacarto.
Package mml parses mml-YAML/JSON files.
Package mml parses mml-YAML/JSON files.
Package mss implements a CartoCSS parser and rule generator.
Package mss implements a CartoCSS parser and rule generator.
Package regression only contains regression tests for magnacarto.
Package regression only contains regression tests for magnacarto.
Package render implements map renderers baseed on Mapnik and MapServer.
Package render implements map renderers baseed on Mapnik and MapServer.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL