# arithmetic: Isotope arithmetic In isoverse/isotopia: Work with Isotopic Data in R

## Description

Several arithmetic operators (+, -, *, /) are implemented to work with specific isotope value object to allow shorthand data type conversions and calculations. Operations are generally only permitted if the two isotope objects being combined have matching attributes (isotope name, major isotope, etc.).

## Usage

 ``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21``` ```intensity +- intensity abundance +- abundance delta +- delta alpha - 1 delta * 1000 ff * ratio delta * delta intensity / intensity ratio / ratio ff / ff delta / delta ```

## Details

`intensity+-intensity` allows the addition of intensity values, the result is a another `intensity` object

`abundance+-abundance` is a shorthand for calculating the isotopic mass balance of two `abundance` objects, see `mass_balance` for details

`delta+-delta` is a shorthand for calculating the isotopic mass balance of two `delta` objects, see `mass_balance` for details

`alpha - 1` is a shorthand for converting a fractionation factor from alpha to epsilon notation. The ff object has to be in alpha notation, otherwise this is just interpreted as a regular arithmetic operation and the result will no longer be an isotope object. `eps + 1` is the reverse operation.

`delta * 1000` is a shorthand for converting a raw delta value to permil notation or permil to ppm. The same works for fractionation factors in epsilon notation. `delta / 1000` is the reverse

`ff*ratio`, `ff*ff`, `ff*delta` are a shorthand for fractionating an isotope object with a factionation factor, see `fractionate` for details

`delta*delta`, is a shorthand for shifting the reference frame of the first delta value to that of the second (requires the compound measured in the second to be the reference of the first!), see `shift_reference` for details

`intensity/intensity` allows the creation of an isotope `ratio` object

`ratio/ratio` allows the creation of an isotope `fractionation_factor` This is a shorthand for the to_ff function.

`ff/ff` allows the creation of another isotope `fractionation_factor` object but requires that either the denominator names or numerator names of the two objects are identical (i.e. they "cancel"). This is a shorthand for the to_ff function.

`delta/delta` creates an `fractionation_factor` object that describes the fractionation factor between the two compounds, requires the reference name of the two delta values to be identical. This is a shorthand for the to_ff function.

isoverse/isotopia documentation built on Nov. 5, 2019, 2:40 p.m.