# TriangularDistribution

Triangular probability distribution object

## Description

A `TriangularDistribution` object consists of parameters and a model description for a triangular probability distribution.

The triangular distribution is frequently used in simulations when limited sample data is available. The lower and upper limits represent the smallest and largest values, and the location of the peak represents an estimate of the mode.

The triangular distribution uses the following parameters.

ParameterDescriptionSupport
`A`Lower limit$A\le B$
`B`Peak location$A\le B\le C$
`C`Upper limit$C\ge B$

## Creation

Create a `TriangularDistribution` probability distribution with specified parameter values object using `makedist`.

## Properties

expand all

### Distribution Parameters

Lower limit for the triangular distribution, specified as a scalar value.

Data Types: `single` | `double`

Peak location for the triangular distribution, specified as a scalar value greater than or equal to `A`.

Data Types: `single` | `double`

Upper limit for the triangular distribution, specified as a scalar value greater than or equal to `B`.

Data Types: `single` | `double`

### Distribution Characteristics

Logical flag for truncated distribution, specified as a logical value. If `IsTruncated` equals `0`, the distribution is not truncated. If `IsTruncated` equals `1`, the distribution is truncated.

Data Types: `logical`

Number of parameters for the probability distribution, specified as a positive integer value.

Data Types: `double`

Distribution parameter values, specified as a vector of scalar values.

Data Types: `single` | `double`

Truncation interval for the probability distribution, specified as a vector of scalar values containing the lower and upper truncation boundaries.

Data Types: `single` | `double`

### Other Object Properties

Probability distribution name, specified as a character vector.

Data Types: `char`

Distribution parameter descriptions, specified as a cell array of character vectors. Each cell contains a short description of one distribution parameter.

Data Types: `char`

Distribution parameter names, specified as a cell array of character vectors.

Data Types: `char`

## Object Functions

 `cdf` Cumulative distribution function `icdf` Inverse cumulative distribution function `iqr` Interquartile range of probability distribution `mean` Mean of probability distribution `median` Median of probability distribution `pdf` Probability density function `random` Random numbers `std` Standard deviation of probability distribution `truncate` Truncate probability distribution object `var` Variance of probability distribution

## Examples

collapse all

Create a triangular distribution object using the default parameter values.

`pd = makedist('Triangular')`
```pd = TriangularDistribution A = 0, B = 0.5, C = 1 ```

Create a triangular distribution object by specifying parameter values.

`pd = makedist('Triangular','A',-2,'B',1,'C',5)`
```pd = TriangularDistribution A = -2, B = 1, C = 5 ```

Compute the mean of the distribution.

`m = mean(pd)`
```m = 1.3333 ```

## Version History

Introduced in R2013a