Deldir.jl

Julia wrapper for Delaunay/Voronoi library
Author robertdj
Popularity
5 Stars
Updated Last
6 Months Ago
Started In
February 2016

Deldir

Build Status AppVeyor codecov.io

deldir is an R package for computing Delaunay triangulations and Voronoi/Dirichlet tesselations. This Julia package wraps the Fortran code from deldir.

Usage

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.

By default, 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 voronoiarea.

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.

Delaunay & Voronoi edges

Installation

Install the package by running

]add Deldir

Details

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:

Comparison of Deldir and VoronoiCells

The script generating this output is available in the examples folder. 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)

Compiled code

To make it easier to install Deldir the Fortran code is cross-compiled using the BinaryBuilder package in a dedicated repository.

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.

Limitations

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.

Acknowledgement

Rolf Turner is author of the deldir package for R as well as all Fortran code in this package.

License

The Julia code in this package is MIT licensed and the Fortran code is licensed under GPL.

Used By Packages

No packages found.