denseness_sample {bwimage} R Documentation

## Denseness in samples

### Description

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

### Usage

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

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