@turf/line-arc

What is @turf/line-arc?

@turf/line-arc is a module from the Turf.js library that allows you to create circular arcs as LineString features. This can be useful for various geospatial applications, such as drawing curved paths or visualizing ranges.

What are @turf/line-arc's main functionalities?

Create a circular arc

This feature allows you to create a circular arc by specifying the center coordinates, radius, start angle, end angle, and the number of steps. The result is a LineString feature representing the arc.

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

const center = [0, 0];
const radius = 5;
const startAngle = 0;
const endAngle = 90;
const steps = 64;

const arc = turf.lineArc(center, radius, startAngle, endAngle, { steps });
console.log(arc);

Other packages similar to @turf/line-arc

d3-geo

d3-geo is a module from the D3.js library that provides geographic projections and utilities for creating and manipulating geographic data. It can be used to create arcs and other geospatial shapes, but it is more general-purpose compared to @turf/line-arc, which is specifically designed for creating circular arcs.

leaflet

Leaflet is a popular open-source JavaScript library for interactive maps. While it does not provide a direct method for creating circular arcs, it offers various plugins and utilities that can be used to achieve similar results. Leaflet is more focused on map visualization and interaction, whereas @turf/line-arc is a utility for geospatial calculations.

openlayers

OpenLayers is a high-performance, feature-packed library for creating interactive maps on the web. It provides various tools for drawing and manipulating geospatial data, including the ability to create arcs. OpenLayers is more comprehensive and versatile compared to @turf/line-arc, which is specialized for creating circular arcs.

README

@turf/line-arc

line-arc

Creates a circular arc, of a circle of the given radius and center point, between bearing1 and bearing2; 0 bearing is North of center point, positive clockwise.

Parameters

• center Feature<Point> center point
• radius number radius of the circle
• bearing1 number angle, in decimal degrees, of the first radius of the arc
• bearing2 number angle, in decimal degrees, of the second radius of the arc
• steps [number] number of steps (optional, default 64)
• units [string] miles, kilometers, degrees, or radians (optional, default kilometers)

Examples

var center = {
  "type": "Feature",
  "properties": {},
  "geometry": {
    "type": "Point",
    "coordinates": [-75, 40]
  }
}
var radius = 5;
var bearing1 = 25;
var bearing2 = 47;

var arc = turf.lineArc(center, radius, bearing1, bearing2);

//addToMap
var addToMap = [center, arc]

Returns Feature<LineString> line arc

---

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/line-arc

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

$ npm install @turf/turf

Changelog

4.1.0

New Modules

• @turf/line-arc
• @turf/polygon-to-linestring
• @turf/bbox-clip
• @turf/line-overlap

Enhancements

• added centered param to point-grid (PR: https://github.com/Turfjs/turf/pull/650)
• Single module.export helpers, invariant & meta (Commit: https://github.com/Turfjs/turf/commit/9cebb2100cf545fec49488c80140909ab54358b5)

Bug Fixes

• Turf.invariant fails on string value as coordinate (PR: https://github.com/Turfjs/turf/pull/643)
• Handle precision=0 turf-truncate (PR: https://github.com/Turfjs/turf/pull/641)
• Added radiansToDistance, distanceToRadians & distanceToDegrees to Turf core library from @turf/helpers. (Commit: https://github.com/Turfjs/turf/commit/a88d77a3e7f76860b3c138a716da8b603a407c8e)
• Removed process.hrtime in @turf/polygon-unkink(issue: https://github.com/mclaeysb/simplepolygon/issues/5)