@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

lineArc

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 Coord 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
• options Object Optional parameters (optional, default {})
  • options.steps number number of steps (optional, default 64)
  • options.units string miles, kilometers, degrees, or radians (optional, default 'kilometers')

Examples

var center = turf.point([-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

6.4.0

🏅 New Features/Enhancements

• @turf/boolean-point-on-line Added an epislon option to help in floating point comparison. (PR https://github.com/Turfjs/turf/pull/2051 - Author @okcoker)

🐛 Bug Fixes

• @turf/line-slice-along Fixed a bug where the offset distance equal to the length of the line (PR https://github.com/Turfjs/turf/pull/2030 - Author @EricPKerr)

• @turf/helpers Fixed the conversion ratio for converting meters to yards and vice-versa (PR https://github.com/Turfjs/turf/pull/2046 - Author @anotherhale)

• @turf/center-median Fixed a missing TS type import (PR https://github.com/Turfjs/turf/pull/2044 - Author @Seairth)

• `@turf/bezier-spline Fix a bug ensuring the spline result reaches the end of the input (PR https://github.com/Turfjs/turf/pull/2090 - Author @the-nemz)

📖 Documentation

• @turf/transform-rotate and @turf/ellipse) Improve documentation for angle parameter (PR https://github.com/Turfjs/turf/pull/2016 - Author @pasieronen)

• @turf/line-chunk Fix an invalid anchor (PR https://github.com/Turfjs/turf/pull/2071 - Author @GraxMonzo)

• @turf/distance Enhance distance doco so supported inputs are clearer (PR https://github.com/Turfjs/turf/pull/2032 - Author @rowanwins)

🔔 Misc

• @turf/concave Replace deprecated topojson dependency (PR https://github.com/Turfjs/turf/pull/2037 - Author @elliots)

• Work towards enabling TS Strict Mode (PR https://github.com/Turfjs/turf/pull/2053 - Author @mfedderly)