Description Usage Arguments Details Value References
Uses one of four cloud removal algorithms (see cloud_remove
)
to remove thick clouds from Landsat imagery. In hilly areas, topographic
correction should be done before cloud fill.
1 2 3 4 |
data_dir |
folder where input images are located, with filenames as
output by the |
wrspath |
World Reference System (WRS) path |
wrsrow |
World Reference System (WRS) row |
start_date |
start date of period from which images will be chosen to
fill cloudy areas in the base image (as |
end_date |
end date of period from which images will be chosen to fill
cloudy areas in the the base image (as |
out_name |
base filename (without an extension - see |
base_date |
ideal date for base image (base image will be chosen as the image among the available images that is closest to this date). If NULL, then the base image will be the image with the lowest cloud cover. |
tc |
if |
ext |
file extension to use when searching for input rasters and when
saving output rasters (determines output file format). Should match file
extension of input rasters (and should most likely match the value chosen
for |
sensors |
choose the sensors to include when selecting images (useful for excluding images from a particular satellite if desired). Can be any of "L4T", "L5T", "L7E", and/or "L8C". |
img_type |
type of Landsat imagery to preprocess. Can be "CDR" for
Landsat Climate Data Record (CDR) imagery in HDR format, or "L1T" for
Standard Terrain Correction (Level 1T) imagery. Note that if L1T imagery is
used, fmask must be run locally (see https://code.google.com/p/fmask) prior
to using |
threshold |
maximum percent cloud cover allowable in base image. Cloud
fill will iterate until percent cloud cover in base image is below this
value, or until |
max_iter |
maximum number of times to run cloud fill script |
notify |
notifier to use (defaults to |
verbose |
whether to print detailed status messages. Set to FALSE or 0 for no status messages. Set to 1 for basic status messages. Set to 2 for detailed status messages. |
overwrite |
whether to overwrite |
... |
additional arguments passed to |
The auto_cloud_fill
function allows an analyst to automatically
construct a cloud-filled image after specifying: data_dir
(a folder
of Landsat images), wrspath
and wrsrow
(the WRS-2 path/row to
use), and start_date
and end_date
(a start and end date
limiting the images to use in the algorithm). The analyst can also
optionally specify a base_date
, and the auto_cloud_fill
function will automatically pick the image closest to that date to use as
the base image.
As the auto_cloud_fill
function automatically chooses images for
inclusion in the cloud fill process, it relies on having images stored on
disk in a particular way, and currently only supports cloud fill for Landsat
CDR surface reflectance images. To ensure that images are correctly stored
on your hard disk, use the auto_preprocess_landsat
function to
extract the original Landsat CDR hdf files from the USGS archive. The
auto_preprocess_landsat
function will ensure that images are
extracted and renamed properly so that they can be used with the
auto_cloud_fill
script.
a list with two elements: "filled", a Raster*
object with
cloud filled image, and "mask", a RasterLayer
object with the cloud
mask for the cloud filled image.
Zhu, X., Gao, F., Liu, D., Chen, J., 2012. A modified neighborhood similar pixel interpolator approach for removing thick clouds in Landsat images. Geoscience and Remote Sensing Letters, IEEE 9, 521–525. doi:10.1109/LGRS.2011.2173290
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.