oldlipe / sitsfeats

An R package to extract metrics from satellite image time series.

sitsfeats - Satellite Image Time Series Features

R package for extracting metrics from time series of satellite images

The goal of the sitsfeats package is to extract temporal metrics from satellite images time series. The metrics implemented in this version are:

• basics: statistics metrics
• polar: polar metrics

The implementations of this package are based on the stmetrics library in Python.

Installation

You can install the CRAN version with:

install.packages("sitsfeats")

Or the development version of sitsfeats from github with:

library(devtools)
devtools::install_github("oldlipe/sitsfeats")

How to use?

Polar metrics example

# loading sitsfeats and tibble packages
library(sitsfeats)
library(tibble)

# loading example time series
data("timeseries")

polar_metrics <- tibble::tibble(area_q1 = area_q1(timeseries),
                                area_q2 = area_q2(timeseries),
                                area_q3 = area_q3(timeseries),
                                area_q4 = area_q3(timeseries))

polar_metrics
#> # A tibble: 5 × 4
#>   area_q1[,1] area_q2[,1] area_q3[,1] area_q4[,1]
#>         <dbl>       <dbl>       <dbl>       <dbl>
#> 1   29443841.   14207184.   30180681.   30180681.
#> 2   28600327.   11275172.   32912031.   32912031.
#> 3   39626598.   26313817.   39566583.   39566583.
#> 4   37874557.   16023772.   34952318.   34952318.
#> 5   23932473.   15016832.   27336259.   27336259.

Polar metrics visualization

# get one instance from timeseries
one_instance <- timeseries[1,]

# plot first time series example
polar_plot(one_instance)

Getting help

Feel free to create issues if you have any questions.

sitsfeats's Issues

add texture metrics

Add github actions

Metrica MSE

• Analisar a saida

Extração de características

• RRF
• FSelector

Extrator de características GRRF

Pacotes extratores de métricas

Softwares que fazem extração de métricas:

1. stmetrics (https://github.com/brazil-data-cube/stmetrics)
2. tsfresh (https://github.com/blue-yonder/tsfresh)
3. hctsa (https://github.com/benfulcher/hctsa)
4. catch22 (https://github.com/chlubba/catch22)
5. tsfeatures (https://github.com/robjhyndman/tsfeatures)
6. feasts (https://github.com/tidyverts/feasts)
7. TSrepr (https://github.com/PetoLau/TSrepr)

Softwares que reduzem dimensionalidade

1. dimRed (https://github.com/gdkrmr/dimRed)
2. Rtsne (https://github.com/jkrijthe/Rtsne)
3. RDRToolbox (https://bioconductor.org/packages/release/bioc/html/RDRToolbox.html)

add tests

Function that calls all metrics

• Implementing a function that calls all metrics

bug in plot plot

When the distribution is short the quadrants keep the same size as the polygons.

An example can be seen in kaggle notebook

Update README

Update README with kaggle examples

Métricas revisar

• abs_sum
• kurt
• skewness

Revisar as métricas

• Revisão de métricas

Detecção de anomalia

• https://github.com/pridiltal/stray

Add support to catch22

• add catch22 metrics

Add phenological metrics

• Implement the phenological metrics provided by the timesat software.

Métrica MBR - comentários

• https://gis.stackexchange.com/questions/22895/finding-minimum-area-rectangle-for-given-points

Add README

Submit a new CRAN version

Clean code

• Improve documentation as s3 style using @rdname
• Remove comments from cpp and R code
• Delete the repeted functions
• Fix typos
• Improve cpp functions name