# Calculate Max By Period

### Description

Calculate a maximum for each period of INDEX. Essentially a rolling application of maximum over a series of non-overlapping sections.

### Usage

1 | ```
period.max(x, INDEX)
``` |

### Arguments

`x` |
a univariate data object |

`INDEX` |
a numeric vector of endpoints to calculate maximum on |

### Details

Used to calculate a maximum per period given an arbitrary index of sections to be calculated over. This is an optimized function for maximum. There are additional optimized versions for min, sum, and prod.

For xts-coercible objects, an appropriate INDEX can be derived from a call to 'endpoints'.

### Value

An xts or zoo object of maximums, indexed by the period endpoints.

### Author(s)

Jeffrey A. Ryan

### See Also

`endpoints`

, `period.sum`

,
`period.min`

, `period.prod`

### Examples

1 2 3 4 5 | ```
period.max(c(1,1,4,2,2,6,7,8,-1,20),c(0,3,5,8,10))
data(sample_matrix)
period.max(sample_matrix[,1],endpoints(sample_matrix))
period.max(as.xts(sample_matrix)[,1],endpoints(sample_matrix))
``` |

Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker. Vote for new features on Trello.