Package: SITSAR 1.0.0

Jodavid Ferreira

SITSAR: Information Theory, Geometry and Statistics for Synthetic Aperture Radar Data

Statistical models, information-theoretic measures and image analysis tools for Synthetic Aperture Radar (SAR) and polarimetric SAR (PolSAR) data. It implements intensity models (Gamma, generalized Gamma and G0I) and matrix models (scaled complex Wishart, G0 polarimetric and the compound truncated Poisson and compound geometric complex Wishart laws), maximum likelihood and expectation-maximization estimation, closed-form Shannon entropies with their asymptotic variances, entropy-based hypothesis tests and change detection, entropy-based image segmentation by (stochastic) expectation-maximization, stochastic distances and a family of divergence-based classifiers (Kullback-Leibler, Jeffreys, Bhattacharyya and Renyi) for Gaussian vector features and complex Wishart matrix features. The main tools are 'R6' classes and the classifiers are available as a 'parsnip' model, so they can be used inside 'tidymodels' workflows. Methods are described in Ferreira, Coelho and Nascimento (2021) <doi:10.1080/01431161.2020.1826060>, Ferreira and Nascimento (2020) <doi:10.1109/JSTARS.2020.2997666>, Ferreira, Nascimento and Frery (2022) <doi:10.3390/rs14205083> and Nascimento, Ferreira and Frery (2023) <doi:10.1007/s11222-023-10298-0>.

Authors:Jodavid Ferreira [aut, cre], Abraao Nascimento [aut]

SITSAR_1.0.0.tar.gz
SITSAR_1.0.0.zip(r-4.7-any)SITSAR_1.0.0.zip(r-4.6-any)
SITSAR_1.0.0.tar.gz(r-4.7-any)SITSAR_1.0.0.tar.gz(r-4.6-any)
SITSAR_1.0.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
SITSAR/json (API)

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

Bug tracker:https://github.com/jodavid/sitsar/issues

Pkgdown/docs site:https://jodavid.github.io

Datasets:

On CRAN:

Conda:

3.00 score 9 scripts 59 exports 35 dependencies

Last updated from:bb5ba281cb. Checks:6 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK173
source / vignettesOK238
linux-releaseOK168
windows-develOK129
windows-releaseOK130
wasm-releaseOK113

Exports:as_polsar_arrayas_polsar_vecas_tibblechange_detection_metricschange_mapCompoundWishartdcgcwdctpcwdg0idg0pdgammasardggammadistancesg0idistancesg0itabledivergence_classifierdivergence_gaussiandivergence_typedivergence_wishartDivergenceClassifierdwishart_sarentropy_g0ientropy_g0pentropy_gammaentropy_ggammaentropy_mapentropy_testentropy_wishartEntropySegmenterG0Ig0iestimationG0PolarimetricGammaSARGGammaSARglancekappa_statisticspg0ipgammasarpggammaplot_mappolsar_example_sigmaqg0iqgammasarqggammarcgcwrctpcwrenyi_kindrenyi_orderrg0irg0prgammasarrggammarwishart_sarsar_featuresSARImageSARModelsegment_sarsitsar_divergence_fittidyWishartSAR

Dependencies:clicodetoolscpp11dplyrfarvergenericsggplot2globalsgluegtablehardhatisobandlabelinglifecyclemagrittrparsnippillarpkgconfigprettyunitspurrrR6RColorBrewerrlangS7scalessparsevctrsstringistringrtibbletidyrtidyselectutf8vctrsviridisLitewithr

Divergence-based classification with tidymodels
Features | A parsnip model | Tuning the order of the Rényi divergence | Classification map | Comparing Gaussian and Wishart features | Reference

Last update: 2026-11-06
Started: 2026-11-06

Getting started with SITSAR
1. Distributions | 2. R6 models: estimation, entropy and its variance | 3. Images | 4. Entropy maps | 5. Entropy-based segmentation | 6. Hypothesis tests and change detection | 7. Divergences and classification

Last update: 2026-11-06
Started: 2026-11-06

Readme and manuals

Help Manual

Help pageTopics
Accuracy measures for change detectionchange_detection_metrics
Entropy-based change detection between two imageschange_map
Compound complex Wishart distributionscompound_wishart dcgcw dctpcw rcgcw rctpcw
Compound complex Wishart models (R6)CompoundWishart
The G0I distribution for SAR intensitiesdg0i pg0i qg0i rg0i
The G0 polarimetric distributiondg0p rg0p
The Gamma distribution for SAR intensitiesdgammasar pgammasar qgammasar rgammasar
The generalized Gamma distribution for SAR intensitiesdggamma pggamma qggamma rggamma
Stochastic distances between G0I distributionsdistancesg0i
Table of G0I stochastic distances between two image regionsdistancesg0itable
Divergence-based classifier as a 'parsnip' modeldivergence_classifier update.divergence_classifier
Divergence-based classifier for SAR/PolSAR features (R6)DivergenceClassifier
Divergences between Gaussian and complex Wishart modelsdivergences divergence_gaussian divergence_wishart
The scaled complex Wishart distributiondwishart_sar rwishart_sar
Shannon entropies of SAR and PolSAR modelsentropy entropy_g0i entropy_g0p entropy_gamma entropy_ggamma entropy_wishart
Shannon entropy mapsentropy_map
Entropy-based test for two SAR samplesentropy_test
Entropy-based segmentation by (stochastic) EM (R6)EntropySegmenter
G0I model for SAR intensities (R6)G0I
Estimation of G0I parametersg0iestimation
G0 polarimetric model for PolSAR data (R6)G0Polarimetric
Gamma model for SAR intensities (R6)GammaSAR
Generalized Gamma model for SAR intensities (R6)GGammaSAR
Kappa coefficient and overall accuracykappa_statistics
Plot a mapplot_map
Example PolSAR covariance matricespolsar_example_sigma
Convert between PolSAR storage formatsas_polsar_array as_polsar_vec polsar-format
Tuning parameters for the divergence classifierdivergence_type renyi_kind renyi_order
San Francisco PolSAR image (150 x 150 pixels)SanFrancisco150
Ground truth of the San Francisco imageSanFrancisco150_gt
Local features of SAR images for pixel classificationsar_features
SAR and PolSAR images (R6)SARImage
Base R6 class for SAR and PolSAR statistical modelsSARModel
Tidy and glance methods for SITSAR modelsglance.SARModel logLik.SARModel sarmodel-methods tidy.SARModel
Entropy-based segmentation of a SAR/PolSAR imagesegment_sar
Scaled complex Wishart model for PolSAR data (R6)WishartSAR