PolSAR tools: A QGIS plugin for generating SAR descriptors

PolSAR tools: A QGIS plugin for generating SAR descriptors - Published in JOSS (2021)

https://github.com/polsartools/PolSARtools-QGIS

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 5 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org
  • Committers with academic emails
    2 of 6 committers (33.3%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords

polarimetric-decompositions polarimetric-sar-data qgis3-plugin radar-vegetation sar

Keywords from Contributors

drone
Last synced: 5 months ago · JSON representation

Repository

A QGIS plugin to generate polarimetric SAR descriptors.

Basic Info
Statistics
  • Stars: 39
  • Watchers: 6
  • Forks: 15
  • Open Issues: 0
  • Releases: 5
Topics
polarimetric-decompositions polarimetric-sar-data qgis3-plugin radar-vegetation sar
Created about 6 years ago · Last pushed 5 months ago
Metadata Files
Readme License

README.md

A QGIS plugin for processing Polarimetric Synthetic Aperture Radar (PolSAR) data.

GitHub release PolSAR_tools

📥 Downloads ⭐ Stars

Documentation Status status

GitHub commits License: GPL 3.0

General Information

This plugin generates derived SAR parameters (viz. vegetation indices, polarimetric decomposition parameters) from input polarimetric matrix (C3, T3, C2, T2). The input data needs to be in GeoTIff or PolSARpro/ENVI format (*.bin and *.hdr).

Installation

Note: PolSAR tools requires QGIS version >=3.0.

  • The easiest way (requires internet connection) :
    • Open QGIS -> Plugins -> Manage and Install Plugins... -> select All tab -> search for PolSAR tools --> select and install plugin
  • Alternative way (offline installation) :
    • Go to releases of this repository -> select desired version -> download the .zip file.
    • Open QGIS -> Plugins -> Manage and Install Plugins... -> install from ZIP tab --> select the downloaded zip --> install plugin (ignore warnings, if any).

Up and running

After successful installation, find the plugin by opening QGIS --> Plugins --> PolSAR tools --> Process. As shown in the following figure.

Opening the plugin

Opening the plugin

GUI-Main window layout

GUI-Main window layout

Layout:

  1. Data type tabs: Functions are arranged according to the data type (full-, compact- and dual-pol).
  2. Function details viewer: Contains a list of functions for respective data tab.
  3. Derived parameter selection, required input variables and constraints.
  4. Input data folder
  5. Logger: displays the log of processing parameters
  6. progressbar: shows the progress of the current task.
  7. Credits and quick help.

Additional reset button to clear the environment, view data button to import the data into QGIS environment and Process button to start processing after selecting valid input data variables.

Available functionalities:

  • Full-pol :

    • Model free 3-Component decomposition for full-pol data (MF3CF)[4]
    • Radar Vegetation Index (RVI) [8]
    • Generalized volume Radar Vegetation Index (GRVI) [2]
    • Polarimetric Radar Vegetation Index (PRVI) [1]
    • Degree of Polarization (DOP) [10]
  • Compact-pol :

    • Model free 3-Component decomposition for compact-pol data (MF3CC) [4]
    • Improved S-Omega decomposition for compact-pol data (iS-Omega) [1]
    • Compact-pol Radar Vegetation Index (CpRVI) [7]
    • Degree of Polarization (DOP) [10]
  • Dual-pol:

    • Dual-pol Radar Vegetation Index (DpRVI) [5]
    • Radar Vegetation Index (RVI) [9]
    • Degree of Polarization (DOP) [10]
    • Polarimetric Radar Vegetation Index (PRVI) [1]

Example usage

Note: All the following processing steps should be done in sequential manner. Sample data for all the polarization modes is provided in sample_data folder.

STEP 1: Open the plugin as explained in Up and Running section.

STEP 2: Select the polarimetric data type (Full/compact/dual).

Opening the plugin

Selecting the polarimetric mode

STEP 3: Select the parameter/descriptor from the dropdown menu.

Opening the plugin

Selecting the polarimetric descriptor

STEP 4: Provide the required input variables.

Opening the plugin

Selecting the input variables

STEP 5: Select the input matrix folder.

Opening the plugin

Selecting the input folder

STEP 6: Wait for the logger to prompt ->> Ready to process. --> click process

Note: Do not click process button more than once while it is processing. It may crash the QGIS and the plugin. It is possible that the plugin may show not responding for larger datasets but please wait for the process to complete.

Opening the plugin

Processing the data for selected descriptor

STEP 7 (optional): Click view data to import the data into QGIS for vizualisation of the generated descriptors.

Opening the plugin

Importing the data into QGIS for visualization

Opening the plugin

Imported data in QGIS

Citation

markdown Bhogapurapu, N., Dey, S., Mandal, D., Bhattacharya, A. and Rao, Y.S., 2021. PolSAR tools: A QGIS plugin for generating SAR descriptors. Journal of Open Source Software, 6(60), p.2970. doi: [10.21105/joss.02970](https://doi.org/10.21105/joss.02970)

```bibtex @article{bhogapurapu2021polsar, title={PolSAR tools: A QGIS plugin for generating SAR descriptors}, author={Bhogapurapu, Narayanarao and Dey, Subhadip and Mandal, Dipankar and Bhattacharya, Avik and Rao, YS}, journal={Journal of Open Source Software}, volume={6}, number={60}, pages={2970}, year={2021}, doi= {10.21105/joss.02970} }

```

References

[1] Chang, J.G., Shoshany, M. and Oh, Y., 2018. Polarimetric Radar Vegetation Index for Biomass Estimation in Desert Fringe Ecosystems. IEEE Transactions on Geoscience and Remote Sensing, 56(12), pp.7102-7108.

[2] Ratha, D., Mandal, D., Kumar, V., McNairn, H., Bhattacharya, A. and Frery, A.C., 2019. A generalized volume scattering model-based vegetation index from polarimetric SAR data. IEEE Geoscience and Remote Sensing Letters, 16(11), pp.1791-1795.

[3] Mandal, D., Kumar, V., Ratha, D., J. M. Lopez-Sanchez, A. Bhattacharya, H. McNairn, Y. S. Rao, and K. V. Ramana, 2020. Assessment of rice growth conditions in a semi-arid region of India using the Generalized Radar Vegetation Index derived from RADARSAT-2 polarimetric SAR data, Remote Sensing of Environment, 237: 111561.

[4] Dey, S., Bhattacharya, A., Ratha, D., Mandal, D. and Frery, A.C., 2020. Target Characterization and Scattering Power Decomposition for Full and Compact Polarimetric SAR Data. IEEE Transactions on Geoscience and Remote Sensing.

[5] Mandal, D., Kumar, V., Ratha, D., Dey, S., Bhattacharya, A., Lopez-Sanchez, J.M., McNairn, H. and Rao, Y.S., 2020. Dual polarimetric radar vegetation index for crop growth monitoring using sentinel-1 SAR data. Remote Sensing of Environment, 247, p.111954.

[6] Mandal, D., Ratha, D., Bhattacharya, A., Kumar, V., McNairn, H., Rao, Y.S. and Frery, A.C., 2020. A Radar Vegetation Index for Crop Monitoring Using Compact Polarimetric SAR Data. IEEE Transactions on Geoscience and Remote Sensing, 58 (9), pp. 6321-6335.

[7] V. Kumar, D. Mandal, A. Bhattacharya, and Y. S. Rao, 2020. Crop Characterization Using an Improved Scattering Power Decomposition Technique for Compact Polarimetric SAR Data. International Journal of Applied Earth Observations and Geoinformation, 88: 102052.

[8] Kim, Y. and van Zyl, J.J., 2009. A time-series approach to estimate soil moisture using polarimetric radar data. IEEE Transactions on Geoscience and Remote Sensing, 47(8), pp.2519-2527.

[9] Trudel, M., Charbonneau, F. and Leconte, R., 2012. Using RADARSAT-2 polarimetric and ENVISAT-ASAR dual-polarization data for estimating soil moisture over agricultural fields. Canadian Journal of Remote Sensing, 38(4), pp.514-527.

[10] Barakat, R., 1977. Degree of polarization and the principal idempotents of the coherency matrix. Optics Communications, 23(2), pp.147-150.

Owner

  • Name: PolSAR tools
  • Login: polsartools
  • Kind: organization

Advanced tools for Polarimetric SAR data analysis - We develop open-source Python packages and QGIS plugins for processing, and visualizing PolSAR data.

JOSS Publication

PolSAR tools: A QGIS plugin for generating SAR descriptors
Published
April 08, 2021
Volume 6, Issue 60, Page 2970
Authors
Narayanarao Bhogapurapu ORCID
Microwave Remote Sensing Lab, Centre of Studies in Resources Engineering, Indian Institute of Technology Bombay, Mumbai-400076, India
Subhadip Dey ORCID
Microwave Remote Sensing Lab, Centre of Studies in Resources Engineering, Indian Institute of Technology Bombay, Mumbai-400076, India
Dipankar Mandal ORCID
Microwave Remote Sensing Lab, Centre of Studies in Resources Engineering, Indian Institute of Technology Bombay, Mumbai-400076, India
Avik Bhattacharya ORCID
Microwave Remote Sensing Lab, Centre of Studies in Resources Engineering, Indian Institute of Technology Bombay, Mumbai-400076, India
Y. S. Rao ORCID
Microwave Remote Sensing Lab, Centre of Studies in Resources Engineering, Indian Institute of Technology Bombay, Mumbai-400076, India
Editor
Hugo Ledoux ORCID
Tags
SAR QGIS Vegetation indices Polarimetric decompositions

GitHub Events

Total
  • Delete event: 1
  • Push event: 6
  • Pull request event: 1
Last Year
  • Delete event: 1
  • Push event: 6
  • Pull request event: 1

Committers

Last synced: 5 months ago

All Time
  • Total Commits: 261
  • Total Committers: 6
  • Avg Commits per committer: 43.5
  • Development Distribution Score (DDS): 0.533
Past Year
  • Commits: 30
  • Committers: 1
  • Avg Commits per committer: 30.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Narayana-Rao n****u@g****m 122
Narayana Rao Bhogapurapu 5****o@u****m 97
Subhadip Dey s****7@g****m 30
Dipankar Mandal d****g@g****m 9
Daniel S. Katz d****z@i****g 2
Hugo Ledoux h****x@t****l 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 5 months ago

All Time
  • Total issues: 1
  • Total pull requests: 1
  • Average time to close issues: 1 minute
  • Average time to close pull requests: 1 minute
  • Total issue authors: 1
  • Total pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 1
  • Average time to close issues: 1 minute
  • Average time to close pull requests: 1 minute
  • Issue authors: 1
  • Pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • Narayana-Rao (1)
Pull Request Authors
  • Narayana-Rao (1)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

help/requirements.txt pypi
  • sphinx_rtd_theme *
  • sphinxcontrib.bibtex *
.github/workflows/draft-pdf.yml actions
  • actions/checkout v2 composite
  • actions/upload-artifact v1 composite
  • openjournals/openjournals-draft-action master composite