score_jp2_image: Score a jp2 image with a Keras model

Description Usage Arguments Value

Description

Score a jp2 image with a Keras model

Usage

1
2
3
4
score_jp2_image(model_params, scoring_model, jp2_path, jp2_aux_path,
  score_outpath = NULL, compress_score_rds = FALSE,
  return_score = TRUE, verbose = FALSE, tile_overlap = 0,
  complete_image = FALSE)

Arguments

model_params

Model parameters object created during model training

scoring_model

Trained keras model object

jp2_path

Path to .jp2 image files

jp2_aux_path

Path to .jp2.aux.xml file containing metadata about .jp2 image

score_outpath

Path to save results of image scoring as .rds file

compress_score_rds

Should saved score results be compressed

return_score

Should score results be returned as an R object by the function

verbose

Should messages about current step being processes be printed to screen?

tile_overlap

Number of pixel overlap in adjacent tiles (in both X and Y directions). See calc_slice_corners.

complete_image

If TRUE and the tile size and overlap dimensions do not conform to covering the entire source raster/image, an additional row and column of tiles will be created that include the excluded pixels but do NOT respect the overlap value. If FALSE and the dimensions do not conform, the set of tiles will omit some pixels on the right and bottom side of the source raster/image. See calc_slice_corners.

Value

Data frame with one row for each tile, containing: - jp2_path - jp2_aux_path - Numeric tile ID number - Tile corner cells in source jp2 pixel values - List-column containing each tile's extent based on the source jp2's projected raster - sf geometry column containing each tile's sf polygon - List-column containing tile's RGB layers in a 4d array of dimension \[1, tile_n_cols, tile_n_rows, 3\] - Model predicted probability for each image tile

If score outpath != NULL returned data frame will be saved to outpath as an RDS file, compressed if compress_score_rds == TRUE.


treysp/coolit documentation built on June 5, 2019, 5:16 p.m.