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

## Description

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

## Usage

 ```1 2 3 4 5``` ```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") ```

## Arguments

 `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".

## Value

 `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.

## Author(s)

Carlos Biagolini-Jr.

 ```1 2 3 4 5``` ```# 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) ```