# Slope: Function to calculate the average slope of a surface In molaR: Dental Surface Complexity Measurement Tools

 Slope R Documentation

## Function to calculate the average slope of a surface

### Description

A function that calculates the average slope over a tooth or some other 3D surface

### Usage

```Slope(plyFile, Guess = FALSE)
```

### Arguments

 `plyFile` An object of classes 'mesh3d' and 'shape3d' with calculated normals `Guess` Logical indicating whether the function should 'guess' as to the 'up' direction for the surface and to remove negative slopes from the calculation

### Details

This function requires a ply file. It will calculate the slope on each face of the surface and will average the slope across the surface. This is functionally equivalent to the slope calculation used by Ungar and M'Kirera "A solution to the worn tooth conundrum in primate functional anatomy" PNAS (2003) 100(7):3874-3877

In the case of applying this function to teeth (its intended purpose), the function expects a surface with the occlusal plane normal to the Z-axis.

The `Guess` parameter is a logical asking whether or not you want the function to both guess as to the right side up of the surface, and to then discard all of the 'negative' slopes, i.e. surfaces which are over-hangs, as is frequently found on the sidewalls of teeth. If `Guess` is not engaged the mean slope will include the negative values of the overhang and will likely underestimate the average slope of the surface.

Regardless of if the `Guess` parameter is engaged, the function will also return a vector containing all of the face slope values ("Face_Slopes")

### Examples

```Slope_output <- Slope(Tooth)
summary(Slope_output)
```

molaR documentation built on Feb. 16, 2023, 10:33 p.m.