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.
@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 pointradius
number radius of the circlebearing1
number angle, in decimal degrees, of the first radius of the arcbearing2
number angle, in decimal degrees, of the second radius of the arcoptions
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);
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
6.2.0
After a bit of hiatus, TurfJS is resuming releases.
⭐️ Major Updates
- ES Modules available for all packages
- Tree shaking should significantly reduce import size of @turf/turf
- Better support for ESM modules (PR https://github.com/Turfjs/turf/pull/1942 - Author @diachedelic)
- Clean-up of test and benchmark running to make publishing easier
- Enforce styling using Prettier
- Enable ESLint and get rid of unused variables
- Upgrade rollup for more correct javascript module builds
- Only include ES5 code
🚀 New Modules
[@turf/boolean-touches
][boolean-touches]
Determines if two features touch but do not intersect
[@turf/boolean-valid
][boolean-valid]
Checks if the geometry is a valid according to the OGC Simple Feature Specification
[@turf/quadrat-analysis
][quadrat-analysis]
Performs a quadrat analysis on a set of points
[@turf/rectangle-grid
][rectangle-grid]
Creates a grid of rectangles from a bounding box
[@turf/voroni
][voronoi]
Typescript types for the options parameter have been fixed
(PR https://github.com/Turfjs/turf/pull/1424 - Author @stevage)
[@turf/points-within-polygon
][points-within-polygon]
Typescript types around the Feature's Properties will now be preserved.
(PR https://github.com/Turfjs/turf/pull/1761 - Author @rugheid)
[@turf/rewind
][rewind]
Typescript types for the 'reverse' option are now correct. Previously it was misnamed as 'reversed'.
(PR https://github.com/Turfjs/turf/pull/1786 - Author @jonnycornwell)
[@turf/difference
][difference]
No longer publishes an .mjs file.
[@turf/meta
][meta]
No longer publishes an .mjs file.
[@turf/tag
][tag]
Add MultiPolygon support.
(PR https://github.com/Turfjs/turf/pull/1996 - Author bryceroney)
🐛 Bug Fixes
-
@turf/centroid
Don't visit first point twice when calculating centroid
(PR https://github.com/Turfjs/turf/pull/1894 - Author @rowanwins)
-
@turf/transform-translate
Better handling of negative distances
(PR https://github.com/Turfjs/turf/pull/1895 - Author @rowanwins)
-
@turf/union
, @turf/difference
, @turf/intersect
Use polygon-clipping library to fix correctness issues
(PR https://github.com/Turfjs/turf/pull/1916 - Authors @mbullington, @ngottlieb)
-
@turf/buffer
Change default number of steps to 8, and actually support the steps option
(PR https://github.com/Turfjs/turf/pull/1931 - Author stevenchanin)
-
@turf/buffer
Fix projection issues that produce undersized buffers at non-equatorial latitudes
(PR https://github.com/Turfjs/turf/pull/1956 - Author dyakovlev)
-
@turf/helpers
Add runtime checks to point() method, fixing an API break
(PR https://github.com/Turfjs/turf/pull/1964)
🏅 New Features/Enhancements
-
@turf/boolean-overlap
Better performance for MultiPoint geometries
(PR https://github.com/Turfjs/turf/pull/1910 - Author @mfedderly)
-
@turf/helpers
Add hectares to convertArea
(PR https://github.com/Turfjs/turf/pull/1943 - Author @DanielJDufour)
-
@turf/great-circle
Update Typescript types to support MultiLineString input
(PR https://github.com/Turfjs/turf/pull/1928 - Author kronick)
📖 Documentation
-
@turf/square-grid
Clarify inputs
(PR https://github.com/Turfjs/turf/pull/1885 - Author @raphael-leger)
-
@turf/greater-circle
Clarify properties option example
(PR https://github.com/Turfjs/turf/pull/1888 - Author @chris-catignani)
⚠️ Breaking Change
-
@turf/line-to-polygon
no longer modifies its input unless the mutate option is true
(PR https://github.com/Turfjs/turf/pull/1879 - Author @MortenBirk)
-
@turf/unkink-polygon
remove Number.prototype.modulo override
(PR https://github.com/Turfjs/turf/pull/1978)