# node-happytiff

**Repository Path**: mirrors_mapbox/node-happytiff

## Basic Information

- **Project Name**: node-happytiff
- **Description**: Util to detect/verify happytiffs
- **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**: 2025-11-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

##
[![travis](https://travis-ci.com/mapbox/node-happytiff.svg?branch=master)](https://travis-ci.com/mapbox/node-happytiff)

![happytiff](https://cloud.githubusercontent.com/assets/83384/5769985/4b3b8264-9cf1-11e4-81ce-3fed6d277acf.gif)

HappyTIFF
---------
A *HappyTIFF* is a [GeoTIFF](http://en.wikipedia.org/wiki/GeoTIFF) with extents that match exactly those of a web mercator ZXY tile.

This library can be used to verify that a GeoTIFF is a HappyTIFF.

`happytiff` CLI command:

    Usage: happytiff <filepath>

    # install happytiff
    sudo npm install -g @mapbox/happytiff

    # example run against a tif file
    happytiff test/fixtures/91-50-7.valid.tif
    {
      "z": 7,
      "x": 91,
      "y": 50
    }

JS API:

    var happytiff = require('@mapbox/happytiff');
    var filepath = __dirname + '/test/fixtures/91-50-7.valid.tif';

    happytiff.info(function(filepath, function(err, info) {
        console.log(info);
        // { x: 91, y: 50, z: 7 }
    });

### Source data

The test images in `test/fixtures` are open data from:

    91-50-7.valid.tif   landsat 8 composite, USGS (http://www.usgs.gov)
    invalid.tif         flanders composite, AGIV (https://www.agiv.be)