# colonel-mercator

**Repository Path**: mirrors_mapbox/colonel-mercator

## Basic Information

- **Project Name**: colonel-mercator
- **Description**: Generate raster pixel resolutions that are snapped to mercator tile resolutions.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-01-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

⚠️ This repository is no longer actively maintained by Mapbox.

##

# @mapbox/colonel-mercator

[![Build Status](https://travis-ci.org/mapbox/colonel-mercator.svg)](https://travis-ci.org/mapbox/colonel-mercator)[![Coverage Status](https://coveralls.io/repos/mapbox/colonel-mercator/badge.svg?branch=master&service=github)](https://coveralls.io/github/mapbox/colonel-mercator?branch=master)

Gets raster pixel resolutions, and optionally snaps them to `mapnik-omnivore` tiling thresholds.
Also, generates "metatile" zooms - the tile sizes at which a given input resolution would be over a size threshold based on an "upzoom" (the resolution of zoom levels "up")

![image](https://cloud.githubusercontent.com/assets/5084513/11638138/1058d900-9cda-11e5-9e77-686c4d0e176a.png)

## Install
```
npm install colonel-mercator
npm link
```

## Usage - resolution
```
colonel-mercator resolution <raster> --maxres <float> --snap
```
### Arguments
`<raster> [path]`: an input `tiff` to get the resolution of

### Options
`--maxres [float]`: the floor at which to set resolution; if `maxres` > the file's resolution, returns `maxres`. `[DEFAULT=NONE]`
`--snap [flag]`: snap to mercator tiling thresholds `[BETA]` `[DEFAULT=FALSE]`

## Usage - metatile
```
colonel-mercator metatile <resolution> --zoombreaks '[<int>, <int>, ...]' --upzoom <int>
```

### Arguments
`<resolution> [float]`: the resolution to evaluate

### Options
`--zoombreaks [array of ints]`: the metatile sizes to create `[DEFAULT=[13, 10, 7, 4]]`

`--upzoom [int]`: the number of zoom levels up at which to derive threshold from zoombreaks