@turf/square-grid

What is @turf/square-grid?

@turf/square-grid is a module from the Turf.js library that allows you to create a grid of squares within a bounding box. This can be useful for various geospatial analyses, such as dividing a region into smaller areas for detailed study or visualization.

What are @turf/square-grid's main functionalities?

Create a square grid

This feature allows you to create a grid of squares within a specified bounding box. The `bbox` parameter defines the bounding box, `cellSide` specifies the side length of each square, and `options` can include units of measurement.

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

const bbox = [-95, 30, -85, 40];
const cellSide = 50;
const options = { units: 'miles' };
const squareGrid = turf.squareGrid(bbox, cellSide, options);
console.log(squareGrid);

Other packages similar to @turf/square-grid

leaflet

Leaflet is a popular open-source JavaScript library for mobile-friendly interactive maps. While it does not specifically create square grids, it offers extensive functionalities for creating and manipulating map layers, including grid layers.

d3-geo

D3-geo is a module of D3.js that provides geographic projections, shapes, and utilities. It can be used to create various types of geographic visualizations, including grids, but requires more manual setup compared to @turf/square-grid.

geotiff

GeoTIFF is a library for reading and writing GeoTIFF files. While it does not create square grids, it can be used to manipulate geospatial raster data, which can be divided into grids for analysis.

README

@turf/square-grid

squareGrid

Creates a square grid from a bounding box, Feature or FeatureCollection.

Parameters

• bbox (Array<number> | FeatureCollection | Feature<any>) extent in [minX, minY, maxX, maxY] order
• cellSize number width of each cell
• units [string] used in calculating cellSize, can be degrees, radians, miles, or kilometers (optional, default kilometers)
• completelyWithin [boolean] adjust width & height cellSize to fit exactly within bbox (optional, default false)

Examples

var bbox = [-95, 30 ,-85, 40];
var cellSize = 50;
var units = 'miles';

var squareGrid = turf.squareGrid(bbox, cellSize, units);

//addToMap
var addToMap = [squareGrid]

Returns FeatureCollection<Polygon> grid a grid of polygons

---

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/square-grid

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

$ npm install @turf/turf

Changelog

4.4.0

🚀 New Modules

• @turf/line-offset Adds a new lineOffset module as per this issue. Basically takes an input line and returns a new line offset by the distance. (PR https://github.com/Turfjs/turf/pull/729 - Author @rowanwins)
• @turf/polygonize Polygonizes (Multi)LineString(s) into Polygons. Implementation of GEOSPolygonize function (geos::operation::polygonize::Polygonizer). (PR https://github.com/Turfjs/turf/pull/767 - Author @NickCis)
• @turf/transform-rotate Rotates any geojson Feature or Geometry of a specified angle, around its centroid or a given pivot point; all rotations follow the right-hand rule. (Issue https://github.com/Turfjs/turf/issues/747 - Author @stebogit)
• @turf/transform-translate Moves any geojson Feature or Geometry of a specified distance along a Rhumb Line on the provided direction angle. (Issue https://github.com/Turfjs/turf/issues/747 - Author @stebogit)
• @turf/transform-scale Scale a GeoJSON from a given point by a factor of scaling (ex: factor=2 would make the GeoJSON 200% larger). If a FeatureCollection is provided, the origin point will be calculated based on each individual Feature. (Issue https://github.com/Turfjs/turf/issues/747 - Author @stebogit)

🏅 New Features

• Support z-coordinate as input for @turf/turf-tin (PR https://github.com/Turfjs/turf/pull/772)
• Adds properties parameter to @turf/centroid and @turf/center (PR https://github.com/Turfjs/turf/pull/769)
• Include Yarn.lock for all modules & Lerna uses Yarn (Issue https://github.com/Turfjs/turf/issues/704, https://github.com/Turfjs/turf/issues/765, PR https://github.com/Turfjs/turf/pull/766)
• Use Tap at root which enables code coverage reports (Issue https://github.com/Turfjs/turf/issues/328 & PR https://github.com/Turfjs/turf/pull/762)
• Support z-coordinate as input for @turf/pointplane (PR https://github.com/Turfjs/turf/pull/754)
• Add core tests - file management & package.json rules (PR https://github.com/Turfjs/turf/pull/749 & https://github.com/Turfjs/turf/pull/756)

🐛 Bug Fixes

• Website http://turfjs.org is back up and running (Issue https://github.com/Turfjs/turf/issues/777)
• @turf/rhumb-destination issue at 180th meridian (Issue https://github.com/Turfjs/turf/issues/770 & PR https://github.com/Turfjs/turf/pull/771)
• Getting too large numbers for Longitude (Issue https://github.com/Turfjs/turf/issues/758 & PR https://github.com/Turfjs/turf/pull/763)
• Throw error if FeatureCollection not array #751 (PR https://github.com/Turfjs/turf/pull/760)
• Change default param coordinates to 3 @turf/truncate (PR https://github.com/Turfjs/turf/pull/757)
• along returns a point that is not found by @turf/point-on-line (Issue https://github.com/Turfjs/turf/issues/691)
• Fix location of intersect point for @turf/point-on-line. (PR https://github.com/Turfjs/turf/pull/750)
• Handle empty geometries as undefined @turf/buffer (PR https://github.com/Turfjs/turf/pull/746)