@turf/mask

What is @turf/mask?

@turf/mask is a module in the Turf.js library that allows you to create a mask from a polygon. This mask can be used to clip or hide parts of other geometries that fall outside the polygon. It is particularly useful in geospatial analysis for focusing on specific areas of interest.

What are @turf/mask's main functionalities?

Create a Mask

This feature allows you to create a mask from a given polygon. The mask can then be used to clip other geometries, effectively hiding parts of them that fall outside the polygon.

const turf = require('@turf/turf');

const polygon = turf.polygon([[
  [-5, 52],
  [-4, 52],
  [-4, 53],
  [-5, 53],
  [-5, 52]
]]);

const mask = turf.mask(polygon);
console.log(JSON.stringify(mask));

Clip Geometry with Mask

This feature demonstrates how to use the mask to clip a line geometry. The resulting geometry will only include the parts of the line that fall within the mask polygon.

const turf = require('@turf/turf');

const polygon = turf.polygon([[
  [-5, 52],
  [-4, 52],
  [-4, 53],
  [-5, 53],
  [-5, 52]
]]);
const mask = turf.mask(polygon);

const line = turf.lineString([[-6, 51], [-3, 54]]);
const clipped = turf.mask(line, mask);
console.log(JSON.stringify(clipped));

Other packages similar to @turf/mask

turf-clip

The turf-clip package provides functionalities to clip geometries using polygons. It is similar to @turf/mask but focuses more on clipping rather than masking.

jsts

The jsts (JavaScript Topology Suite) library offers a wide range of spatial operations, including clipping and masking. It is more comprehensive than @turf/mask but also more complex to use.

geojson-merge

The geojson-merge package allows you to merge multiple GeoJSON objects into one. While it doesn't offer masking directly, it can be used in conjunction with other tools to achieve similar results.

README

@turf/mask

mask

Takes any type of polygon and an optional mask and returns a polygon exterior ring with holes.

Parameters

• polygon (FeatureCollection | Feature<(Polygon | MultiPolygon)>) GeoJSON Polygon used as interior rings or holes.
• mask [Feature<Polygon>] GeoJSON Polygon used as the exterior ring (if undefined, the world extent is used)

Examples

var polygon = turf.polygon([[[112, -21], [116, -36], [146, -39], [153, -24], [133, -10], [112, -21]]]);
var mask = turf.polygon([[[90, -55], [170, -55], [170, 10], [90, 10], [90, -55]]]);

var masked = turf.mask(polygon, mask);

//addToMap
var addToMap = [masked]

Returns Feature<Polygon> Masked Polygon (exterior ring with holes).

---

This module is part of the Turfjs project, an open source module collection dedicated to geographic algorithms. It is maintained in the Turfjs/turf repository, where you can create PRs and issues.

Installation

Install this module individually:

$ npm install @turf/mask

Or install the Turf module that includes it as a function:

$ npm install @turf/turf

Changelog

4.6.0

🚀 New Modules

• @turf/clean-coords Removes redundant coordinates from any GeoJSON Geometry. (PR https://github.com/Turfjs/turf/pull/875 - Author @stebogit)
• @turf/interpolate Takes a set of points and estimates their 'property' values on a grid using the Inverse Distance Weighting (IDW) method.. (PR https://github.com/Turfjs/turf/pull/832 - Author @stebogit)
• @turf/clusters-dbscan Takes a set of Points and partition them into clusters according to DBSCAN's data clustering algorithm. (PR https://github.com/Turfjs/turf/pull/812 and https://github.com/Turfjs/turf/pull/851 - Author @DenisCarriere)

  special mention to this incredibly instructive and fun interactive map by @DenisCarriere 😎👏

• @turf/clusters Provides getCluster, clusterEach, and clusterReduce functions. (PR https://github.com/Turfjs/turf/pull/847 - Author @DenisCarriere)
• @turf/boolean-point-on-line Returns true if a point is on a line. Accepts a optional parameter to ignore the start and end vertices of the linestring. (PR https://github.com/Turfjs/turf/pull/858 - Author @rowanwins)
• @turf/boolean-overlap Takes two features and returns true or false whether or not they overlap, i.e. whether any pair of edges on the two polygons intersect. If there are any edge intersections, the polygons overlap. (PR https://github.com/Turfjs/turf/pull/856 and https://github.com/Turfjs/turf/pull/868 - Author @stebogit @tcql)
• @turf/boolean-equal Determine whether two geometries of the same type have identical X,Y coordinate values. (PR https://github.com/Turfjs/turf/pull/869 - Author @stebogit @tcql)

🏅 New Features/Enhancements

• Sets centered param default to true in @turf/point-grid (PR https://github.com/Turfjs/turf/pull/836 - Contributor @stebogit)
• Adds MultiLineString support for @turf/point-on-line (PR https://github.com/Turfjs/turf/pull/838 - Contributor @stebogit)
• Renames @turf/clusters => @turf/clusters-kmeans, plus adds deprecated warning message to @turf/clusters@4.5.2 (See Issue https://github.com/Turfjs/turf/issues/845)
• Changes output type of @turf/clusters-kmeans (See Issue https://github.com/Turfjs/turf/issues/850 - Contributor @DenisCarriere)
• Adds segmentEach and segmentReduce functions to @turf/meta (See Issue https://github.com/Turfjs/turf/issues/850 - Contributor @DenisCarriere)
• Adds tests and linting on JSDoc in TurfJS core from turf-www; see Issue https://github.com/Turfjs/turf/issues/859 (PR https://github.com/Turfjs/turf/issues/857 + https://github.com/Turfjs/turf/issues/864 + https://github.com/Turfjs/turf/issues/870 - Contributor @DenisCarriere @stebogit)
• Introduces null Geometry support across TurfJS modules (See Issue https://github.com/Turfjs/turf/issues/853) (PR https://github.com/Turfjs/turf/issues/866 - Contributor @DenisCarriere)
• Includes feature(Sub)Index in coordEach/coordReduce (@turf/meta) 🎉 (PR https://github.com/Turfjs/turf/issues/872 - Contributor @DenisCarriere)
• Adds bbox and id params plus geometry method to @turf/helpers (PR https://github.com/Turfjs/turf/issues/877 - Contributor @DenisCarriere)

🐛 Bug Fixes

• Applies @turf/truncate to @turf/line-split splitter input to avoid approximation errors. Fixed #852 (PR https://github.com/Turfjs/turf/pull/855)
• Fixes @turf-mask error (See Issue https://github.com/Turfjs/turf/issues/837) (PR https://github.com/Turfjs/turf/pull/865 - Contributor @thiagoxvo)
• Fixes create-new-module script error on LICENSE file creation (See Issue https://github.com/Turfjs/turf/issues/861) (commit df6986e)
• Fixes @turf/isobands error on commonProperties (See Issue https://github.com/Turfjs/turf/issues/831) (commit 1663f07)