denseness_sample: Denseness in samples
In bwimage: Describe Image Patterns in Natural Structures

Description Usage Arguments Value Author(s) See Also Examples

Calculate the denseness (proportion of black pixel in relation to the total number of pixels) for a given number of samples.

denseness_sample(imagematrix, width_size, height_size, sample_width,
  sample_height, method = "random", sample_shape = "rectangle",
  n_samples = 10, n_sample_horizontal = 10, n_sample_vertical = 1,
  proportion_horizontal = 1, proportion_vertical = 1,
  aligin_horizontal = "center", aligin_vertical = "bottom")

`imagematrix`	The matrix to be analysed.
`width_size`	Real size of image width (in mm, cm, m, etc..).
`height_size`	Real size of image height (in mm, cm, m, etc..).
`sample_width`	Width of sample area.
`sample_height`	Height of sample area.
`method`	Method for sample ("random" or "uniform").
`sample_shape`	The shape of sample unity ("rectangle" or "ellipse"). See plot_samples function.
`n_samples`	Defines the number of samples, when sample_shape="random".
`n_sample_horizontal`	Defines the number of samples column, when sample_shape=" uniform".
`n_sample_vertical`	Defines the number of samples lines, when sample_shape=" uniform".
`proportion_horizontal`	Range from 0 to 1. Represent the proportion of horizontal plane to be sample. If proportion_horizontal=1 (default) all columns beacome potentially sample.
`proportion_vertical`	Range from 0 to 1. Represent the proportion of vertical plane to be sample. If proportion_vertical=1 (default) all lines become potentially sample.
`aligin_horizontal`	Define horizontal align. Three options are available: "center", "left" or "right".
`aligin_vertical`	Define vertical align. Three options are available: "middle","bottom" or "top".

`Sample_denseness`	Proportion of black pixels in samples. It do not take into account transparent pixels (when present)..
`Height`	Height of each sample (in mm, cm, m, etc. ..). Central point used as reference.
`Distance(left)`	Distance ti the left side of each sample (in mm, cm, m, etc. ..). Central point used as reference.
`Matrix(line)`	Imagem matrix line coordinates.
`Matrix(column)`	Imagem matrix column coordinates.

Carlos Biagolini-Jr.

plot_samples

# Get a matrix from your image. Here  examples provided by bwimage package.

bush<-system.file("extdata/bush.JPG",package ="bwimage")
bush<-threshold_color(bush,  "jpeg", "proportional",compress_rate = 0.1)
denseness_sample(bush, width_size=100, height_size=100, sample_width=5, sample_height=5)