NEWS

icosa 2025-08-28

Added

The grapply() function to iterate various functions using grid rotations.
The spacing() function to measure the distance between face centers.
The meanSpacing_deg and sdSpacing_deg variables to the hexguide and triguide objects.
The trigrid() and hexagrid() constructor functions gained a spacing argument, allowing the selection of grids based on the spacing in triguide and hexguide
The vertexradius() function to measure the distance between face centers and face vertices.
The patches() and holes() functions to analyze shape patterns (methods for the trigrid (hexagrid) and facelayer classes.
General support for spatial autocorrelation of data bound to the icosahedral grids using the spdep extension package. The face2nb() function can be used to generate neighborhood list of the icosahedral grids.
data.frame-method for the arcs() function.
matrix- and data.frame-method for the rotate() function, for 3d sequential and longitude-latitude rotations. The trigrid method gained the projnote flag.
Weighted meaning for spherical centroid calculations: the surfacecentroid() function has gained the w argument
The resample() methods that result in trigrid class gained the output argument, and default to numeric. Methods for resample() with signature x="SpatRaster", y="Facelayer" are now added.
The saveOBJ() function with methods that write the 3D face and vertex informaiton trigrid and hexagrid class objects as Wavefront .obj files (note the different behavior from rgl::writeOBJ()!)

Changed

The internals of grid rotation (function rotate()) are moved to Rcpp for performance
The hexagrid-method of the surfacearea() function returns a named numeric instead of a named array (as it does for the trigrid class).
Increased the default resolution of sf-representations for coarse level grids (from 10 to 20 splits) calculated with newsf().
Completely reorganized unit testing suite.

Fixed

The occupied() function crashed when it was used to assess the coverage of spatial feature collections that had mixed type (i.e. polygons and lines).
The arcs() function returned broken arcs when missing value rows are included in the input matrix
Documentation of the surfacecentroid(), surfacearea() and trishape() functions.
Facelayer objects could not find the associated grid object in every frame.
The PolToCar() did not always copy over the rownames attribute of the input coordinate tables

Deprecated

The gridensity() function is deprecated and is succeeeded by the more general grapply()

Known issues

Warnings are produced with some trigrid objects when the grid's sf representation is created.
The grid faces (vertices that make up the faces) do not have a consistent orientation (i. e. clockwise counterclockwise). During .obj export this is corrected.

icosa 2024-08-16

Added

The arcs() function to visualize great circle paths between multiple points.
missing support of sfc-class objects for the occupied() function (OccupiedFaces method)
CITATION entry

Fixed

Grids can now be created without attaching the package
Plotting methods of loosely related data items
Issues with the defense of the arcdistmat() function

Changed

The underutilized faces() function now returns only the row names of grids and facelayer objects.

icosa 2023-03-21

Added

resample(),facelayer,SpatRaster-method
resolution based grid creation, e.g. hexagrid(deg=5)
Resolution guides for both the 'hexagrid' and 'trigrid' classes (hexguide and triguide, respectively), 120 grids each
Package webpage as URL in DESCRIPTION
Interface for the sf package.
The newsf() function
plot(),vector,trigrid-method for plotting data with sf's methods
new example data: NaturalEarth land polygons
new slot for the trigrid class for sf-type representation
occupied() - support for 'sf'-type input
the gridensity() spatial density estimator

Changed

Dependency moved to R 3.5.0 due to serialized R objects (guides)
Changed basic reference from 1980 authalic sphere to ESRI:37008
The proj4string (PROJ4) slot of trigrid was replaced by crs (sf)
plot,trigrid-method now uses the sf-type as the basis of plotting
Omitted suggested package 'raster' and replaced it with 'terra'
The occupied() function no by default returns a named vector
The vignettes are now html vignettes
the 'tessguide' object is renamed to 'hexguide'

Removed

Dependency on raster and rgdal
OSM z1 land polygons

icosa 2021-01-12

Changed

fixed warnings when the spherical datum of the grids were loaded
added checks for the suggested rgl package
minor documentation changes

icosa 2020-02-15

Changed

vignette was cut for performance optimization
documentation was systematically revised

icosa 2020-02-09

Added

documentation for the 'tessguide' dataset
'legend' argument to faces3d method of facelayer

Changed

the locate() function's main arguments were renamed to 'x' and 'y' with S4 dispatch for 'y'
the surfacecentroid() function is rewritten with S4 method dispatch, with main argument of 'x'
corrected roxygen tags for S3 methods
minor documentation corrections, package ready for CRAN resubmission

Added

long at lat arguments to the CarToPol() function's data.frame-method

Changed

CarToPol() and PolToCar() functions rewritten with S4 method dispatch
main function argument of CarToPol() and PolToCar() is now 'x' instead of 'longLatMat' and 'matXYZ'

icosa 2020-02-04

Added

proper usage (roxygen tags before "function") for triggering help files in case of namespace conflicts.

Changed

Reorganization of Roxygen tags: removed all aliases, -method bullshit

Changed

rgl package moved to Suggests from Depends, freeing the package from its grasp
plot3d() rewritten as S3 from S4
rgl dependent functions have warnings to instruct installation.

Added

Collate field for DESCRIPTION

Changed

R file structure

icosa 2020-02-03

Added

conditional generic declaration to values<-
conditional generic declaration to resample()
conditional generic declaration to values()
conditional generic declaration to rotate()

Changed

complete NAMESPACE cleanup with roxygen
package 'raster' moved from 'Imports' to 'Suggests'

Removed

old vignette

icosa 2019-08-20

Added

Dynamic sp resolution setting
proper NEWS file
suppressed warnings when triangles are produced
'breaks', 'inclusive', 'discrete' arguments added for facelayer plotting method.

Changed

The default colour value of the facelayer plotting function is changed to 'heat'.
The heatmap generation of the facelayer plotting methods is completely rewritten.
The default of 'alpha' of the facelayer-plotting argument is changed to NULL.

Removed

the minVal and maxVal argument of heatMapLegend()

Fixed

Bug in the heatMapLegend() function that cause the legend to miss the last colour.

icosa 2019-05-02

Fixed

Proper projection treatment during the 3d plotting of sp-type objects. (Thanks to Dominik Jaskierniak for reporting the error).

Added

The 'radius' argument is added to the rgl-extension 3d plotting functions.

Removed

The 'inner' argument of the surfacecentroid() and chullsphere() functions is deprecated.

icosa 2019-03-05

Added

the cellocator() function
added the namedorder argument of the vicinity() function

icosa 2018-12-03

Added

the strict argument to the chulshere() function - unfinished!
the tessellation guide (tessguide) object is added to the package

icosa 2018-10-27

Added

'legend' argument for the facelayer method of 'plot()', to disable the plotting of the legend
the surfacechullsphere() function to calculate areas of spherical convex hulls

icosa 2018-09-27

Rebuilt from previous version.

Changed

vignette structure update
vignette now uses z1 OpenStreetMap land polygons instead of z3
the package no longer requires the 'rgdal' package, which is only used for projection changes

Fixed

added compatibility for up-to-date Rcpp versions
explicit self-assignment compilation warning with clang 7.0.0

Known issues

warnings produced by sp::Polygons function - will be corrected shortly

icosa 2017-04-18

Fixed

memory deallocation issues
SpPolygons(): zenith/nadir face issue
unnecessary 'rgdal' namespace import

icosa 2017-04-17

Added

the locate() function was updated to version 6.0, now incorporating the 'randomborders' argument
the occupied() function was rebuilt on the locate() function
the centers() shorthand was added to the quick extraction of the facecenters
major work on the help files
the value replacement method of the gridlayer was extended to host lat/long indicators
added logical subsetting to the facelayer
bugfix for the x86 application of SpPolygons()

icosa 2017-04-09

Added

igraph is added as related content
the function gridgraph() is implmented for 'trigrid' and for 'facelayer' classes
fixed bug in OccupiedFaces() for SpatialPolygons
the @graph slot has been added to the 'trigrid' class to host 'igraph' class graph representations
package namespace is cleaned up to include only importing namespaces, only the rgl package is a dependency
the newgraph() function is added to the package
added an Rcpp function to interpolate 3d lines
the gridgraph() function is added for the 'hexagrid' class, and the class constructor is upgraded to include it
the vicinity() function replaced the neighbours() function
the class of the values is now printed to the console, when the show method of the facelayer is called
the tesselation and class of the source grid is now added to the gridlayer class, along with a function that checks the linked grid's compatibility to the facelayer
the translate() function is added to the package for fast reposition of translated grids to the origin
the chullsphere() and surfacecentroid() functions were added to the packages
resampling methods were added for the 'hexagrid'
igraph representation was added to the vignette

icosa 2017-02-17

Added

the shapes() function is added to the package. It will calculate a value that is proportional to the irregularities of the triangular faces or subfaces.
character values in facelayers will be plotted with random colors
rgdal dependecy of spTransorm() was properly resolved
the missing belts slot of the hexagrid class was filled
fixed missing invalid input message for PolToCar() function.
grid resolution is now displayed with the show() method.
the group generics Ops, Math, and Summary were implemented for the facelayer.
basic functions of the 'stats' packages were implemented
latitude and longitude-wise selection was implemented to the facelayer subsetting method
resampling of 'facelayer' objects to based on 'trigrid' classes was applied in the program: downscaling
added 2d plotting scheme for 'facelayers', where the values of the facelayer are exclusively colours

Deleted

the deprecated argument "border" is no longer available for the user interface of locate()

icosa 2016-11-25

Notes

Pre-alpha versions were not registered.