Git Product home page Git Product logo

coral's Introduction

CoRAL - Corner Reflector Analysis Library

Travis Coverage Status

CoRAL is a library of tools for analysing the response of corner reflectors (or other targets) in Synthetic Aperture Radar (SAR) images. The library started as a set of Python scripts developed during corner reflector prototyping experiments at Geoscience Australia. This work, and the implemented algorithms are documented in Garthwaite 2017.

Dependencies

This package requires the following:

Python==3.6
NumPy
Matplotlib
Rasterio
Jupyterlab (to use the Jupyter Notebook)

Authors

Running

An example script Calc_CR_response.py is provided, and can be executed as follows:

python3 Calc_CR_response.py

This example will calculate the Radar Cross Section (RCS) and Signal to Clutter Ratio (SCR) for a single corner reflector. Results can be viewed in the generated image files (copies are lodged in the data\ directory).

Example data

A stack of 9 example SAR images is contained in the data\ directory. The example SAR images are a set of multi-looked Sigma-0 intensity images acquired by Sentinel-1 in Interferometric Wide Swath mode. These images have been processed from Single Look Complex data using the GAMMA Remote Sensing software with 4 Looks in range and 1 Look in azimuth. Each tiff file (*.tif) contains 200*200 floating point values. Each data file has an accompanying text file (*.mli.par) containing metadata generated by the GAMMA Remote Sensing software. The example images, in descending-pass radar geometry, cover a small area cropped from the full images containing a test site "SERF" at Samford, Queensland, Australia. A corner reflector target was deployed at SERF for teaching purposes in August 2018.

Jupyter Notebook

A Jupyter notebook is included in the package that demonstrates an example CoRAL analysis using the included SAR data.

Testing

To run unit tests from within CoRAL repository directory:

python -m unittest discover tests/

License

Copyright 2018 Geoscience Australia

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

coral's People

Contributors

laurams avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

coral's Issues

Implement reader functionality for other software

E.g. the BEAM-DIMAP format used by the SNAP software.

The ENVI format (*.img and *.hdr) files are easily read with rasterio. The *.dim is an xml file containing the metadata. A reader for this *.dim file will need to be developed

Convert zeroes in intensity image to Nans

Convert zeroes in intensity image to Nan prior to performing the decibel conversion (log base 10 of a zero gives a warning like:

RuntimeWarning: invalid value encountered in log10

Use Sentinel-1 GRD image products as input

Consider whether Sentinel-1 GRD products can be directly used for this target analysis (validate against data generated from SLC via Gamma).

If they can, the advantage is that users do not need to first use some other processing software (Gamma, SNAP, etc) to generate input images for CoRAL.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.