<!-- Generated by pkgdown: do not edit by hand -->
<!DOCTYPE html>
<html lang="en">
  <head>
  <meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Isotope arithmetic — arithmetic • isotopia</title>

<!-- jquery -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js" integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8=" crossorigin="anonymous"></script>
<!-- Bootstrap -->
<link href="https://cdnjs.cloudflare.com/ajax/libs/bootswatch/3.3.7/simplex/bootstrap.min.css" rel="stylesheet" crossorigin="anonymous" />

<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha256-U5ZEeKfGNOja007MMD3YBI0A3OSZOQbeG6z2f2Y0hu8=" crossorigin="anonymous"></script>

<!-- Font Awesome icons -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.7.1/css/all.min.css" integrity="sha256-nAmazAk6vS34Xqo0BSrTb+abbtFlgsFK7NKSi6o7Y78=" crossorigin="anonymous" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.7.1/css/v4-shims.min.css" integrity="sha256-6qHlizsOWFskGlwVOKuns+D1nB6ssZrHQrNj1wGplHc=" crossorigin="anonymous" />

<!-- clipboard.js -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.4/clipboard.min.js" integrity="sha256-FiZwavyI2V6+EXO1U+xzLG3IKldpiTFf3153ea9zikQ=" crossorigin="anonymous"></script>

<!-- headroom.js -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.9.4/headroom.min.js" integrity="sha256-DJFC1kqIhelURkuza0AvYal5RxMtpzLjFhsnVIeuk+U=" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.9.4/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>

<!-- pkgdown -->
<link href="../pkgdown.css" rel="stylesheet">
<script src="../pkgdown.js"></script>



<meta property="og:title" content="Isotope arithmetic — arithmetic" />

<meta property="og:description" content="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.)." />
<meta name="twitter:card" content="summary" />



<!-- mathjax -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>

<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
<![endif]-->



  </head>

  <body>
    <div class="container template-reference-topic">
      <header>
      <div class="navbar navbar-default navbar-fixed-top" role="navigation">
  <div class="container">
    <div class="navbar-header">
      <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
        <span class="sr-only">Toggle navigation</span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
      </button>
      <span class="navbar-brand">
        <a class="navbar-link" href="../index.html">isotopia</a>
        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.8</span>
      </span>
    </div>

    <div id="navbar" class="navbar-collapse collapse">
      <ul class="nav navbar-nav">
        <li>
  <a href="../articles/isotopia.html">Getting Started</a>
</li>
<li>
  <a href="../reference/index.html">Reference</a>
</li>
      </ul>
      
      <ul class="nav navbar-nav navbar-right">
        <li>
  <a href="https://github.com/sebkopf/isotopia">
    <span class="fa fa-github fa-lg"></span>
     
  </a>
</li>
      </ul>
      
    </div><!--/.nav-collapse -->
  </div><!--/.container -->
</div><!--/.navbar -->

      

      </header>

<div class="row">
  <div class="col-md-9 contents">
    <div class="page-header">
    <h1>Isotope arithmetic</h1>
    <small class="dont-index">Source: <a href='https://github.com/sebkopf/isotopia/blob/master/R/arithmetic.R'><code>R/arithmetic.R</code></a></small>
    <div class="hidden name"><code>arithmetic.Rd</code></div>
    </div>

    <div class="ref-description">
    
    <p>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.).</p>
    
    </div>

    <pre class="usage"><span class='no'>intensity</span> +- <span class='no'>intensity</span>

<span class='no'>abundance</span> +- <span class='no'>abundance</span>

<span class='no'>delta</span> +- <span class='no'>delta</span>

<span class='no'>alpha</span> - <span class='fl'>1</span>

<span class='no'>delta</span> * <span class='fl'>1000</span>

<span class='no'>ff</span> * <span class='no'>ratio</span>

<span class='no'>delta</span> * <span class='no'>delta</span>

<span class='no'>intensity</span> / <span class='no'>intensity</span>

<span class='no'>ratio</span> / <span class='no'>ratio</span>

<span class='no'>ff</span> / <span class='no'>ff</span>

<span class='no'>delta</span> / <span class='no'>delta</span></pre>
        
    <h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>

    <p><code>intensity+-intensity</code> allows the addition of intensity values, the result is a another <code><a href='intensity.html'>intensity</a></code> object</p>
<p><code>abundance+-abundance</code> is a shorthand for calculating the isotopic mass balance of
two <code><a href='abundance.html'>abundance</a></code> objects, see <code><a href='mass_balance.html'>mass_balance</a></code> for details</p>
<p><code>delta+-delta</code> is a shorthand for calculating the isotopic mass balance of
two <code><a href='delta.html'>delta</a></code> objects, see <code><a href='mass_balance.html'>mass_balance</a></code> for details</p>
<p><code>alpha - 1</code> 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. 
<code>eps  + 1</code> is the reverse operation.</p>
<p><code>delta * 1000</code> 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. <code>delta / 1000</code> is the reverse</p>
<p><code>ff*ratio</code>, <code>ff*ff</code>, <code>ff*delta</code> are a shorthand for 
fractionating an isotope object with a factionation factor,
see <code><a href='fractionate.html'>fractionate</a></code> for details</p>
<p><code>delta*delta</code>, 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 <code><a href='shift_reference.html'>shift_reference</a></code> 
for details</p>
<p><code>intensity/intensity</code> allows the creation of an isotope <code><a href='ratio.html'>ratio</a></code> object</p>
<p><code>ratio/ratio</code> allows the creation of an isotope <code><a href='fractionation_factor.html'>fractionation_factor</a></code> 
This is a shorthand for the <a href='to_ff.html'>to_ff</a> function.</p>
<p><code>ff/ff</code> allows the creation of another isotope <code><a href='fractionation_factor.html'>fractionation_factor</a></code> 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 <a href='to_ff.html'>to_ff</a> function.</p>
<p><code>delta/delta</code> creates an <code><a href='fractionation_factor.html'>fractionation_factor</a></code> 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 <a href='to_ff.html'>to_ff</a> function.</p>
    

  </div>
  <div class="col-md-3 hidden-xs hidden-sm" id="sidebar">
    <h2>Contents</h2>
    <ul class="nav nav-pills nav-stacked">
      
      <li><a href="#details">Details</a></li>
          </ul>

  </div>
</div>


      <footer>
      <div class="copyright">
  <p>Developed by Sebastian Kopf.</p>
</div>

<div class="pkgdown">
  <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.4.1.</p>
</div>

      </footer>
   </div>

  


  </body>
</html>


