deldir is an R package for computing Delaunay triangulations and Voronoi/Dirichlet tesselations. This Julia package wraps the Fortran code from deldir.
The coordinates of the generators are specified as two vectors that are fed to
deldir, the main function of this package:
x = rand(8) y = rand(8) del, vor, summ = deldir(x, y)
The output from
deldir are three DataFrames:
One for the topology of the Delaunay triangulation; one for topology of the Voronoi tesselation; one with a summary mainly related to the area of the triangles and Voronoi cells.
deldir works with points in the unit rectangle, but other bounding rectangles can be specified as a third argument.
The area of the Voronoi cells are also available directly with the function
Two functions are available to extract the edges of the Delaunay triangles and Voronoi cells in a "plot friendly" manner:
Dx, Dy = edges(del) Vx, Vy = edges(vor)
Using the results from above this can be plotted using e.g. the Plots package:
using Plots scatter(x, y, xlim = (0,1), ylim = (0,1), markersize = 6, label = "generators") plot!(Dx, Dy, label = "Delaunay") plot!(Vx, Vy, style = :dash, label = "Voronoi")
One realization looks like the following.
Install the package by running
There are other Julia package for interacting with Voronoi cells and Delaunay triangulations. The deldir R package has been around for a long time and therefore it is my hope that the Fortran code give correct results. Furthermore, deldir has two qualities I value:
- It interacts well with the bounding box.
- It returns the area of the Voronoi cells in the same order as the input generators.
I am also the author of the pure Julia package VoronoiCells with similar functionalities.
The VoronoiCells package executes much faster.
Consider the time taken to run the
voronoiarea functions of both packages with an increasing number of points:
The script generating this output is available in the
The comparison plot is made with
julia> versioninfo() Julia Version 1.1.0 Commit 80516ca202* (2019-01-21 21:24 UTC) Platform Info: OS: Linux (x86_64-linux-gnu) CPU: Intel(R) Core(TM) i5-8265U CPU @ 1.60GHz WORD_SIZE: 64 LIBM: libopenlibm LLVM: libLLVM-6.0.1 (ORCJIT, skylake)
I am not using the latest version of the Fortran code, because the cross-compilation fails on macOS from version 0.1-16 and onwards. I do not have access to a contemporary Mac, so it is difficult for me to troubleshoot the issue. If you are using a Mac and would like newer features you are welcome to submit a pull request. The changelog for the R package may provide guidance to what happened.
Not all features of the R package are available. I have e.g. chosen to ignore options regarding dummy points.
Are you missing anything important? Check out the manual for the R package to see if the Fortran library supports it.
Rolf Turner is author of the deldir package for R as well as all Fortran code in this package.
The Julia code in this package is MIT licensed and the Fortran code is licensed under GPL.