Alternatives: update metrics (#2259)

* Alternatives: update metrics * Add TerraTorch * Don't include coverage of test files
microsoft · Aug 30, 2024 · 16d90f2 · 16d90f2
1 parent cf52e25
commit 16d90f2
Show file tree

Hide file tree

Showing 6 changed files with 31 additions and 35 deletions.
diff --git a/docs/user/alternatives.rst b/docs/user/alternatives.rst
@@ -13,7 +13,7 @@ When deciding which library is most useful to you, it is worth considering the f
 
    Software is a living, breathing organism and is constantly undergoing change. If any of the above information is incorrect or out of date, or if you want to add a new project to this list, please open a PR!
 
-   *Last updated: 25 December 2023*
+   *Last updated: 28 August 2024*
 
 Features
 --------
@@ -22,7 +22,7 @@ Features
 
 .. csv-table::
    :align: center
-   :file: features.csv
+   :file: metrics/features.csv
    :header-rows: 1
    :widths: auto
 
@@ -55,7 +55,7 @@ These are metrics that can be scraped from GitHub.
 
 .. csv-table::
    :align: right
-   :file: github.csv
+   :file: metrics/github.csv
    :header-rows: 1
    :widths: auto
 
@@ -75,7 +75,7 @@ These are metrics that can be scraped from GitHub.
 
 **Commits**: The number of commits on the main development branch. This is another metric for how active development has been. However, this can vary a lot depending on whether PRs are merged with or without squashing first.
 
-**Core SLOCs**: The number of source lines of code in the core library, excluding empty lines and comments. This tells you how large the library is, and how long it would take someone to write something like it themselves. We use `scc <https://github.com/boyter/scc>`_ to compute SLOCs.
+**Core SLOCs**: The number of source lines of code in the core library, excluding empty lines and comments. This tells you how large the library is, and how long it would take someone to write something like it themselves. We use `scc <https://github.com/boyter/scc>`_ to compute SLOCs and exclude markdown languages from the count.
 
 **Test SLOCs**: The number of source lines of code in the testing suite, excluding empty lines and comments. This tells you how well tested the project is. A good goal to strive for is a similar amount of code for testing as there is in the core library itself.
 
@@ -86,17 +86,17 @@ These are metrics that can be scraped from GitHub.
 Downloads
 ---------
 
-These are download metrics for the project. Note that these numbers can be artificially inflated by installs during continuous integration. They give you a better idea of the number of projects that depend on a library than the number of users of that library.
+These are download metrics for the project. Note that these numbers can be artificially inflated by mirrors and installs during continuous integration. They give you a better idea of the number of projects that depend on a library than the number of users of that library.
 
 .. csv-table::
    :align: right
-   :file: downloads.csv
+   :file: metrics/downloads.csv
    :header-rows: 1
    :widths: auto
 
-**PyPI Downloads**: The number of downloads from the Python Packaging Index. PyPI download metrics are computed by `PePy <https://www.pepy.tech/>`_.
+**PyPI Downloads**: The number of downloads from the Python Packaging Index. PyPI download metrics are computed by `PyPI Stats <https://pypistats.org/>`_ and `PePy <https://www.pepy.tech/>`_.
 
-**CRAN Downloads**: The number of downloads from the Comprehensive R Archive Network. CRAN download metrics are computed by `Meta CRAN <https://cranlogs.r-pkg.org/>`_.
+**CRAN Downloads**: The number of downloads from the Comprehensive R Archive Network. CRAN download metrics are computed by `Meta CRAN <https://cranlogs.r-pkg.org/>`_ and `DataScienceMeta <https://www.datasciencemeta.com/rpackages>`_.
 
 **Conda Downloads**: The number of downloads from Conda Forge. Conda download metrics are computed by `Conda Forge <https://anaconda.org/conda-forge/>`_.
 
@@ -113,5 +113,4 @@ These are download metrics for the project. Note that these numbers can be artif
 .. _DeepForest: https://github.com/weecology/DeepForest
 .. _SITS: https://github.com/e-sensing/sits
 .. _segment-geospatial: https://github.com/opengeos/segment-geospatial
-.. _GeoTorchAI: https://github.com/wherobots/GeoTorchAI
-.. _Moonshine: https://github.com/moonshinelabs-ai/moonshine
+.. _TerraTorch: https://github.com/IBM/terratorch
diff --git a/docs/user/downloads.csv b/docs/user/downloads.csv
diff --git a/docs/user/github.csv b/docs/user/github.csv
diff --git a/docs/user/metrics/downloads.csv b/docs/user/metrics/downloads.csv
@@ -0,0 +1,9 @@
+Library,PyPI/CRAN Last Week,PyPI/CRAN Last Month,PyPI/CRAN All Time,Conda All Time,Total All Time
+`TorchGeo`_,"1,828","9,789","255,293","21,108","276,401"
+`eo-learn`_,319,"1,560","141,983","36,205","178,188"
+`Raster Vision`_,138,"652","61,938","3,254","65,192"
+`PaddleRS`_,10,36,"1,642",0,"1,642"
+`segment-geospatial`_,"1,553","7,363","117,664","18,147","135,811"
+`DeepForest`_,564,"3,652","761,520","62,869","824,389"
+`SITS`_,304,648,"12,767","78,976","91,743"
+`TerraTorch`_,259,988,"2,378",0,"2,378"
diff --git a/docs/user/features.csv → docs/user/metrics/features.csv b/docs/user/features.csv → docs/user/metrics/features.csv
@@ -1,10 +1,9 @@
 Library,ML Backend,I/O Backend,Spatial Backend,Transform Backend,Datasets,Weights,CLI,Reprojection,STAC,Time-Series
-`TorchGeo`_,PyTorch,"GDAL, h5py, laspy, OpenCV, pandas, pillow, scipy",R-tree,Kornia,71,43,✅,✅,❌,🚧
+`TorchGeo`_,PyTorch,"GDAL, h5py, laspy, OpenCV, pandas, pillow, scipy",R-tree,Kornia,82,68,✅,✅,❌,🚧
 `eo-learn`_,scikit-learn,"GDAL, OpenCV, pandas",geopandas,numpy,0,0,❌,✅,❌,🚧
 `Raster Vision`_,"PyTorch, TensorFlow*","GDAL, OpenCV, pandas, pillow, scipy, xarray",STAC,Albumentations,0,6,✅,✅,✅,✅
 `PaddleRS`_,PaddlePaddle,"GDAL, OpenCV",shapely,numpy,7,14,🚧,✅,❌,🚧
-`DeepForest`_,PyTorch,"GDAL, OpenCV, pandas, pillow, scipy",R-tree,Albumentations,0,2,❌,❌,❌,❌
-`SITS`_,R Torch,GDAL,-,tidyverse,22,0,❌,✅,✅,✅
 `segment-geospatial`_,PyTorch,"GDAL, OpenCV, pandas",geopandas,numpy,0,0,❌,✅,❌,❌
-`GeoTorchAI`_,PyTorch,"GDAL, pandas, xarray",Sedona,numpy,14,0,❌,❌,❌,🚧
-`Moonshine`_,PyTorch,-,-,numpy,0,3,❌,❌,❌,❌
+`DeepForest`_,PyTorch,"GDAL, OpenCV, pandas, pillow, scipy",R-tree,Albumentations,0,3,❌,❌,❌,❌
+`SITS`_,R Torch,GDAL,-,tidyverse,22,0,❌,✅,✅,✅
+`TerraTorch`_,PyTorch,"GDAL, h5py, pandas, xarray",R-tree,Albumentations,16,1,✅,✅,❌,🚧
diff --git a/docs/user/metrics/github.csv b/docs/user/metrics/github.csv
@@ -0,0 +1,9 @@
+Library,Contributors,Forks,Watchers,Stars,Issues,PRs,Releases,Commits,Core SLOCs,Test SLOCs,Test Coverage,License
+`TorchGeo`_,72,308,44,"2,409",419,"1,714",11,"2,074","30,761","16,058",100%,MIT
+`eo-learn`_,40,300,46,"1,108",159,638,44,"2,470","8,207","5,932",92%,MIT
+`Raster Vision`_,32,381,71,"2,046",697,"1,382",22,"3,614","22,779","9,429",90%,Apache-2.0
+`PaddleRS`_,23,89,13,374,91,116,3,644,"21,859","3,384",48%,Apache-2.0
+`segment-geospatial`_,17,281,55,"2,834",129,104,27,186,"5,598",92,22%,MIT
+`DeepForest`_,17,172,17,474,413,301,44,864,"3,357","1,794",86%,MIT
+`SITS`_,14,76,28,451,622,583,44,"6,244","24,284","8,697",94%,GPL-2.0
+`TerraTorch`_,9,10,9,121,46,92,2,243,"10,101",583,44%,Apache-2.0