Package: gdi 1.6.0

gdi: Volumetric Analysis using Graphic Double Integration

Tools implementing an automated version of the graphic double integration technique (GDI) for volume implementation, and some other related utilities for paleontological image-analysis. GDI was first employed by Jerison (1973) <ISBN:9780323141086> and Hurlburt (1999) <doi:10.1080/02724634.1999.10011145> and is primarily used for volume or mass estimation of (extinct) animals. The package 'gdi' aims to make this technique as convenient and versatile as possible. The core functions of 'gdi' provide utilities for automatically measuring diameters from digital silhouettes provided as image files and calculating volume via graphic double integration with simple elliptical, superelliptical (following Motani 2001 <doi:10.1666/0094-8373(2001)027%3C0735:EBMFST%3E2.0.CO;2>) or complex cross-sectional models. Additionally, the package provides functions for estimating the center of mass position (COM), the moment of inertia (I) for 3D shapes and the second moment of area (Ix, Iy, Iz) of 2D cross-sections, as well as for visualization of results.

Authors:Darius Nau [aut, cre]

gdi_1.6.0.tar.gz
gdi_1.6.0.zip(r-4.5)gdi_1.6.0.zip(r-4.4)gdi_1.6.0.zip(r-4.3)
gdi_1.6.0.tgz(r-4.4-any)gdi_1.6.0.tgz(r-4.3-any)
gdi_1.6.0.tar.gz(r-4.5-noble)gdi_1.6.0.tar.gz(r-4.4-noble)
gdi_1.6.0.tgz(r-4.4-emscripten)gdi_1.6.0.tgz(r-4.3-emscripten)
gdi.pdf |gdi.html
gdi/json (API)
NEWS

# Install 'gdi' in R:
install.packages('gdi', repos = c('https://theropod1.r-universe.dev', 'https://cloud.r-project.org'))

Peer review:

On CRAN:

This package does not link to any Github/Gitlab/R-forge repository. No issue tracker or development information is available.

12 exports 0.23 score 2 dependencies 14 scripts 799 downloads

Last updated 5 months agofrom:a4551fdc1b. Checks:OK: 7. Indexed: yes.

TargetResultDate
Doc / VignettesOKAug 20 2024
R-4.5-winOKAug 20 2024
R-4.5-linuxOKAug 20 2024
R-4.4-winOKAug 20 2024
R-4.4-macOKAug 20 2024
R-4.3-winOKAug 20 2024
R-4.3-macOKAug 20 2024

Exports:cscorrcsIfdetectgdihCOMimghistmeasuresilplot_silrotIsellipsesellipse.coovCOM

Dependencies:jpegpng

Estimating Center of Mass

Rendered fromestimating_COM.Rmdusingknitr::rmarkdownon Aug 20 2024.

Last update: 2024-04-22
Started: 2023-08-07

gdi

Rendered fromgdi.Rmdusingknitr::rmarkdownon Aug 20 2024.

Last update: 2023-08-07
Started: 2023-05-04

Miscellaneous Applications

Rendered frommisc.Rmdusingknitr::rmarkdownon Aug 20 2024.

Last update: 2024-04-22
Started: 2023-09-07

Readme and manuals

Help Manual

Help pageTopics
Measure and analyze cross-sectional geometry supplied as an image.cscorr
Calculates the second moment of area (=area moment of inertia, Ix and Iy) and polar moment of inertia (Iz or J) for a cross-section given as an image.csI
Tool to help determine which threshold value and method to use with measuresil() or cscorr(). The function analyzes all pixels along the edges of the image to determine the background color, to help with deciding on appropriate settings and avoid errors introduced by inappropriate settingsfdetect
Estimate volume using Graphic Double Integration.gdi
Finds the horizontal (x axis, i.e. the axis vertical to the cross-sections) position of the center of mass (COM) of the volume. Experimental; only valid for "raw" gdi results with segment volumes approximated as elliptical prisms, or for manually supplied segment COMs. COM is calculated as a weighted mean of all segment COMs, with the segment mass as the weighting factor.hCOM
Simple histogram analysis for all color values in an input image. Can be used to help assess whether a chosen threshold value is appropriate for differentiating the silhouette from the background, or for general image analysis purposes.imghist
Take pixel-by-pixel measurements of a silhouette in jpeg or png format for use with the gdi function.measuresil
Plots a silhouette read by measuresil()plot_sil
Calculates the rotational inertia of a body. Only works with simple circular/elliptical and rectangular cross-sections, thus pixel-precise estimates are recommended.rotI
Estimate area of a superellipse. Assistant function for gdi.sellipse
calculate coordinates for plotting a superellipse for visualizing body cross-sectionssellipse.coo
Finds the vertical (y axis, i.e. the axis parallel to the cross-section diameter) position of the center of mass (COM) of the volume. Experimental; only valid for "raw" gdi results with segment volumes approximated as elliptical prisms, or for manually supplied segment COMs. COM is calculated as a weighted mean of all segment COMs, with the segment mass as the weighting factor. Estimates have lower accuracy compared to hCOM, because cross-sectional geometry and variation in density throughout the cross-section is not taken into account.vCOM