From 0f351a6469f24d2d50b42e4440f95aad555003bc Mon Sep 17 00:00:00 2001
From: jdhoffa <jdhoffa@users.noreply.github.com>
Date: Tue, 26 Mar 2024 11:46:04 +0000
Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20RMI-PACT?=
 =?UTF-8?q?A/r2dii.analysis@107debeb8f8fb73523ec30cb2f9e4d2451599f03=20?=
 =?UTF-8?q?=F0=9F=9A=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 apple-touch-icon-120x120.png                  | Bin 3287 -> 3287 bytes
 apple-touch-icon-152x152.png                  | Bin 4250 -> 4250 bytes
 apple-touch-icon-180x180.png                  | Bin 4997 -> 4997 bytes
 apple-touch-icon-60x60.png                    | Bin 1741 -> 1741 bytes
 apple-touch-icon-76x76.png                    | Bin 2177 -> 2177 bytes
 apple-touch-icon.png                          | Bin 4997 -> 4997 bytes
 articles/production-percent-change.html       |  40 +++++++-------
 articles/r2dii-analysis.html                  |  52 +++++++++---------
 .../figure-html/trajetory-portfolio-1.png     | Bin 104797 -> 104792 bytes
 articles/target-market-share.html             |  52 +++++++++---------
 articles/target-sda.html                      |   4 +-
 favicon-16x16.png                             | Bin 777 -> 777 bytes
 favicon-32x32.png                             | Bin 1355 -> 1355 bytes
 news/index.html                               |   2 +-
 pkgdown.yml                                   |   2 +-
 reference/join_abcd_scenario.html             |   6 +-
 search.json                                   |   2 +-
 17 files changed, 80 insertions(+), 80 deletions(-)

diff --git a/apple-touch-icon-120x120.png b/apple-touch-icon-120x120.png
index e55fd3546d30d7a5e4400efa38a57be231607945..5c559678cc7b22fb0129a2c4be23a53d762cba19 100644
GIT binary patch
delta 57
zcmcaEd0lcs4Vy0iC-$)48=IDK^P8Aj8JcPv7+4t?{IOLnnQYFZge=yZF!#jd44!-d
DFGvz;

delta 57
zcmcaEd0lcs4V$c-`$vag8=IDK^BY-O85?LD7+4t?$gNaQo@~yege;c-W&Zui89ey_
DD(DiN

diff --git a/apple-touch-icon-152x152.png b/apple-touch-icon-152x152.png
index 8d9b170c323e9a875e1cea71286fcfc729cdc8bd..c6283edffa3befd3baae9aafd2a9c462bb6d83d5 100644
GIT binary patch
delta 57
zcmbQGI7@Lt4V$h&J%2Rc#->bueiKtGLo;my11kfAvsdk3PX5KOge<nFqdj!8wm?1r
D`~4Bg

delta 57
zcmbQGI7@Lt4V$dI!MB2(jZK;S{6>~m#)jGk237_JJMQURpZtqo30dr9^OWq#+5-6i
DCxQ~o

diff --git a/apple-touch-icon-180x180.png b/apple-touch-icon-180x180.png
index 5286a5dd692f6b79474bad4a3e2796fd52becdd1..6bba5177e09fb5ac2152826083957d4fc9765573 100644
GIT binary patch
delta 57
zcmZowZ&jaA!=@|9!I3><V^fF_zlo`pp}Dq!ft7(l_9Bzm$xnrpkj13__dJ{|CY%od
D)}#>5

delta 57
zcmZowZ&jaA!zQcHHX$}}V^fF_zmcVtv5~fcft7(lr<s}8<flSP$YMXT`@T&U6V3+!
D@oW)(

diff --git a/apple-touch-icon-60x60.png b/apple-touch-icon-60x60.png
index 5ebb2e9c07ff13345986d34c8f1807f128456b88..6e3cc8a1c1721d3f52da12dfe357763b94ce67d6 100644
GIT binary patch
delta 57
zcmX@hdzN=X4Vx~n45#_^jZJe{`Atl%42`u746F<c=D!v2o2<*Gge>-M!-`Ln<Jj^6
D_3aVv

delta 57
zcmX@hdzN=X4V$dY%KwVjHa5*+<u|glGP2M%Ft9Q(c=#rB)?{5aC1kM)8!xI&j$_LQ
E08DZdPXGV_

diff --git a/apple-touch-icon-76x76.png b/apple-touch-icon-76x76.png
index a0257aa24b64aa7e5c1219c9953c16d9ef404528..aed12c14c74699f8a16d0e65def80619465d13a5 100644
GIT binary patch
delta 57
zcmZn^Y!sYO!=}sE%8-`3u_=I^-^A3)&_vt7z{<cN%1iIS<cI7^$YR>!(`qIQapVI4
D%1sYz

delta 57
zcmZn^Y!sYO!zL?x?}wnn#-;#vej`gOBTH=q11kdq_t{B$lOM7xA&Z$EyESRD5Jx@$
D_fru)

diff --git a/apple-touch-icon.png b/apple-touch-icon.png
index b1220e38ba467256b54defde4d7d8036a89e7fc6..18613bd979e290287e194261aed654c64179a16b 100644
GIT binary patch
delta 57
zcmZowZ&jaA!=@`Vk<m(NV^fF_zlo`pp@p`Aft7*5+*dAJCO;KYLKb_o{SU`vG2wgw
D><kgE

delta 57
zcmZowZ&jaA!zQcvaeD6YjZGm!{6>~m#>UzP237_J`i{2$CO;KYLKcgYX?2<`CY%od
D9la4h

diff --git a/articles/production-percent-change.html b/articles/production-percent-change.html
index f6e7f870..80ad3838 100644
--- a/articles/production-percent-change.html
+++ b/articles/production-percent-change.html
@@ -142,20 +142,20 @@ <h2 id="weighted-production">Weighted Production<a class="anchor" aria-label="an
 <span>  <span class="op">)</span></span>
 <span></span>
 <span><span class="fu"><a href="../reference/summarize_weighted_production.html">summarize_weighted_production</a></span><span class="op">(</span><span class="va">master</span><span class="op">)</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 231 × 5</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 168 × 5</span></span></span>
 <span><span class="co">#&gt;    sector_abcd technology  year weighted_production weighted_technology_share</span></span>
 <span><span class="co">#&gt;    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;int&gt;</span>               <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span>                     <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span></span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automotive  electric    <span style="text-decoration: underline;">2</span>020             <span style="text-decoration: underline;">973</span>775.                     0.114</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automotive  electric    <span style="text-decoration: underline;">2</span>021            1<span style="text-decoration: underline;">018</span>967.                     0.118</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automotive  electric    <span style="text-decoration: underline;">2</span>022            1<span style="text-decoration: underline;">064</span>159.                     0.122</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automotive  electric    <span style="text-decoration: underline;">2</span>023            1<span style="text-decoration: underline;">109</span>351.                     0.126</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automotive  electric    <span style="text-decoration: underline;">2</span>024            1<span style="text-decoration: underline;">154</span>543.                     0.130</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automotive  electric    <span style="text-decoration: underline;">2</span>025            1<span style="text-decoration: underline;">199</span>735.                     0.133</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automotive  electric    <span style="text-decoration: underline;">2</span>020             <span style="text-decoration: underline;">436</span>948.                     0.481</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automotive  electric    <span style="text-decoration: underline;">2</span>021             <span style="text-decoration: underline;">442</span>439.                     0.480</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automotive  electric    <span style="text-decoration: underline;">2</span>022             <span style="text-decoration: underline;">447</span>929.                     0.480</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automotive  electric    <span style="text-decoration: underline;">2</span>023             <span style="text-decoration: underline;">453</span>420.                     0.479</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automotive  electric    <span style="text-decoration: underline;">2</span>024             <span style="text-decoration: underline;">458</span>910.                     0.479</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automotive  electric    <span style="text-decoration: underline;">2</span>025             <span style="text-decoration: underline;">464</span>401.                     0.479</span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automotive  electric    <span style="text-decoration: underline;">2</span>026                 <span style="color: #BB0000;">NA</span>                     <span style="color: #BB0000;">NA</span>    </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automotive  electric    <span style="text-decoration: underline;">2</span>027                 <span style="color: #BB0000;">NA</span>                     <span style="color: #BB0000;">NA</span>    </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automotive  electric    <span style="text-decoration: underline;">2</span>028                 <span style="color: #BB0000;">NA</span>                     <span style="color: #BB0000;">NA</span>    </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automotive  electric    <span style="text-decoration: underline;">2</span>029                 <span style="color: #BB0000;">NA</span>                     <span style="color: #BB0000;">NA</span>    </span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 221 more rows</span></span></span></code></pre></div>
+<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 158 more rows</span></span></span></code></pre></div>
 </div>
 <div class="section level2">
 <h2 id="weighted-percent-change-in-production">Weighted Percent Change in Production<a class="anchor" aria-label="anchor" href="#weighted-percent-change-in-production"></a>
@@ -185,20 +185,20 @@ <h2 id="weighted-percent-change-in-production">Weighted Percent Change in Produc
 <div class="sourceCode" id="cb2"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="co"># using the master dataset defined in the previous chunk:</span></span>
 <span><span class="fu"><a href="../reference/summarize_weighted_production.html">summarize_weighted_percent_change</a></span><span class="op">(</span><span class="va">master</span><span class="op">)</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 231 × 4</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 168 × 4</span></span></span>
 <span><span class="co">#&gt;    sector_abcd technology  year weighted_percent_change</span></span>
 <span><span class="co">#&gt;    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;int&gt;</span>                   <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span></span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automotive  electric    <span style="text-decoration: underline;">2</span>020                  0     </span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automotive  electric    <span style="text-decoration: underline;">2</span>021                  0.088<span style="text-decoration: underline;">1</span></span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automotive  electric    <span style="text-decoration: underline;">2</span>022                  0.176 </span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automotive  electric    <span style="text-decoration: underline;">2</span>023                  0.264 </span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automotive  electric    <span style="text-decoration: underline;">2</span>024                  0.352 </span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automotive  electric    <span style="text-decoration: underline;">2</span>025                  0.440 </span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automotive  electric    <span style="text-decoration: underline;">2</span>026                 <span style="color: #BB0000;">NA</span>     </span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automotive  electric    <span style="text-decoration: underline;">2</span>027                 <span style="color: #BB0000;">NA</span>     </span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automotive  electric    <span style="text-decoration: underline;">2</span>028                 <span style="color: #BB0000;">NA</span>     </span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automotive  electric    <span style="text-decoration: underline;">2</span>029                 <span style="color: #BB0000;">NA</span>     </span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 221 more rows</span></span></span></code></pre></div>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automotive  electric    <span style="text-decoration: underline;">2</span>020               0        </span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automotive  electric    <span style="text-decoration: underline;">2</span>021               0.000<span style="text-decoration: underline;">062</span>6</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automotive  electric    <span style="text-decoration: underline;">2</span>022               0.000<span style="text-decoration: underline;">125</span> </span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automotive  electric    <span style="text-decoration: underline;">2</span>023               0.000<span style="text-decoration: underline;">188</span> </span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automotive  electric    <span style="text-decoration: underline;">2</span>024               0.000<span style="text-decoration: underline;">250</span> </span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automotive  electric    <span style="text-decoration: underline;">2</span>025               0.000<span style="text-decoration: underline;">313</span> </span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automotive  electric    <span style="text-decoration: underline;">2</span>026              <span style="color: #BB0000;">NA</span>        </span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automotive  electric    <span style="text-decoration: underline;">2</span>027              <span style="color: #BB0000;">NA</span>        </span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automotive  electric    <span style="text-decoration: underline;">2</span>028              <span style="color: #BB0000;">NA</span>        </span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automotive  electric    <span style="text-decoration: underline;">2</span>029              <span style="color: #BB0000;">NA</span>        </span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 158 more rows</span></span></span></code></pre></div>
 </div>
   </main><aside class="col-md-3"><nav id="toc"><h2>On this page</h2>
     </nav></aside>
diff --git a/articles/r2dii-analysis.html b/articles/r2dii-analysis.html
index 628e3dbc..9f2a0d40 100644
--- a/articles/r2dii-analysis.html
+++ b/articles/r2dii-analysis.html
@@ -148,7 +148,7 @@ <h2 id="match-your-loanbook-to-climate-related-asset-level-data">Match your loan
 <span><span class="va">matched</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rmi-pacta.github.io/r2dii.match/reference/match_name.html" class="external-link">match_name</a></span><span class="op">(</span><span class="va">loanbook</span>, <span class="va">abcd</span><span class="op">)</span> <span class="op"><a href="../reference/pipe.html">%&gt;%</a></span> <span class="fu"><a href="https://rmi-pacta.github.io/r2dii.match/reference/prioritize.html" class="external-link">prioritize</a></span><span class="op">(</span><span class="op">)</span></span>
 <span></span>
 <span><span class="va">matched</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 168 × 28</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 177 × 28</span></span></span>
 <span><span class="co">#&gt;    id_loan id_direct_loantaker name_direct_loantaker      id_intermediate_pare…¹</span></span>
 <span><span class="co">#&gt;    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>               <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                 </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> L6      C304                Kassulke-Kassulke          <span style="color: #BB0000;">NA</span>                    </span></span>
@@ -161,7 +161,7 @@ <h2 id="match-your-loanbook-to-climate-related-asset-level-data">Match your loan
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> L26     C280                Ankunding, Ankunding and … <span style="color: #BB0000;">NA</span>                    </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> L27     C278                Donati-Donati Group        <span style="color: #BB0000;">NA</span>                    </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> L28     C276                Ferraro, Ferraro e Ferrar… <span style="color: #BB0000;">NA</span>                    </span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 158 more rows</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 167 more rows</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ abbreviated name: ¹​id_intermediate_parent_1</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ 24 more variables: name_intermediate_parent_1 &lt;chr&gt;,</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;">#   id_ultimate_parent &lt;chr&gt;, name_ultimate_parent &lt;chr&gt;,</span></span></span>
@@ -197,20 +197,20 @@ <h3 id="market-share-approach">Market Share Approach<a class="anchor" aria-label
 <span>  <span class="op">)</span></span>
 <span></span>
 <span><span class="va">market_share_targets_portfolio</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 1,501 × 10</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 1,076 × 10</span></span></span>
 <span><span class="co">#&gt;    sector     technology  year region scenario_source metric     production</span></span>
 <span><span class="co">#&gt;    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;int&gt;</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>           <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>           <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span></span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       projected     <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_cps    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_sds    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_sps    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       projected     <span style="text-decoration: underline;">339</span>656.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_cps    <span style="text-decoration: underline;">329</span>191.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_sds    <span style="text-decoration: underline;">352</span>505.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_sps    <span style="text-decoration: underline;">330</span>435.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automotive electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       projected     <span style="text-decoration: underline;">354</span>720.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automotive electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       target_cps    <span style="text-decoration: underline;">333</span>693.</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 1,491 more rows</span></span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       projected     <span style="text-decoration: underline;">145</span>649.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_cps    <span style="text-decoration: underline;">145</span>649.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_sds    <span style="text-decoration: underline;">145</span>649.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_sps    <span style="text-decoration: underline;">145</span>649.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       projected     <span style="text-decoration: underline;">147</span>480.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_cps    <span style="text-decoration: underline;">146</span>915.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_sds    <span style="text-decoration: underline;">153</span>332.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_sps    <span style="text-decoration: underline;">147</span>258.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automotive electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       projected     <span style="text-decoration: underline;">149</span>310.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automotive electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       target_cps    <span style="text-decoration: underline;">148</span>155.</span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 1,066 more rows</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ 3 more variables: technology_share &lt;dbl&gt;, scope &lt;chr&gt;,</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;">#   percentage_of_initial_production_by_scope &lt;dbl&gt;</span></span></span></code></pre></div>
 <p>Or at the company level:</p>
@@ -229,20 +229,20 @@ <h3 id="market-share-approach">Market Share Approach<a class="anchor" aria-label
 <span><span class="co">#&gt; arguments to `FALSE`?</span></span>
 <span></span>
 <span><span class="va">market_share_targets_company</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 15,876 × 11</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 14,505 × 11</span></span></span>
 <span><span class="co">#&gt;    sector    technology  year region scenario_source name_abcd metric production</span></span>
 <span><span class="co">#&gt;    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>     <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;int&gt;</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>           <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>     <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span></span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… proje…    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automoti… electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       Bernardi… proje…    <span style="text-decoration: underline;">339</span>656.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automoti… electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">329</span>191.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automoti… electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">352</span>505.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automoti… electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">330</span>435.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automoti… electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       Bernardi… proje…    <span style="text-decoration: underline;">354</span>720.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automoti… electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">333</span>693.</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 15,866 more rows</span></span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… proje…     <span style="text-decoration: underline;">17</span>951.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…     <span style="text-decoration: underline;">17</span>951.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…     <span style="text-decoration: underline;">17</span>951.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…     <span style="text-decoration: underline;">17</span>951.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Christia… proje…     <span style="text-decoration: underline;">11</span>471.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Christia… targe…     <span style="text-decoration: underline;">11</span>471.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Christia… targe…     <span style="text-decoration: underline;">11</span>471.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Christia… targe…     <span style="text-decoration: underline;">11</span>471.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Donati, … proje…      <span style="text-decoration: underline;">5</span>611.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Donati, … targe…      <span style="text-decoration: underline;">5</span>611.</span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 14,495 more rows</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ 3 more variables: technology_share &lt;dbl&gt;, scope &lt;chr&gt;,</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;">#   percentage_of_initial_production_by_scope &lt;dbl&gt;</span></span></span></code></pre></div>
 </div>
diff --git a/articles/r2dii-analysis_files/figure-html/trajetory-portfolio-1.png b/articles/r2dii-analysis_files/figure-html/trajetory-portfolio-1.png
index a06d57c13d909f5cb3a63f5ba2bb21a54a40864f..8b62d5f6b264467abc0feccaa14f7971b15dfbb6 100644
GIT binary patch
delta 63614
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

delta 63641
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%0A6!KJgiPlQJh<DB*QDYjBFLGM
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

diff --git a/articles/target-market-share.html b/articles/target-market-share.html
index 105c9c51..f72a3740 100644
--- a/articles/target-market-share.html
+++ b/articles/target-market-share.html
@@ -194,7 +194,7 @@ <h2 id="how-to-calculate-market-share-targets-for-a-given-scenario">How to calcu
 <span>  <span class="fu"><a href="https://rmi-pacta.github.io/r2dii.match/reference/prioritize.html" class="external-link">prioritize</a></span><span class="op">(</span><span class="op">)</span></span>
 <span></span>
 <span><span class="va">matched</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 168 × 28</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 177 × 28</span></span></span>
 <span><span class="co">#&gt;    id_loan id_direct_loantaker name_direct_loantaker      id_intermediate_pare…¹</span></span>
 <span><span class="co">#&gt;    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>               <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                 </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> L6      C304                Kassulke-Kassulke          <span style="color: #BB0000;">NA</span>                    </span></span>
@@ -207,7 +207,7 @@ <h2 id="how-to-calculate-market-share-targets-for-a-given-scenario">How to calcu
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> L26     C280                Ankunding, Ankunding and … <span style="color: #BB0000;">NA</span>                    </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> L27     C278                Donati-Donati Group        <span style="color: #BB0000;">NA</span>                    </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> L28     C276                Ferraro, Ferraro e Ferrar… <span style="color: #BB0000;">NA</span>                    </span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 158 more rows</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 167 more rows</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ abbreviated name: ¹​id_intermediate_parent_1</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ 24 more variables: name_intermediate_parent_1 &lt;chr&gt;,</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;">#   id_ultimate_parent &lt;chr&gt;, name_ultimate_parent &lt;chr&gt;,</span></span></span>
@@ -225,20 +225,20 @@ <h2 id="how-to-calculate-market-share-targets-for-a-given-scenario">How to calcu
 <span></span>
 <span></span>
 <span><span class="va">matched</span> <span class="op"><a href="../reference/pipe.html">%&gt;%</a></span> <span class="fu"><a href="../reference/target_market_share.html">target_market_share</a></span><span class="op">(</span><span class="va">abcd</span>, <span class="va">scenario</span>, <span class="va">regions</span><span class="op">)</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 1,501 × 10</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 1,076 × 10</span></span></span>
 <span><span class="co">#&gt;    sector     technology  year region scenario_source metric     production</span></span>
 <span><span class="co">#&gt;    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;int&gt;</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>           <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>           <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span></span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       projected     <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_cps    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_sds    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_sps    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       projected     <span style="text-decoration: underline;">339</span>656.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_cps    <span style="text-decoration: underline;">329</span>191.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_sds    <span style="text-decoration: underline;">352</span>505.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_sps    <span style="text-decoration: underline;">330</span>435.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automotive electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       projected     <span style="text-decoration: underline;">354</span>720.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automotive electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       target_cps    <span style="text-decoration: underline;">333</span>693.</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 1,491 more rows</span></span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       projected     <span style="text-decoration: underline;">145</span>649.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_cps    <span style="text-decoration: underline;">145</span>649.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_sds    <span style="text-decoration: underline;">145</span>649.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automotive electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       target_sps    <span style="text-decoration: underline;">145</span>649.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       projected     <span style="text-decoration: underline;">147</span>480.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_cps    <span style="text-decoration: underline;">146</span>915.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_sds    <span style="text-decoration: underline;">153</span>332.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automotive electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       target_sps    <span style="text-decoration: underline;">147</span>258.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automotive electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       projected     <span style="text-decoration: underline;">149</span>310.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automotive electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       target_cps    <span style="text-decoration: underline;">148</span>155.</span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 1,066 more rows</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ 3 more variables: technology_share &lt;dbl&gt;, scope &lt;chr&gt;,</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;">#   percentage_of_initial_production_by_scope &lt;dbl&gt;</span></span></span></code></pre></div>
 <ul>
@@ -251,20 +251,20 @@ <h2 id="how-to-calculate-market-share-targets-for-a-given-scenario">How to calcu
 <span><span class="co">#&gt; This will result in company-level results, weighted by the portfolio</span></span>
 <span><span class="co">#&gt; loan size, which is rarely useful. Did you mean to set one of these</span></span>
 <span><span class="co">#&gt; arguments to `FALSE`?</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 15,876 × 11</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 14,505 × 11</span></span></span>
 <span><span class="co">#&gt;    sector    technology  year region scenario_source name_abcd metric production</span></span>
 <span><span class="co">#&gt;    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>     <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;int&gt;</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>           <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>     <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span></span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… proje…    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">324</span>592.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automoti… electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       Bernardi… proje…    <span style="text-decoration: underline;">339</span>656.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automoti… electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">329</span>191.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automoti… electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">352</span>505.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automoti… electric    <span style="text-decoration: underline;">2</span>021 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">330</span>435.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automoti… electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       Bernardi… proje…    <span style="text-decoration: underline;">354</span>720.</span></span>
-<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automoti… electric    <span style="text-decoration: underline;">2</span>022 global demo_2020       Bernardi… targe…    <span style="text-decoration: underline;">333</span>693.</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 15,866 more rows</span></span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… proje…     <span style="text-decoration: underline;">17</span>951.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 2</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…     <span style="text-decoration: underline;">17</span>951.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 3</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…     <span style="text-decoration: underline;">17</span>951.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 4</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Bernardi… targe…     <span style="text-decoration: underline;">17</span>951.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 5</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Christia… proje…     <span style="text-decoration: underline;">11</span>471.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 6</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Christia… targe…     <span style="text-decoration: underline;">11</span>471.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 7</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Christia… targe…     <span style="text-decoration: underline;">11</span>471.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Christia… targe…     <span style="text-decoration: underline;">11</span>471.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Donati, … proje…      <span style="text-decoration: underline;">5</span>611.</span></span>
+<span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> automoti… electric    <span style="text-decoration: underline;">2</span>020 global demo_2020       Donati, … targe…      <span style="text-decoration: underline;">5</span>611.</span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 14,495 more rows</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ 3 more variables: technology_share &lt;dbl&gt;, scope &lt;chr&gt;,</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;">#   percentage_of_initial_production_by_scope &lt;dbl&gt;</span></span></span></code></pre></div>
 </div>
diff --git a/articles/target-sda.html b/articles/target-sda.html
index 0e5a682e..37359281 100644
--- a/articles/target-sda.html
+++ b/articles/target-sda.html
@@ -229,7 +229,7 @@ <h2 id="calculating-sda-targets">Calculating SDA Targets<a class="anchor" aria-l
 <span>  <span class="fu"><a href="https://rmi-pacta.github.io/r2dii.match/reference/prioritize.html" class="external-link">prioritize</a></span><span class="op">(</span><span class="op">)</span></span>
 <span></span>
 <span><span class="va">matched</span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 168 × 28</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># A tibble: 177 × 28</span></span></span>
 <span><span class="co">#&gt;    id_loan id_direct_loantaker name_direct_loantaker      id_intermediate_pare…¹</span></span>
 <span><span class="co">#&gt;    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>               <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                 </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 1</span> L6      C304                Kassulke-Kassulke          <span style="color: #BB0000;">NA</span>                    </span></span>
@@ -242,7 +242,7 @@ <h2 id="calculating-sda-targets">Calculating SDA Targets<a class="anchor" aria-l
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 8</span> L26     C280                Ankunding, Ankunding and … <span style="color: #BB0000;">NA</span>                    </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;"> 9</span> L27     C278                Donati-Donati Group        <span style="color: #BB0000;">NA</span>                    </span></span>
 <span><span class="co">#&gt; <span style="color: #BCBCBC;">10</span> L28     C276                Ferraro, Ferraro e Ferrar… <span style="color: #BB0000;">NA</span>                    </span></span>
-<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 158 more rows</span></span></span>
+<span><span class="co">#&gt; <span style="color: #949494;"># ℹ 167 more rows</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ abbreviated name: ¹​id_intermediate_parent_1</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;"># ℹ 24 more variables: name_intermediate_parent_1 &lt;chr&gt;,</span></span></span>
 <span><span class="co">#&gt; <span style="color: #949494;">#   id_ultimate_parent &lt;chr&gt;, name_ultimate_parent &lt;chr&gt;,</span></span></span>
diff --git a/favicon-16x16.png b/favicon-16x16.png
index 4ec9b2508aa69dc4bb4382e58413e9c6ea74f54d..f69e18c90cab4ec417426934fdaa4019fe5a6896 100644
GIT binary patch
delta 58
zcmeBV>tx%okC9DR{9*RFwUdu9PUAN*wK6i+HZZU<Fc3@<UpqOINeNjj!G68q<XKGl
E03u2eSpWb4

delta 58
zcmeBV>tx%okC9DQE&ub6l*vaJr|}zES{Ykt8yHv_80flXvP{loQbHDsk-oTN@+_u&
E036g2sQ>@~

diff --git a/favicon-32x32.png b/favicon-32x32.png
index 4ddc38ee4093deaf5d6b6ab9faafe469a5de773f..0dcda42e2819a8bb4b109278bebfb8ba55c932f0 100644
GIT binary patch
delta 59
zcmX@jb((8K5Hp*uMB$aoHk%`uT^RXIOs$Mev<(cb3=FOu)l{Cmnnej&Z0U@N^C#b7
G$p-)?F%q-@

delta 59
zcmX@jb((8K5Hp*sy2O_gpEgG@yD;(_Sy~xeY8x0>85ndMCT*C!nnej&>{re$p2>Gu
F@&Pw-68!)G

diff --git a/news/index.html b/news/index.html
index 5ea9c2c5..94edf268 100644
--- a/news/index.html
+++ b/news/index.html
@@ -109,7 +109,7 @@ <h2 class="pkg-version" data-toc-text="0.1.12" id="r2diianalysis-0112">r2dii.ana
 <h2 class="pkg-version" data-toc-text="0.1.10" id="r2diianalysis-0110">r2dii.analysis 0.1.10<a class="anchor" aria-label="anchor" href="#r2diianalysis-0110"></a></h2><p class="text-muted">CRAN release: 2021-07-09</p>
 <ul><li><p><code><a href="../reference/target_market_share.html">target_market_share()</a></code> now sets all negative <code>smsp</code> targets to zero (<a href="https://github.com/RMI-PACTA/r2dii.analysis/issues/336" class="external-link">#336</a>).</p></li>
 <li><p><code><a href="../reference/target_market_share.html">target_market_share()</a></code> now only outputs <code>sector</code>s that are present in all input datasets (<a href="https://github.com/RMI-PACTA/r2dii.analysis/issues/329" class="external-link">#329</a>).</p></li>
-<li><p><code><a href="../reference/target_market_share.html">target_market_share()</a></code> now always adds targets for green technologies (defined by <code><a href="https://rmi-pacta.github.io/r2dii.data/reference/green_or_brown.html" class="external-link">r2dii.data::green_or_brown</a></code>), even when not present in input <code>data</code> (<a href="https://github.com/RMI-PACTA/r2dii.analysis/issues/318" class="external-link">#318</a> <a href="https://github.com/Antoine-Lalechere" class="external-link">@Antoine-Lalechere</a>).</p></li>
+<li><p><code><a href="../reference/target_market_share.html">target_market_share()</a></code> now always adds targets for green technologies (defined by <code>r2dii.data::green_or_brown</code>), even when not present in input <code>data</code> (<a href="https://github.com/RMI-PACTA/r2dii.analysis/issues/318" class="external-link">#318</a> <a href="https://github.com/Antoine-Lalechere" class="external-link">@Antoine-Lalechere</a>).</p></li>
 <li><p><code><a href="../reference/target_market_share.html">target_market_share()</a></code> now correctly groups by <code>region</code> when calculating <code>technology_share</code> (<a href="https://github.com/RMI-PACTA/r2dii.analysis/issues/315" class="external-link">#315</a> <a href="https://github.com/Antoine-Lalechere" class="external-link">@Antoine-Lalechere</a>).</p></li>
 </ul></div>
     <div class="section level2">
diff --git a/pkgdown.yml b/pkgdown.yml
index 7c636f85..859bf76a 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -6,7 +6,7 @@ articles:
   r2dii-analysis: r2dii-analysis.html
   target-market-share: target-market-share.html
   target-sda: target-sda.html
-last_built: 2024-03-26T11:29Z
+last_built: 2024-03-26T11:45Z
 urls:
   reference: https://rmi-pacta.github.io/r2dii.analysis/reference
   article: https://rmi-pacta.github.io/r2dii.analysis/articles
diff --git a/reference/join_abcd_scenario.html b/reference/join_abcd_scenario.html
index 5eb2139e..4d0f9aa2 100644
--- a/reference/join_abcd_scenario.html
+++ b/reference/join_abcd_scenario.html
@@ -145,7 +145,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  scenario <span class="op">=</span> <span class="va">scenario_demo_2020</span>,</span></span>
 <span class="r-in"><span>  region_isos <span class="op">=</span> <span class="va">region_isos_demo</span></span></span>
 <span class="r-in"><span>  <span class="op">)</span></span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 15,207 × 45</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 14,592 × 45</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>    id_loan id_direct_loantaker name_direct_loantaker id_intermediate_parent_1</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>               <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                 <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                   </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 1</span> L6      C304                Kassulke-Kassulke     <span style="color: #BB0000;">NA</span>                      </span>
@@ -158,13 +158,13 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 8</span> L6      C304                Kassulke-Kassulke     <span style="color: #BB0000;">NA</span>                      </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 9</span> L6      C304                Kassulke-Kassulke     <span style="color: #BB0000;">NA</span>                      </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">10</span> L6      C304                Kassulke-Kassulke     <span style="color: #BB0000;">NA</span>                      </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># ℹ 15,197 more rows</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># ℹ 14,582 more rows</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># ℹ 41 more variables: name_intermediate_parent_1 &lt;chr&gt;,</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   id_ultimate_parent &lt;chr&gt;, name_ultimate_parent &lt;chr&gt;,</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   loan_size_outstanding &lt;dbl&gt;, loan_size_outstanding_currency &lt;chr&gt;,</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   loan_size_credit_limit &lt;dbl&gt;, loan_size_credit_limit_currency &lt;chr&gt;,</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   sector_classification_system &lt;chr&gt;, sector_classification_input_type &lt;chr&gt;,</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   sector_classification_direct_loantaker &lt;dbl&gt;, fi_type &lt;chr&gt;, …</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   sector_classification_direct_loantaker &lt;chr&gt;, fi_type &lt;chr&gt;, …</span></span>
 </code></pre></div>
     </div>
   </main><aside class="col-md-3"><nav id="toc"><h2>On this page</h2>
diff --git a/search.json b/search.json
index 112b07f3..8df67e24 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"https://rmi-pacta.github.io/r2dii.analysis/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2020 Rocky Mountain Institute Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/production-percent-change.html","id":"weighted-production","dir":"Articles","previous_headings":"","what":"Weighted Production","title":"Indicator Choices:","text":"intents purposes, recommend calculating targets using loan weighted production indicator. particular, define loan weighted production given company, \\(j\\) : \\[ \\overline{p}_{,j}(t) = p_{,j}(t) * \\dfrac{l_j}{\\sum_j l_j}\\] \\(p_{,j}\\) production company \\(\\) technology \\(j\\) \\(l_j\\) loan given company \\(j\\). calculate portfolio targets, aggregate value summing every company portfolio: \\[ \\overline{p}_i (t) = \\sum_j \\left[  p_{,j}(t) * \\dfrac{l_j}{\\sum_j l_j} \\right] \\] Effectively, loan-weighted average production attributed company portfolio. significant result indicator choice small companies (little production) favorably weighted, given loan company sufficiently large. can useful reflect large investments green start-ups. calculate weighted production:","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis)  master <- loanbook_demo %>%   match_name(abcd_demo) %>%   prioritize() %>%   join_abcd_scenario(     abcd = abcd_demo,     scenario = scenario_demo_2020,     region_isos = region_isos_demo,     add_green_technologies = FALSE   )  summarize_weighted_production(master) #> # A tibble: 231 × 5 #>    sector_abcd technology  year weighted_production weighted_technology_share #>    <chr>       <chr>      <int>               <dbl>                     <dbl> #>  1 automotive  electric    2020             973775.                     0.114 #>  2 automotive  electric    2021            1018967.                     0.118 #>  3 automotive  electric    2022            1064159.                     0.122 #>  4 automotive  electric    2023            1109351.                     0.126 #>  5 automotive  electric    2024            1154543.                     0.130 #>  6 automotive  electric    2025            1199735.                     0.133 #>  7 automotive  electric    2026                 NA                     NA     #>  8 automotive  electric    2027                 NA                     NA     #>  9 automotive  electric    2028                 NA                     NA     #> 10 automotive  electric    2029                 NA                     NA     #> # ℹ 221 more rows"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/production-percent-change.html","id":"weighted-percent-change-in-production","dir":"Articles","previous_headings":"","what":"Weighted Percent Change in Production","title":"Indicator Choices:","text":"-hand, ’re keen understand large corporations portfolio planning make significant changes, percent change production may useful indicator. company, define percent change, \\(\\chi_i(t)\\), compared start year, \\(t_0\\): \\[ \\chi_i(t) =  \\dfrac{p_{}(t)-p_{}(t_0)}{p_i(t_0)} * 100\\] \\(p_i(t)\\) indicator (production capacity) technology \\(\\), \\(t0\\) start year analysis. aggregate percent-change production company portfolio-level, using loan-weighted average . particular, loan \\(l_j\\) company \\(j\\), : \\[ \\overline{\\chi_i} = \\sum_j \\left[ \\chi_{,j} * \\dfrac{l_j}{\\sum_j l_j} \\right]\\] noted percent change, \\(\\chi\\), undefined 0 initial production. Intuitively, makes sense, since require “infinite percent” build-grow anything 0. reason, company 0 initial production filtered prior calculating percent change indicator. calculate weighted percent change:","code":"# using the master dataset defined in the previous chunk: summarize_weighted_percent_change(master) #> # A tibble: 231 × 4 #>    sector_abcd technology  year weighted_percent_change #>    <chr>       <chr>      <int>                   <dbl> #>  1 automotive  electric    2020                  0      #>  2 automotive  electric    2021                  0.0881 #>  3 automotive  electric    2022                  0.176  #>  4 automotive  electric    2023                  0.264  #>  5 automotive  electric    2024                  0.352  #>  6 automotive  electric    2025                  0.440  #>  7 automotive  electric    2026                 NA      #>  8 automotive  electric    2027                 NA      #>  9 automotive  electric    2028                 NA      #> 10 automotive  electric    2029                 NA      #> # ℹ 221 more rows"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"load-your-r2dii-libraries","dir":"Articles","previous_headings":"","what":"Load your r2dii libraries","title":"Introduction to r2dii.analysis","text":"first step analysis load recommended r2dii packages current R session. r2dii.data includes fake data help demonstrate tool r2dii.match provides functions help easily match loanbook asset-level data. plot results, may also load package r2dii.plot. also recommend packages tidyverse; optional useful.","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis) library(r2dii.plot) library(tidyverse) #> ── Attaching core tidyverse packages ──────────────────────── tidyverse 2.0.0 ── #> ✔ dplyr     1.1.4     ✔ readr     2.1.5 #> ✔ forcats   1.0.0     ✔ stringr   1.5.1 #> ✔ ggplot2   3.5.0     ✔ tibble    3.2.1 #> ✔ lubridate 1.9.3     ✔ tidyr     1.3.1 #> ✔ purrr     1.0.2      #> ── Conflicts ────────────────────────────────────────── tidyverse_conflicts() ── #> ✖ dplyr::filter() masks stats::filter() #> ✖ dplyr::lag()    masks stats::lag() #> ℹ Use the conflicted package (<http://conflicted.r-lib.org/>) to force all conflicts to become errors"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"match-your-loanbook-to-climate-related-asset-level-data","dir":"Articles","previous_headings":"","what":"Match your loanbook to climate-related asset-level data","title":"Introduction to r2dii.analysis","text":"See r2dii.match complete description process.","code":"# Use these datasets to practice but eventually you should use your own data. # The optional syntax `package::data` is to clarify where the data comes from. loanbook <- r2dii.data::loanbook_demo abcd <- r2dii.data::abcd_demo  matched <- match_name(loanbook, abcd) %>% prioritize()  matched #> # A tibble: 168 × 28 #>    id_loan id_direct_loantaker name_direct_loantaker      id_intermediate_pare…¹ #>    <chr>   <chr>               <chr>                      <chr>                  #>  1 L6      C304                Kassulke-Kassulke          NA                     #>  2 L13     C297                Ladeck                     NA                     #>  3 L20     C287                Weinhold                   NA                     #>  4 L21     C286                Gallo Group                NA                     #>  5 L22     C285                Austermuhle GmbH           NA                     #>  6 L24     C282                Ferraro-Ferraro Group      NA                     #>  7 L25     C281                Lockman, Lockman and Lock… NA                     #>  8 L26     C280                Ankunding, Ankunding and … NA                     #>  9 L27     C278                Donati-Donati Group        NA                     #> 10 L28     C276                Ferraro, Ferraro e Ferrar… NA                     #> # ℹ 158 more rows #> # ℹ abbreviated name: ¹​id_intermediate_parent_1 #> # ℹ 24 more variables: name_intermediate_parent_1 <chr>, #> #   id_ultimate_parent <chr>, name_ultimate_parent <chr>, #> #   loan_size_outstanding <dbl>, loan_size_outstanding_currency <chr>, #> #   loan_size_credit_limit <dbl>, loan_size_credit_limit_currency <chr>, #> #   sector_classification_system <chr>, …"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"calculate-targets","dir":"Articles","previous_headings":"","what":"Calculate targets","title":"Introduction to r2dii.analysis","text":"can calculate scenario targets using two different approaches: Market Share Approach, Sectoral Decarbonization Approach.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"market-share-approach","dir":"Articles","previous_headings":"Calculate targets","what":"Market Share Approach","title":"Introduction to r2dii.analysis","text":"Market Share Approach used calculate scenario targets production technology sector. example, can use approach set targets production electric vehicles automotive sector. approach recommended sectors granular technology scenario roadmap exists. Targets can set portfolio level: company level:","code":"# Use these datasets to practice but eventually you should use your own data. scenario <- r2dii.data::scenario_demo_2020 regions <- r2dii.data::region_isos_demo  market_share_targets_portfolio <- matched %>%   target_market_share(     abcd = abcd,     scenario = scenario,     region_isos = regions   )  market_share_targets_portfolio #> # A tibble: 1,501 × 10 #>    sector     technology  year region scenario_source metric     production #>    <chr>      <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 automotive electric    2020 global demo_2020       projected     324592. #>  2 automotive electric    2020 global demo_2020       target_cps    324592. #>  3 automotive electric    2020 global demo_2020       target_sds    324592. #>  4 automotive electric    2020 global demo_2020       target_sps    324592. #>  5 automotive electric    2021 global demo_2020       projected     339656. #>  6 automotive electric    2021 global demo_2020       target_cps    329191. #>  7 automotive electric    2021 global demo_2020       target_sds    352505. #>  8 automotive electric    2021 global demo_2020       target_sps    330435. #>  9 automotive electric    2022 global demo_2020       projected     354720. #> 10 automotive electric    2022 global demo_2020       target_cps    333693. #> # ℹ 1,491 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl> market_share_targets_company <- matched %>%   target_market_share(     abcd = abcd,     scenario = scenario,     region_isos = regions,     # Output results at company-level.     by_company = TRUE    ) #> Warning: You've supplied `by_company = TRUE` and `weight_production = TRUE`. #> This will result in company-level results, weighted by the portfolio #> loan size, which is rarely useful. Did you mean to set one of these #> arguments to `FALSE`?  market_share_targets_company #> # A tibble: 15,876 × 11 #>    sector    technology  year region scenario_source name_abcd metric production #>    <chr>     <chr>      <int> <chr>  <chr>           <chr>     <chr>       <dbl> #>  1 automoti… electric    2020 global demo_2020       Bernardi… proje…    324592. #>  2 automoti… electric    2020 global demo_2020       Bernardi… targe…    324592. #>  3 automoti… electric    2020 global demo_2020       Bernardi… targe…    324592. #>  4 automoti… electric    2020 global demo_2020       Bernardi… targe…    324592. #>  5 automoti… electric    2021 global demo_2020       Bernardi… proje…    339656. #>  6 automoti… electric    2021 global demo_2020       Bernardi… targe…    329191. #>  7 automoti… electric    2021 global demo_2020       Bernardi… targe…    352505. #>  8 automoti… electric    2021 global demo_2020       Bernardi… targe…    330435. #>  9 automoti… electric    2022 global demo_2020       Bernardi… proje…    354720. #> 10 automoti… electric    2022 global demo_2020       Bernardi… targe…    333693. #> # ℹ 15,866 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"sectoral-decarbonization-approach","dir":"Articles","previous_headings":"Calculate targets","what":"Sectoral Decarbonization Approach","title":"Introduction to r2dii.analysis","text":"Sectoral Decarbonization Approach used calculate scenario targets emission_factor sector. example, can use approach set targets average emission factor cement sector. approach recommended sectors lacking technology roadmaps.","code":"# Use this dataset to practice but eventually you should use your own data. co2 <- r2dii.data::co2_intensity_scenario_demo  sda_targets <- matched %>%   target_sda(abcd = abcd, co2_intensity_scenario = co2, region_isos = regions) %>%    filter(sector == \"cement\", year >= 2020) #> Warning: Removing rows in abcd where `emission_factor` is NA  sda_targets #> # A tibble: 110 × 6 #>    sector  year region             scenario_source emission_factor_metric #>    <chr>  <dbl> <chr>              <chr>           <chr>                  #>  1 cement  2020 advanced economies demo_2020       projected              #>  2 cement  2020 developing asia    demo_2020       projected              #>  3 cement  2020 global             demo_2020       projected              #>  4 cement  2021 advanced economies demo_2020       projected              #>  5 cement  2021 developing asia    demo_2020       projected              #>  6 cement  2021 global             demo_2020       projected              #>  7 cement  2022 advanced economies demo_2020       projected              #>  8 cement  2022 developing asia    demo_2020       projected              #>  9 cement  2022 global             demo_2020       projected              #> 10 cement  2023 advanced economies demo_2020       projected              #> # ℹ 100 more rows #> # ℹ 1 more variable: emission_factor_value <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"visualization","dir":"Articles","previous_headings":"","what":"Visualization","title":"Introduction to r2dii.analysis","text":"large variety possible visualizations stemming outputs target_market_share() target_sda(). , highlight couple common plots can easily created using r2dii.plot package.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"market-share-sector-level-technology-mix","dir":"Articles","previous_headings":"Visualization","what":"Market Share: Sector-level technology mix","title":"Introduction to r2dii.analysis","text":"market share output, can plot portfolio’s exposure various climate sensitive technologies (projected), compare corporate economy, various scenario targets.","code":"# Pick the targets you want to plot. data <- filter(   market_share_targets_portfolio,   scenario_source == \"demo_2020\",   sector == \"power\",   region == \"global\",   metric %in% c(\"projected\", \"corporate_economy\", \"target_sds\") )  # Plot the technology mix qplot_techmix(data) #> The `technology_share` values are plotted for extreme years. #> Do you want to plot different years? E.g. filter . with:`subset(., year %in% c(2020, 2030))`. #> Warning: Removed 3 rows containing missing values or values outside the scale range #> (`geom_bar()`)."},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"market-share-technology-level-volume-trajectory","dir":"Articles","previous_headings":"Visualization","what":"Market Share: Technology-level volume trajectory","title":"Introduction to r2dii.analysis","text":"can also plot technology-specific volume trend. starting values normalized 1, emphasize comparing rates buildout /retirement.","code":"data <- filter(   market_share_targets_portfolio,   sector == \"power\",   technology == \"renewablescap\",   region == \"global\",   scenario_source == \"demo_2020\" )  qplot_trajectory(data)"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"sda-target","dir":"Articles","previous_headings":"Visualization","what":"SDA Target","title":"Introduction to r2dii.analysis","text":"SDA output, can compare projected average emission intensity attributed portfolio, actual emission intensity scenario, scenario compliant SDA pathway portfolio must follow achieve scenario ambition 2050.","code":"data <- filter(sda_targets, sector == \"cement\", region == \"global\") qplot_emission_intensity(data)"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-market-share.html","id":"scenario-market-shares","dir":"Articles","previous_headings":"","what":"Scenario market-shares","title":"Market Share Approach","text":"Say want study portfolio perform specific climate scenario. can allocate scenario efforts production profile portfolio? can two ways – technology, sector.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-market-share.html","id":"market-share-by-technology","dir":"Articles","previous_headings":"Scenario market-shares","what":"1. Market-share by technology","title":"Market Share Approach","text":"define market-share technology : \\[p_{}^{tmsr}(t) = p_{}(t_{0}) +  p_{}(t_{0}) * \\frac{s_i(t) - s_{}(t_0)}{s_i(t_0)}\\] can see reduces : \\[p_{}^{tmsr}(t) = p_{}(t_{0}) \\left(1 + \\frac{s_i(t) - s_{}(t_0)}{s_i(t_0)} \\right) \\\\ p_{}^{tmsr}(t) = p_{}(t_{0}) \\left(1 + \\frac{s_i(t)}{s_i(t_0)} -1 \\right) \\\\ p_{}^{tmsr}(t) = p_{}(t_{0}) * \\frac{s_i(t)}{s_i(t_0)}\\] : \\(s_i(t)\\) scenario production technology \\(\\) time \\(t\\), \\(p_{}(t_0)\\) production allocated portfolio technology, \\(\\) time \\(t_0\\), \\(p_{}^{tmsr}(t)\\) portfolio-specific target production technology. define “Technology Market Share Ratio” : \\[\\dfrac{s_i(t)}{s_i(t_0)}\\] method used set targets “decreasing” (ie. brown) technologies.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-market-share.html","id":"market-share-by-sector","dir":"Articles","previous_headings":"Scenario market-shares","what":"2. Market-share by sector","title":"Market Share Approach","text":"calculate market-share sector, use initial production portfolio scenario sector-level instead. \\[p_{}^{smsp}(t) = p_{}(t_0) +P(t_0) * \\left( \\dfrac{s_i(t)-s_i(t_0)}{S(t_0)}\\right)\\] : \\(P_i(t_0)\\) portfolio’s total production sector \\(t_0\\), \\(S(t_0)\\) scenario total production \\(t_0\\). define “Sector Market Share Percentage” : \\[\\dfrac{s_i(t)-s_i(t_0)}{S(t_0)}\\] method used calculate targets “increasing” (ie. green) technologies.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-market-share.html","id":"how-to-calculate-market-share-targets-for-a-given-scenario","dir":"Articles","previous_headings":"","what":"How to calculate market-share targets for a given scenario","title":"Market Share Approach","text":"calculate market-share targets, need use package r2dii.analysis number datasets. One datasets “matched” dataset (loanbook + asset-level data) can get package r2dii.match. datasets use come package r2dii.data; fake show structure data. Use packages. Match loanbook asset level data. Calculate market-share targets production portfolio level. Calculate market-share targets production company level.","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis) loanbook <- r2dii.data::loanbook_demo abcd <- r2dii.data::abcd_demo  matched <- match_name(loanbook, abcd) %>%   # WARNING: Remember to validate the output of match_name() before prioritize()   prioritize()  matched #> # A tibble: 168 × 28 #>    id_loan id_direct_loantaker name_direct_loantaker      id_intermediate_pare…¹ #>    <chr>   <chr>               <chr>                      <chr>                  #>  1 L6      C304                Kassulke-Kassulke          NA                     #>  2 L13     C297                Ladeck                     NA                     #>  3 L20     C287                Weinhold                   NA                     #>  4 L21     C286                Gallo Group                NA                     #>  5 L22     C285                Austermuhle GmbH           NA                     #>  6 L24     C282                Ferraro-Ferraro Group      NA                     #>  7 L25     C281                Lockman, Lockman and Lock… NA                     #>  8 L26     C280                Ankunding, Ankunding and … NA                     #>  9 L27     C278                Donati-Donati Group        NA                     #> 10 L28     C276                Ferraro, Ferraro e Ferrar… NA                     #> # ℹ 158 more rows #> # ℹ abbreviated name: ¹​id_intermediate_parent_1 #> # ℹ 24 more variables: name_intermediate_parent_1 <chr>, #> #   id_ultimate_parent <chr>, name_ultimate_parent <chr>, #> #   loan_size_outstanding <dbl>, loan_size_outstanding_currency <chr>, #> #   loan_size_credit_limit <dbl>, loan_size_credit_limit_currency <chr>, #> #   sector_classification_system <chr>, … # portfolio level targets scenario <- r2dii.data::scenario_demo_2020 regions <- r2dii.data::region_isos_demo   matched %>% target_market_share(abcd, scenario, regions) #> # A tibble: 1,501 × 10 #>    sector     technology  year region scenario_source metric     production #>    <chr>      <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 automotive electric    2020 global demo_2020       projected     324592. #>  2 automotive electric    2020 global demo_2020       target_cps    324592. #>  3 automotive electric    2020 global demo_2020       target_sds    324592. #>  4 automotive electric    2020 global demo_2020       target_sps    324592. #>  5 automotive electric    2021 global demo_2020       projected     339656. #>  6 automotive electric    2021 global demo_2020       target_cps    329191. #>  7 automotive electric    2021 global demo_2020       target_sds    352505. #>  8 automotive electric    2021 global demo_2020       target_sps    330435. #>  9 automotive electric    2022 global demo_2020       projected     354720. #> 10 automotive electric    2022 global demo_2020       target_cps    333693. #> # ℹ 1,491 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl> matched %>% target_market_share(abcd, scenario, regions, by_company = TRUE) #> Warning: You've supplied `by_company = TRUE` and `weight_production = TRUE`. #> This will result in company-level results, weighted by the portfolio #> loan size, which is rarely useful. Did you mean to set one of these #> arguments to `FALSE`? #> # A tibble: 15,876 × 11 #>    sector    technology  year region scenario_source name_abcd metric production #>    <chr>     <chr>      <int> <chr>  <chr>           <chr>     <chr>       <dbl> #>  1 automoti… electric    2020 global demo_2020       Bernardi… proje…    324592. #>  2 automoti… electric    2020 global demo_2020       Bernardi… targe…    324592. #>  3 automoti… electric    2020 global demo_2020       Bernardi… targe…    324592. #>  4 automoti… electric    2020 global demo_2020       Bernardi… targe…    324592. #>  5 automoti… electric    2021 global demo_2020       Bernardi… proje…    339656. #>  6 automoti… electric    2021 global demo_2020       Bernardi… targe…    329191. #>  7 automoti… electric    2021 global demo_2020       Bernardi… targe…    352505. #>  8 automoti… electric    2021 global demo_2020       Bernardi… targe…    330435. #>  9 automoti… electric    2022 global demo_2020       Bernardi… proje…    354720. #> 10 automoti… electric    2022 global demo_2020       Bernardi… targe…    333693. #> # ℹ 15,866 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-sda.html","id":"sda-methodology","dir":"Articles","previous_headings":"","what":"SDA Methodology","title":"Sectoral Decarbonization Approach (SDA)","text":"Sectoral Decarbonization Approach (SDA) method setting corporate CO2 emissions intensity reduction targets line climate science. method developed Science-Based Targets Initiative (SBTI), international initiative science-based target setting companies initiated CDP, United Nations Global Compact, World Resources Institute (WRI), Worldwide Fund Nature (WWF). context PACTA, methodology used calculate emission factor targets homogenous sectors (.e. sectors technology-level scenario pathways). First, distance, \\(d\\), company’s CO2 emissions intensity per unit production (emissions factor), \\(^{Co}(t)\\) base year, \\(t_0\\), scenario target intensity 2050, \\(^{Sc}(2050)\\) calculated. target intensity 2050 can taken relevant climate scenario: \\[d = ^{Co}(t_0) - ^{Sc}(2050)\\] company’s market share parameter, \\(m(t)\\), defined company’s expected future activity, \\(P^{Co}(t)\\) divided sector’s future activity, \\(P^{Sc}(t)\\) reflect expected forward-looking market share company. given ratio company’s base year market share, derived activity, \\(P^{Co}(t_0)\\) divided sector’s activity year, \\(P^{Sc}(t_0)\\). cases former calculated per company, latter determined climate scenario: \\[m (t) = \\dfrac{P^{Co}(t_0) / P^{Sc}(t_0)}{P^{Co}(t) / P^{Sc}(t)}\\] noted parameter capture change market share company rather inverse. useful equates decreasing parameter company’s market share increasing. equates larger reduction efforts companies market share increasing time. sector decarbonization factor, \\(p(t)\\) defined : \\[ p(t) = \\frac{^{Sc}(t) - ^{Sc}(2050)}{^{Sc}(t_0) - ^{Sc}(2050)}\\] \\(^{}(t)\\) \\(^{Sc}(t)\\) average market scenario emission intensities respectively, time \\(t\\). variable captures remaining effort needed market meet target 2050, per year. SDA assumptions CO2 intensity companies sector converge 2050. Note \\(p(t_0) = 1\\) \\(p(2050) = 0\\), indicating 100% expected decarbonization efforts still met base year 0% left 2050. company-level emission intensity target defined : \\[^{Target}(t) = \\left( d * p (t) * m (t) \\right) + ^{Sc}(2050)\\]","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-sda.html","id":"pacta-assumptions","dir":"Articles","previous_headings":"","what":"PACTA Assumptions","title":"Sectoral Decarbonization Approach (SDA)","text":"SDA applied PACTA differs slightly way applied SBTI. particular, must align top-approach laid climate scenarios bottom-asset-based company data used PACTA analysis. Assumption: Market share stays constant (\\(m(t)\\) = 1) Due lack quantitative data expected market share changes throughout entire time horizon 2050. \\(m(t)\\) set 1 years. SBTI method calculating \\(m(t)\\), higher intensity reduction target cases absolute pathway sector exceeds scenario target. makes sense. However, applying company level counter-intuitive: Companies decrease market share allowed higher CO2-Intensity average market actor. , companies increasing market share forced terms CO2-Intensity ones whose market share remains constant. follows company reaches targeted CO2-Intensity allowed increase share market. desirable outcome. assumption, target calculation reduces : \\[^{Target}(t) = \\left( d * p (t) \\right) + ^{Sc}(2050)\\] Approximation: Adjust base year scenario emission intensity SBTI PACTA methodology target emissions sector taken climate scenarios. implement global economy top-approach applies absolute emissions value year 2050 converts yearly emission intensities. However, may discrepancies Scenario projected emission intensities, bottom-ABCD emission intensities. reflect discrepancy, adjust scenario projections following factor, \\[\\dfrac{^{ABCD}(t_0)}{^{Sc}(t_0)}\\] yielding adjusted scenario pathway: \\['^{Sc}(t) = \\left(\\dfrac{^{ABCD}(t_0)}{^{Sc}(t_0)}\\right) * ^{Sc}(t)\\] yields final PACTA SDA target equation: \\[^{Target}(t) = \\left( d * p (t) \\right) + '^{Sc}(t)\\] Note: \\(d\\) \\(p(t)\\) also must re-calculated using adjusted scenario intensity, \\('^{Sc}\\).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-sda.html","id":"calculating-sda-targets","dir":"Articles","previous_headings":"","what":"Calculating SDA Targets","title":"Sectoral Decarbonization Approach (SDA)","text":"calculate SDA targets need use package r2dii.analysis number datasets, including “matched” dataset (loanbook + asset-level data) can get package r2dii.match. datasets use come package r2dii.data; fake show structure data. Use packages. Match loanbook asset level data. Calculate SDA targets CO2 emissions intensities:","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis) loanbook <- r2dii.data::loanbook_demo abcd <- r2dii.data::abcd_demo  matched <- match_name(loanbook, abcd) %>%   # WARNING: Remember to validate the output of match_name() before prioritize()   prioritize()  matched #> # A tibble: 168 × 28 #>    id_loan id_direct_loantaker name_direct_loantaker      id_intermediate_pare…¹ #>    <chr>   <chr>               <chr>                      <chr>                  #>  1 L6      C304                Kassulke-Kassulke          NA                     #>  2 L13     C297                Ladeck                     NA                     #>  3 L20     C287                Weinhold                   NA                     #>  4 L21     C286                Gallo Group                NA                     #>  5 L22     C285                Austermuhle GmbH           NA                     #>  6 L24     C282                Ferraro-Ferraro Group      NA                     #>  7 L25     C281                Lockman, Lockman and Lock… NA                     #>  8 L26     C280                Ankunding, Ankunding and … NA                     #>  9 L27     C278                Donati-Donati Group        NA                     #> 10 L28     C276                Ferraro, Ferraro e Ferrar… NA                     #> # ℹ 158 more rows #> # ℹ abbreviated name: ¹​id_intermediate_parent_1 #> # ℹ 24 more variables: name_intermediate_parent_1 <chr>, #> #   id_ultimate_parent <chr>, name_ultimate_parent <chr>, #> #   loan_size_outstanding <dbl>, loan_size_outstanding_currency <chr>, #> #   loan_size_credit_limit <dbl>, loan_size_credit_limit_currency <chr>, #> #   sector_classification_system <chr>, … co2_intensity <- r2dii.data::co2_intensity_scenario_demo  matched %>% target_sda(abcd, co2_intensity) #> Warning: Removing rows in abcd where `emission_factor` is NA #> Warning: Found no matching regions for input scenario #> # A tibble: 0 × 4 #> # ℹ 4 variables: sector <chr>, year <int>, emission_factor_metric <chr>, #> #   emission_factor_value <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Alex Axthelm. Author, maintainer. Jackson Hoffart. Author, contractor. Mauro Lepore. Author, contractor. Klaus Hogedorn. Author. Nicky Halterman. Author. Rocky Mountain Institute. Copyright holder, funder.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Axthelm , Hoffart J, Lepore M, Hogedorn K, Halterman N (2024). r2dii.analysis: Measure Climate Scenario Alignment Corporate Loans. R package version 0.4.0,  https://rmi-pacta.github.io/r2dii.analysis/, https://github.com/RMI-PACTA/r2dii.analysis.","code":"@Manual{,   title = {r2dii.analysis: Measure Climate Scenario Alignment of Corporate Loans},   author = {Alex Axthelm and Jackson Hoffart and Mauro Lepore and Klaus Hogedorn and Nicky Halterman},   year = {2024},   note = {R package version 0.4.0,  https://rmi-pacta.github.io/r2dii.analysis/},   url = {https://github.com/RMI-PACTA/r2dii.analysis}, }"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"r2diianalysis-","dir":"","previous_headings":"","what":"Measure Climate Scenario Alignment of Corporate Loans","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"tools help assess financial portfolio aligns climate goals. summarize key metrics attributed portfolio (e.g. production, emission factors), calculate targets based climate scenarios. implement R last step free software ‘PACTA’ (Paris Agreement Capital Transition Assessment; https://www.transitionmonitor.com/). Financial institutions use ‘PACTA’ study capital allocation impacts climate.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"Install released version r2dii.analysis CRAN : install development version r2dii.analysis GitHub :","code":"install.packages(\"r2dii.analysis\") # install.packages(\"pak\") pak::pak(\"RMI-PACTA/r2dii.analysis\")"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"example","dir":"","previous_headings":"","what":"Example","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"Use library() attach packages need. r2dii.analysis depend packages r2dii.data r2dii.match; suggest install – install.packages(c(\"r2dii.data\", \"r2dii.match\")) – can reproduce examples. Use r2dii.match::match_name() identify matches loanbook asset level data.","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis) matched <- match_name(loanbook_demo, abcd_demo) %>%   prioritize()"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"add-scenario-targets","dir":"","previous_headings":"Example","what":"Add Scenario Targets","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"Use target_sda() calculate SDA targets CO2 emissions. Use target_market_share calculate market-share scenario targets portfolio level: company level:","code":"matched %>%   target_sda(     abcd = abcd_demo,     co2_intensity_scenario = co2_intensity_scenario_demo,     region_isos = region_isos_demo   ) #> Warning: Removing rows in abcd where `emission_factor` is NA #> # A tibble: 220 × 6 #>    sector  year region             scenario_source emission_factor_metric #>    <chr>  <dbl> <chr>              <chr>           <chr>                  #>  1 cement  2020 advanced economies demo_2020       projected              #>  2 cement  2020 developing asia    demo_2020       projected              #>  3 cement  2020 global             demo_2020       projected              #>  4 cement  2021 advanced economies demo_2020       projected              #>  5 cement  2021 developing asia    demo_2020       projected              #>  6 cement  2021 global             demo_2020       projected              #>  7 cement  2022 advanced economies demo_2020       projected              #>  8 cement  2022 developing asia    demo_2020       projected              #>  9 cement  2022 global             demo_2020       projected              #> 10 cement  2023 advanced economies demo_2020       projected              #> # ℹ 210 more rows #> # ℹ 1 more variable: emission_factor_value <dbl> matched %>%   target_market_share(     abcd = abcd_demo,     scenario = scenario_demo_2020,     region_isos = region_isos_demo   ) #> # A tibble: 1,076 × 10 #>    sector     technology  year region scenario_source metric     production #>    <chr>      <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 automotive electric    2020 global demo_2020       projected     145649. #>  2 automotive electric    2020 global demo_2020       target_cps    145649. #>  3 automotive electric    2020 global demo_2020       target_sds    145649. #>  4 automotive electric    2020 global demo_2020       target_sps    145649. #>  5 automotive electric    2021 global demo_2020       projected     147480. #>  6 automotive electric    2021 global demo_2020       target_cps    146915. #>  7 automotive electric    2021 global demo_2020       target_sds    153332. #>  8 automotive electric    2021 global demo_2020       target_sps    147258. #>  9 automotive electric    2022 global demo_2020       projected     149310. #> 10 automotive electric    2022 global demo_2020       target_cps    148155. #> # ℹ 1,066 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl> matched %>%   target_market_share(     abcd = abcd_demo,     scenario = scenario_demo_2020,     region_isos = region_isos_demo,     by_company = TRUE   ) #> Warning: You've supplied `by_company = TRUE` and `weight_production = TRUE`. #> This will result in company-level results, weighted by the portfolio #> loan size, which is rarely useful. Did you mean to set one of these #> arguments to `FALSE`? #> # A tibble: 14,505 × 11 #>    sector    technology  year region scenario_source name_abcd metric production #>    <chr>     <chr>      <int> <chr>  <chr>           <chr>     <chr>       <dbl> #>  1 automoti… electric    2020 global demo_2020       Bernardi… proje…     17951. #>  2 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  3 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  4 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  5 automoti… electric    2020 global demo_2020       Christia… proje…     11471. #>  6 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  7 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  8 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  9 automoti… electric    2020 global demo_2020       Donati, … proje…      5611. #> 10 automoti… electric    2020 global demo_2020       Donati, … targe…      5611. #> # ℹ 14,495 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"utility-functions","dir":"","previous_headings":"Example","what":"Utility Functions","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"target_*() functions provide shortcuts common operations. wrap utility functions may also use directly: Use join_abcd_scenario() join matched dataset relevant scenario data, pick assets relevant regions. Use summarize_weighted_production() different grouping arguments calculate scenario-targets: Get started.","code":"loanbook_joined_to_abcd_scenario <- matched %>%   join_abcd_scenario(     abcd = abcd_demo,     scenario = scenario_demo_2020,     region_isos = region_isos_demo   ) # portfolio level loanbook_joined_to_abcd_scenario %>%   summarize_weighted_production(scenario, tmsr, smsp, region) #> # A tibble: 756 × 9 #>    sector_abcd technology  year scenario  tmsr    smsp region #>    <chr>       <chr>      <int> <chr>    <dbl>   <dbl> <chr>  #>  1 automotive  electric    2020 cps       1    0       global #>  2 automotive  electric    2020 sds       1    0       global #>  3 automotive  electric    2020 sps       1    0       global #>  4 automotive  electric    2021 cps       1.12 0.00108 global #>  5 automotive  electric    2021 sds       1.16 0.00653 global #>  6 automotive  electric    2021 sps       1.14 0.00137 global #>  7 automotive  electric    2022 cps       1.24 0.00213 global #>  8 automotive  electric    2022 sds       1.32 0.0131  global #>  9 automotive  electric    2022 sps       1.29 0.00273 global #> 10 automotive  electric    2023 cps       1.35 0.00316 global #> # ℹ 746 more rows #> # ℹ 2 more variables: weighted_production <dbl>, #> #   weighted_technology_share <dbl>  # company level loanbook_joined_to_abcd_scenario %>%   summarize_weighted_production(scenario, tmsr, smsp, region, name_abcd) #> # A tibble: 13,023 × 10 #>    sector_abcd technology  year scenario  tmsr  smsp region name_abcd            #>    <chr>       <chr>      <int> <chr>    <dbl> <dbl> <chr>  <chr>                #>  1 automotive  electric    2020 cps          1     0 global Bernardi, Bernardi … #>  2 automotive  electric    2020 cps          1     0 global Christiansen PLC     #>  3 automotive  electric    2020 cps          1     0 global Donati, Donati e Do… #>  4 automotive  electric    2020 cps          1     0 global DuBuque-DuBuque      #>  5 automotive  electric    2020 cps          1     0 global Ferrari-Ferrari SPA  #>  6 automotive  electric    2020 cps          1     0 global Ferry and Sons       #>  7 automotive  electric    2020 cps          1     0 global Goyette-Goyette      #>  8 automotive  electric    2020 cps          1     0 global Guerra, Guerra e Gu… #>  9 automotive  electric    2020 cps          1     0 global Gutkowski, Gutkowsk… #> 10 automotive  electric    2020 cps          1     0 global Hilpert, Hilpert an… #> # ℹ 13,013 more rows #> # ℹ 2 more variables: weighted_production <dbl>, #> #   weighted_technology_share <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"funding","dir":"","previous_headings":"","what":"Funding","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"project received funding European Union LIFE program International Climate Initiative (IKI). Federal Ministry Environment, Nature Conservation Nuclear Safety (BMU) supports initiative basis decision adopted German Bundestag. views expressed sole responsibility authors necessarily reflect views funders. funders responsible use may made information contains.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":null,"dir":"Reference","previous_headings":"","what":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"join_abcd_scenario() simple wrapper several calls dplyr::join_*(), forming master dataset used later steps analysis.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"","code":"join_abcd_scenario(   data,   abcd,   scenario,   region_isos = r2dii.data::region_isos,   add_green_technologies = FALSE )"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"data data frame like output r2dii.match::prioritize. abcd asset level data frame like r2dii.data::abcd_demo. scenario scenario data frame like r2dii.data::scenario_demo_2020. region_isos data frame like r2dii.data::region_isos (default). add_green_technologies Logical vector length 1. FALSE defaults outputting technologies present data abcd. Set FALSE add rows possible green technologies (0 production).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"Returns fully joined data frame, linking portfolio, abcd scenario.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"","code":"library(r2dii.data) library(r2dii.match)  valid_matches <- match_name(loanbook_demo, abcd_demo) %>% # WARNING: Remember to validate matches (see `?prioritize`)   prioritize()  valid_matches %>%   join_abcd_scenario(   abcd = abcd_demo,   scenario = scenario_demo_2020,   region_isos = region_isos_demo   ) #> # A tibble: 15,207 × 45 #>    id_loan id_direct_loantaker name_direct_loantaker id_intermediate_parent_1 #>    <chr>   <chr>               <chr>                 <chr>                    #>  1 L6      C304                Kassulke-Kassulke     NA                       #>  2 L6      C304                Kassulke-Kassulke     NA                       #>  3 L6      C304                Kassulke-Kassulke     NA                       #>  4 L6      C304                Kassulke-Kassulke     NA                       #>  5 L6      C304                Kassulke-Kassulke     NA                       #>  6 L6      C304                Kassulke-Kassulke     NA                       #>  7 L6      C304                Kassulke-Kassulke     NA                       #>  8 L6      C304                Kassulke-Kassulke     NA                       #>  9 L6      C304                Kassulke-Kassulke     NA                       #> 10 L6      C304                Kassulke-Kassulke     NA                       #> # ℹ 15,197 more rows #> # ℹ 41 more variables: name_intermediate_parent_1 <chr>, #> #   id_ultimate_parent <chr>, name_ultimate_parent <chr>, #> #   loan_size_outstanding <dbl>, loan_size_outstanding_currency <chr>, #> #   loan_size_credit_limit <dbl>, loan_size_credit_limit_currency <chr>, #> #   sector_classification_system <chr>, sector_classification_input_type <chr>, #> #   sector_classification_direct_loantaker <dbl>, fi_type <chr>, …"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/pipe.html","id":null,"dir":"Reference","previous_headings":"","what":"Pipe operator — %>%","title":"Pipe operator — %>%","text":"See magrittr::%>% details.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/pipe.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Pipe operator — %>%","text":"","code":"lhs %>% rhs"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/pipe.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Pipe operator — %>%","text":"lhs value magrittr placeholder. rhs function call using magrittr semantics.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/pipe.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Pipe operator — %>%","text":"result calling rhs(lhs).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/r2dii.analysis-package.html","id":null,"dir":"Reference","previous_headings":"","what":"r2dii.analysis: Measure Climate Scenario Alignment of Corporate Loans — r2dii.analysis-package","title":"r2dii.analysis: Measure Climate Scenario Alignment of Corporate Loans — r2dii.analysis-package","text":"tools help assess corporate lending portfolio aligns climate goals. summarize key climate indicators attributed portfolio (e.g. production, emission factors), calculate alignment targets based climate scenarios. implement R last step free software 'PACTA' (Paris Agreement Capital Transition Assessment; https://www.transitionmonitor.com/). Financial institutions use 'PACTA' study capital allocation decisions align climate change mitigation goals.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/r2dii.analysis-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"r2dii.analysis: Measure Climate Scenario Alignment of Corporate Loans — r2dii.analysis-package","text":"Maintainer: Alex Axthelm aaxthelm@rmi.org (ORCID) Authors: Jackson Hoffart jackson.hoffart@gmail.com (ORCID) [contractor] Mauro Lepore maurolepore@gmail.com (ORCID) [contractor] Klaus Hogedorn klaus@2degrees-investing.org Nicky Halterman nicholas..halterman@gmail.com contributors: Rocky Mountain Institute PACTA4banks@rmi.org [copyright holder, funder]","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":null,"dir":"Reference","previous_headings":"","what":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"Based weight loan per sector per year, summarize_weighted_production() summarize_weighted_percent_change() summarize production percent-change, respectively.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"","code":"summarize_weighted_production(data, ..., use_credit_limit = FALSE)  summarize_weighted_percent_change(data, ..., use_credit_limit = FALSE)"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"data data frame like output join_abcd_scenario(). ... Variables group . use_credit_limit Logical vector length 1. FALSE defaults using column loan_size_outstanding. Set TRUE instead use column loan_size_credit_limit.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"tibble groups input () columns: sector, technology, year; weighted_production weighted_production summarize_weighted_production() summarize_weighted_percent_change(), respectively.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"warning","dir":"Reference","previous_headings":"","what":"Warning","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"percent-change analysis excludes companies 0 production. percent-change undefined companies initial production; including companies cause percent-change percentage infinite, wrong.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"","code":"library(r2dii.data) library(r2dii.match)  loanbook <- head(loanbook_demo, 150) abcd <- head(abcd_demo, 100) master <- loanbook %>%   match_name(abcd) %>%   prioritize() %>%   join_abcd_scenario(     abcd = abcd,     scenario = scenario_demo_2020,     region_isos = region_isos_demo     ) %>%   dplyr::filter(production != 0)  summarize_weighted_production(master) #> # A tibble: 12 × 5 #>    sector_abcd technology     year weighted_production weighted_technology_share #>    <chr>       <chr>         <int>               <dbl>                     <dbl> #>  1 power       hydrocap       2020              50971.                     0.421 #>  2 power       hydrocap       2021              50230.                     0.421 #>  3 power       hydrocap       2022              49490.                     0.421 #>  4 power       hydrocap       2023              48749.                     0.421 #>  5 power       hydrocap       2024              48009.                     0.421 #>  6 power       hydrocap       2025              47268.                     0.421 #>  7 power       renewablescap  2020              61070.                     3.35  #>  8 power       renewablescap  2021              61103.                     3.35  #>  9 power       renewablescap  2022              61137.                     3.35  #> 10 power       renewablescap  2023              61170.                     3.35  #> 11 power       renewablescap  2024              61204.                     3.35  #> 12 power       renewablescap  2025              42533.                     2.85   summarize_weighted_production(master, use_credit_limit = TRUE) #> # A tibble: 12 × 5 #>    sector_abcd technology     year weighted_production weighted_technology_share #>    <chr>       <chr>         <int>               <dbl>                     <dbl> #>  1 power       hydrocap       2020              46073.                     0.381 #>  2 power       hydrocap       2021              45404.                     0.381 #>  3 power       hydrocap       2022              44734.                     0.381 #>  4 power       hydrocap       2023              44065.                     0.381 #>  5 power       hydrocap       2024              43396.                     0.381 #>  6 power       hydrocap       2025              42726.                     0.381 #>  7 power       renewablescap  2020              60695.                     3.37  #>  8 power       renewablescap  2021              60416.                     3.37  #>  9 power       renewablescap  2022              60138.                     3.37  #> 10 power       renewablescap  2023              59860.                     3.37  #> 11 power       renewablescap  2024              59582.                     3.37  #> 12 power       renewablescap  2025              44619.                     2.98   summarize_weighted_percent_change(master) #> # A tibble: 12 × 4 #>    sector_abcd technology     year weighted_percent_change #>    <chr>       <chr>         <int>                   <dbl> #>  1 power       hydrocap       2020                0        #>  2 power       hydrocap       2021               -0.0873   #>  3 power       hydrocap       2022               -0.175    #>  4 power       hydrocap       2023               -0.262    #>  5 power       hydrocap       2024               -0.349    #>  6 power       hydrocap       2025               -0.436    #>  7 power       renewablescap  2020                0        #>  8 power       renewablescap  2021                0.000439 #>  9 power       renewablescap  2022                0.000877 #> 10 power       renewablescap  2023                0.00132  #> 11 power       renewablescap  2024                0.00175  #> 12 power       renewablescap  2025               -0.0858    summarize_weighted_percent_change(master, use_credit_limit = TRUE) #> # A tibble: 12 × 4 #>    sector_abcd technology     year weighted_percent_change #>    <chr>       <chr>         <int>                   <dbl> #>  1 power       hydrocap       2020                 0       #>  2 power       hydrocap       2021                -0.0789  #>  3 power       hydrocap       2022                -0.158   #>  4 power       hydrocap       2023                -0.237   #>  5 power       hydrocap       2024                -0.316   #>  6 power       hydrocap       2025                -0.395   #>  7 power       renewablescap  2020                 0       #>  8 power       renewablescap  2021                -0.00364 #>  9 power       renewablescap  2022                -0.00729 #> 10 power       renewablescap  2023                -0.0109  #> 11 power       renewablescap  2024                -0.0146  #> 12 power       renewablescap  2025                -0.0898"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":null,"dir":"Reference","previous_headings":"","what":"Add targets for production, using the market share approach — target_market_share","title":"Add targets for production, using the market share approach — target_market_share","text":"function calculates portfolio-level production targets, calculated using market share approach applied relevant climate production forecast.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add targets for production, using the market share approach — target_market_share","text":"","code":"target_market_share(   data,   abcd,   scenario,   region_isos = r2dii.data::region_isos,   use_credit_limit = FALSE,   by_company = FALSE,   weight_production = TRUE,   increasing_or_decreasing = r2dii.data::increasing_or_decreasing )"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add targets for production, using the market share approach — target_market_share","text":"data \"data.frame\" like output r2dii.match::prioritize. abcd asset level data frame like r2dii.data::abcd_demo. scenario scenario data frame like r2dii.data::scenario_demo_2020. region_isos data frame like r2dii.data::region_isos (default). use_credit_limit Logical vector length 1. FALSE defaults using column loan_size_outstanding. Set TRUE use column loan_size_credit_limit instead. by_company Logical vector length 1. FALSE defaults outputting production_value portfolio-level. Set TRUE output production_value company-level. weight_production Logical vector length 1. TRUE defaults outputting production, weighted relative loan-size. Set FALSE output unweighted production values. increasing_or_decreasing data frame like r2dii.data::increasing_or_decreasing.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add targets for production, using the market share approach — target_market_share","text":"tibble including summarized columns metric, production, technology_share, percentage_of_initial_production_by_scope scope. by_company = TRUE, output also column name_abcd.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"handling-grouped-data","dir":"Reference","previous_headings":"","what":"Handling grouped data","title":"Add targets for production, using the market share approach — target_market_share","text":"function ignores existing groups outputs ungrouped data.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add targets for production, using the market share approach — target_market_share","text":"","code":"library(r2dii.data) library(r2dii.match)  loanbook <- head(loanbook_demo, 100) abcd <- head(abcd_demo, 100)  matched <- loanbook %>%   match_name(abcd) %>%   prioritize()  # Calculate targets at portfolio level matched %>%   target_market_share(     abcd = abcd,     scenario = scenario_demo_2020,     region_isos = region_isos_demo     ) #> # A tibble: 373 × 10 #>    sector technology  year region scenario_source metric     production #>    <chr>  <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 power  hydrocap    2020 global demo_2020       projected      16990. #>  2 power  hydrocap    2020 global demo_2020       target_cps     16990. #>  3 power  hydrocap    2020 global demo_2020       target_sds     16990. #>  4 power  hydrocap    2020 global demo_2020       target_sps     16990. #>  5 power  hydrocap    2021 global demo_2020       projected      16743. #>  6 power  hydrocap    2021 global demo_2020       target_cps     17004. #>  7 power  hydrocap    2021 global demo_2020       target_sds     17012. #>  8 power  hydrocap    2021 global demo_2020       target_sps     17005. #>  9 power  hydrocap    2022 global demo_2020       projected      16497. #> 10 power  hydrocap    2022 global demo_2020       target_cps     17018. #> # ℹ 363 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>  # Calculate targets at company level matched %>%   target_market_share(   abcd = abcd,   scenario = scenario_demo_2020,   region_isos = region_isos_demo,   by_company = TRUE   ) #> Warning: You've supplied `by_company = TRUE` and `weight_production = TRUE`. #> This will result in company-level results, weighted by the portfolio #> loan size, which is rarely useful. Did you mean to set one of these #> arguments to `FALSE`? #> # A tibble: 1,408 × 11 #>    sector technology  year region scenario_source name_abcd    metric production #>    <chr>  <chr>      <int> <chr>  <chr>           <chr>        <chr>       <dbl> #>  1 power  hydrocap    2020 global demo_2020       Giordano, G… proje…     16990. #>  2 power  hydrocap    2020 global demo_2020       Giordano, G… targe…     16990. #>  3 power  hydrocap    2020 global demo_2020       Giordano, G… targe…     16990. #>  4 power  hydrocap    2020 global demo_2020       Giordano, G… targe…     16990. #>  5 power  hydrocap    2021 global demo_2020       Giordano, G… proje…     16743. #>  6 power  hydrocap    2021 global demo_2020       Giordano, G… targe…     17004. #>  7 power  hydrocap    2021 global demo_2020       Giordano, G… targe…     17012. #>  8 power  hydrocap    2021 global demo_2020       Giordano, G… targe…     17005. #>  9 power  hydrocap    2022 global demo_2020       Giordano, G… proje…     16497. #> 10 power  hydrocap    2022 global demo_2020       Giordano, G… targe…     17018. #> # ℹ 1,398 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>  matched %>%   target_market_share(     abcd = abcd,     scenario = scenario_demo_2020,     region_isos = region_isos_demo,     # Calculate unweighted targets     weight_production = FALSE     ) #> # A tibble: 373 × 10 #>    sector technology  year region scenario_source metric     production #>    <chr>  <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 power  hydrocap    2020 global demo_2020       projected     121032. #>  2 power  hydrocap    2020 global demo_2020       target_cps    121032. #>  3 power  hydrocap    2020 global demo_2020       target_sds    121032. #>  4 power  hydrocap    2020 global demo_2020       target_sps    121032. #>  5 power  hydrocap    2021 global demo_2020       projected     119274. #>  6 power  hydrocap    2021 global demo_2020       target_cps    121129. #>  7 power  hydrocap    2021 global demo_2020       target_sds    121187. #>  8 power  hydrocap    2021 global demo_2020       target_sps    121139. #>  9 power  hydrocap    2022 global demo_2020       projected     117515. #> 10 power  hydrocap    2022 global demo_2020       target_cps    121227. #> # ℹ 363 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":null,"dir":"Reference","previous_headings":"","what":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"function calculates targets CO2 emissions per unit production portfolio-level, otherwise referred \"emissions factors\". uses sectoral-decarbonization approach (SDA) calculate targets.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"","code":"target_sda(   data,   abcd,   co2_intensity_scenario,   use_credit_limit = FALSE,   by_company = FALSE,   region_isos = r2dii.data::region_isos )"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"data dataframe like output r2dii.match::prioritize(). abcd asset-level data frame like r2dii.data::abcd_demo. co2_intensity_scenario scenario data frame like r2dii.data::co2_intensity_scenario_demo. use_credit_limit Logical vector length 1. FALSE defaults using column loan_size_outstanding. Set TRUE instead use column loan_size_credit_limit. by_company Logical vector length 1. FALSE defaults outputting weighted_production_value portfolio-level. Set TRUE output weighted_production_value company-level. region_isos data frame like r2dii.data::region_isos (default).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"tibble including summarized columns emission_factor_metric emission_factor_value. by_company = TRUE, output also column name_abcd.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"handling-grouped-data","dir":"Reference","previous_headings":"","what":"Handling grouped data","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"function ignores existing groups outputs ungrouped data.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"","code":"library(r2dii.match) library(r2dii.data)  loanbook <- head(loanbook_demo, 150) abcd <- head(abcd_demo, 100)  matched <- loanbook %>%   match_name(abcd) %>%   prioritize()  # Calculate targets at portfolio level matched %>%   target_sda(    abcd = abcd,    co2_intensity_scenario = co2_intensity_scenario_demo,    region_isos = region_isos_demo    ) #> Warning: Removing rows in abcd where `emission_factor` is NA #> Warning: Found no match between loanbook and abcd. #> # A tibble: 0 × 4 #> # ℹ 4 variables: sector <chr>, year <int>, emission_factor_metric <chr>, #> #   emission_factor_value <dbl>  # Calculate targets at company level matched %>%   target_sda(    abcd = abcd,    co2_intensity_scenario = co2_intensity_scenario_demo,    region_isos = region_isos_demo,    by_company = TRUE    ) #> Warning: Removing rows in abcd where `emission_factor` is NA #> Warning: Found no match between loanbook and abcd. #> # A tibble: 0 × 4 #> # ℹ 4 variables: sector <chr>, year <int>, emission_factor_metric <chr>, #> #   emission_factor_value <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/tidyeval.html","id":null,"dir":"Reference","previous_headings":"","what":"Tidy eval helpers — tidyeval","title":"Tidy eval helpers — tidyeval","text":"learn tidy eval use tools, check Metaprogramming section Advanced R.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/tidyeval.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Tidy eval helpers — tidyeval","text":"sym() creates symbol string syms() creates list symbols character vector. enquo() enquos() delay execution one several function arguments. enquo() returns single quoted expression, like blueprint delayed computation. enquos() returns list quoted expressions. expr() quotes new expression locally. mostly useful build new expressions around arguments captured enquo() enquos(): expr(mean(!!enquo(arg), na.rm = TRUE)). as_name() transforms quoted variable name string. Supplying something else quoted variable name error. unlike as_label() also returns single string supports kind R object input, including quoted function calls vectors. purpose summarise object single label. label often suitable default name. know quoted expression contains (instance expressions captured enquo() variable name, call function, unquoted constant), use as_label(). know quoted simple variable name, like enforce , use as_name().","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-040","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.4.0","title":"r2dii.analysis 0.4.0","text":"target_market_share now outputs target_* value years scenario (#481). Complete deprecation ald favour abcd (#466). target_market_share now correctly handles input scenarios hyphen name (#425). target_market_share now handles abcd rows production NA filling 0 (#423).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-030","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.3.0","title":"r2dii.analysis 0.3.0","text":"CRAN release: 2023-10-23 target_sda now uses final year scenario convergence target by_company = TRUE (#445). target_market_share gains argument increasing_or_decreasing (#426).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-021","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.2.1","title":"r2dii.analysis 0.2.1","text":"CRAN release: 2022-11-03 r2dii.analysis transferred new organization: https://github.com/RMI-PACTA/.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-020","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.2.0","title":"r2dii.analysis 0.2.0","text":"CRAN release: 2022-05-05 New argument abcd target_market_share() target_sda supersedes argument ald (#404). target_sda() now outputs data sector values three input datasets (data, ald co2_intensity_scenario) (#390). target_sda() now outputs unweighted emission_factor by_company TRUE (#376). target_sda() gains region_isos argument (#323). target_market_share() now outputs values years ald scenario inputs (#394). target_market_share() now outputs two new columns, percentage_of_initial_production_by_scope scope (ADO #4143).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-0112","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.12","title":"r2dii.analysis 0.1.12","text":"CRAN release: 2021-08-18 target_market_share() now outputs 0 technology_share, companies 0 sectoral production (#306 @Antoine-Lalechere). target_sda() now filters scenario start year consistent ald start year (#346 @waltjl).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-0110","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.10","title":"r2dii.analysis 0.1.10","text":"CRAN release: 2021-07-09 target_market_share() now sets negative smsp targets zero (#336). target_market_share() now outputs sectors present input datasets (#329). target_market_share() now always adds targets green technologies (defined r2dii.data::green_or_brown), even present input data (#318 @Antoine-Lalechere). target_market_share() now correctly groups region calculating technology_share (#315 @Antoine-Lalechere).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-019","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.9","title":"r2dii.analysis 0.1.9","text":"CRAN release: 2021-06-30 target_sda() now outputs sector values present input co2_intensity_scenario data (#308). target_sda() now outputs targets range years input co2_intenstiy_scenario (#307).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-018","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.8","title":"r2dii.analysis 0.1.8","text":"CRAN release: 2021-05-22 target_market_share() now correctly outputs target technology share, line methodology (@georgeharris2deg #277). target_market_share() now correctly projects technology share ‘production / total production’ computing company, unweighted relative loan size (@KapitanKombajn #288). target_market_share() longer outputs columns sector_weighted_production technology_weighted_production. columns internal shouldn’t face users (#291).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-016","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.6","title":"r2dii.analysis 0.1.6","text":"CRAN release: 2021-03-10 target_market_share() now correctly outputs technology_share multiple loans different level company (@ab-bbva #265).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-015","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.5","title":"r2dii.analysis 0.1.5","text":"CRAN release: 2021-01-22 target_market_share() now errors input data unexpected column (@georgeharris2deg #267). target_market_share() now correctly outputs technology_share multiple loans company (@georgeharris2deg #262, @ab-bbva #265).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-014","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.4","title":"r2dii.analysis 0.1.4","text":"CRAN release: 2021-01-05 target_market_share() now correctly outputs unweighted production company, equal ald-production one company multiple loans different size (#255 @georgeharris2deg).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-013","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.3","title":"r2dii.analysis 0.1.3","text":"CRAN release: 2020-12-15 target_market_share() now correctly outputs unweighted production multiple levels exist company (#249).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-012","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.2","title":"r2dii.analysis 0.1.2","text":"CRAN release: 2020-12-05 target_market_share() now outputs weighted_technology_share correctly sums 1 grouped sector, metric scenario (#218). target_market_share() now correctly outputs unweighted production multiple loans exist company (#239). target_market_share() now outputs empty named tibble matching region definitions can found (#236). target_market_share now outputs technologies present ald, even present data (#235). target_sda() now interpolates input scenario file year correctly calculates target, regardless time-horizon ald (#234). Hyperlinks “Get Started” tab website now points correct links (#222 @apmanning). Depend dplyr >= 0.8.5, explicitly. commit version newer dplyr 1 still relatively new, represents major change users initially resist. Relax dependency rlang, mostly driven dynamically recursive dependencies. example, dplyr 0.8.5 depends specific version rlang recent version explicitly depended – suggests explicit rlang unhelpful misleading. New internal data loanbook_stable region_isos_stable make regression tests stable (#227).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-011","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.1","title":"r2dii.analysis 0.1.1","text":"CRAN release: 2020-09-12 Change license MIT. website’s home page now thanks founders. target_market_share() now works expected value column scenario missing value column region. longer results output columns production technology_share type “list” (#203). website now shows News tab.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-010","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.0","title":"r2dii.analysis 0.1.0","text":"CRAN release: 2020-09-03 target_sda() now correctly handles differing country_of_domicile inputs (#171). target_market_share() now outputs technology_share (#184). join_ald_scenario() now returns visibly dev-magrittr (#188 @lionel-). target_market_share() gains weight_production parameter (#181). target_market_share() now correctly use sector_ald column input data argument (#178). target_sda() now automatically filters ald rows emissions_factor values NA (#173). join_ald_scenario() now converts lower case values columns sector_ald technology (#172). target_sda() now aggregates input ald technology plant_location prior calculating targets (@QianFeng2020 #160). target_sda() now errors input data duplicated id_loan (@QianFeng2020 #164). target_sda() gains by_company parameter (#155). target_market_share() now outputs actual aggregated corporate economy. Previously, output , erroneously, normalized starting portfolio value (#158). target_sda() now correctly calculates SDA targets (#153): Targets now calculated using scenario data adjusted corporate economy data. adjusted scenario data also output function along usual metrics. Methodology error fixed, reflected code. Previously, target , incorrectly, calculated multiplying adjusted scenario. Now scenario data added instead. New summarize_weighted_percent_change() allows user calculate new indicator (#141). target_market_share() longer errors combination sector scenario_target_value uniquely identify observation (@georgeharris2deg #142).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-001","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.0.1","title":"r2dii.analysis 0.0.1","text":"CRAN release: 2020-06-28 First release CRAN","code":""}]
+[{"path":"https://rmi-pacta.github.io/r2dii.analysis/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2020 Rocky Mountain Institute Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/production-percent-change.html","id":"weighted-production","dir":"Articles","previous_headings":"","what":"Weighted Production","title":"Indicator Choices:","text":"intents purposes, recommend calculating targets using loan weighted production indicator. particular, define loan weighted production given company, \\(j\\) : \\[ \\overline{p}_{,j}(t) = p_{,j}(t) * \\dfrac{l_j}{\\sum_j l_j}\\] \\(p_{,j}\\) production company \\(\\) technology \\(j\\) \\(l_j\\) loan given company \\(j\\). calculate portfolio targets, aggregate value summing every company portfolio: \\[ \\overline{p}_i (t) = \\sum_j \\left[  p_{,j}(t) * \\dfrac{l_j}{\\sum_j l_j} \\right] \\] Effectively, loan-weighted average production attributed company portfolio. significant result indicator choice small companies (little production) favorably weighted, given loan company sufficiently large. can useful reflect large investments green start-ups. calculate weighted production:","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis)  master <- loanbook_demo %>%   match_name(abcd_demo) %>%   prioritize() %>%   join_abcd_scenario(     abcd = abcd_demo,     scenario = scenario_demo_2020,     region_isos = region_isos_demo,     add_green_technologies = FALSE   )  summarize_weighted_production(master) #> # A tibble: 168 × 5 #>    sector_abcd technology  year weighted_production weighted_technology_share #>    <chr>       <chr>      <int>               <dbl>                     <dbl> #>  1 automotive  electric    2020             436948.                     0.481 #>  2 automotive  electric    2021             442439.                     0.480 #>  3 automotive  electric    2022             447929.                     0.480 #>  4 automotive  electric    2023             453420.                     0.479 #>  5 automotive  electric    2024             458910.                     0.479 #>  6 automotive  electric    2025             464401.                     0.479 #>  7 automotive  electric    2026                 NA                     NA     #>  8 automotive  electric    2027                 NA                     NA     #>  9 automotive  electric    2028                 NA                     NA     #> 10 automotive  electric    2029                 NA                     NA     #> # ℹ 158 more rows"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/production-percent-change.html","id":"weighted-percent-change-in-production","dir":"Articles","previous_headings":"","what":"Weighted Percent Change in Production","title":"Indicator Choices:","text":"-hand, ’re keen understand large corporations portfolio planning make significant changes, percent change production may useful indicator. company, define percent change, \\(\\chi_i(t)\\), compared start year, \\(t_0\\): \\[ \\chi_i(t) =  \\dfrac{p_{}(t)-p_{}(t_0)}{p_i(t_0)} * 100\\] \\(p_i(t)\\) indicator (production capacity) technology \\(\\), \\(t0\\) start year analysis. aggregate percent-change production company portfolio-level, using loan-weighted average . particular, loan \\(l_j\\) company \\(j\\), : \\[ \\overline{\\chi_i} = \\sum_j \\left[ \\chi_{,j} * \\dfrac{l_j}{\\sum_j l_j} \\right]\\] noted percent change, \\(\\chi\\), undefined 0 initial production. Intuitively, makes sense, since require “infinite percent” build-grow anything 0. reason, company 0 initial production filtered prior calculating percent change indicator. calculate weighted percent change:","code":"# using the master dataset defined in the previous chunk: summarize_weighted_percent_change(master) #> # A tibble: 168 × 4 #>    sector_abcd technology  year weighted_percent_change #>    <chr>       <chr>      <int>                   <dbl> #>  1 automotive  electric    2020               0         #>  2 automotive  electric    2021               0.0000626 #>  3 automotive  electric    2022               0.000125  #>  4 automotive  electric    2023               0.000188  #>  5 automotive  electric    2024               0.000250  #>  6 automotive  electric    2025               0.000313  #>  7 automotive  electric    2026              NA         #>  8 automotive  electric    2027              NA         #>  9 automotive  electric    2028              NA         #> 10 automotive  electric    2029              NA         #> # ℹ 158 more rows"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"load-your-r2dii-libraries","dir":"Articles","previous_headings":"","what":"Load your r2dii libraries","title":"Introduction to r2dii.analysis","text":"first step analysis load recommended r2dii packages current R session. r2dii.data includes fake data help demonstrate tool r2dii.match provides functions help easily match loanbook asset-level data. plot results, may also load package r2dii.plot. also recommend packages tidyverse; optional useful.","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis) library(r2dii.plot) library(tidyverse) #> ── Attaching core tidyverse packages ──────────────────────── tidyverse 2.0.0 ── #> ✔ dplyr     1.1.4     ✔ readr     2.1.5 #> ✔ forcats   1.0.0     ✔ stringr   1.5.1 #> ✔ ggplot2   3.5.0     ✔ tibble    3.2.1 #> ✔ lubridate 1.9.3     ✔ tidyr     1.3.1 #> ✔ purrr     1.0.2      #> ── Conflicts ────────────────────────────────────────── tidyverse_conflicts() ── #> ✖ dplyr::filter() masks stats::filter() #> ✖ dplyr::lag()    masks stats::lag() #> ℹ Use the conflicted package (<http://conflicted.r-lib.org/>) to force all conflicts to become errors"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"match-your-loanbook-to-climate-related-asset-level-data","dir":"Articles","previous_headings":"","what":"Match your loanbook to climate-related asset-level data","title":"Introduction to r2dii.analysis","text":"See r2dii.match complete description process.","code":"# Use these datasets to practice but eventually you should use your own data. # The optional syntax `package::data` is to clarify where the data comes from. loanbook <- r2dii.data::loanbook_demo abcd <- r2dii.data::abcd_demo  matched <- match_name(loanbook, abcd) %>% prioritize()  matched #> # A tibble: 177 × 28 #>    id_loan id_direct_loantaker name_direct_loantaker      id_intermediate_pare…¹ #>    <chr>   <chr>               <chr>                      <chr>                  #>  1 L6      C304                Kassulke-Kassulke          NA                     #>  2 L13     C297                Ladeck                     NA                     #>  3 L20     C287                Weinhold                   NA                     #>  4 L21     C286                Gallo Group                NA                     #>  5 L22     C285                Austermuhle GmbH           NA                     #>  6 L24     C282                Ferraro-Ferraro Group      NA                     #>  7 L25     C281                Lockman, Lockman and Lock… NA                     #>  8 L26     C280                Ankunding, Ankunding and … NA                     #>  9 L27     C278                Donati-Donati Group        NA                     #> 10 L28     C276                Ferraro, Ferraro e Ferrar… NA                     #> # ℹ 167 more rows #> # ℹ abbreviated name: ¹​id_intermediate_parent_1 #> # ℹ 24 more variables: name_intermediate_parent_1 <chr>, #> #   id_ultimate_parent <chr>, name_ultimate_parent <chr>, #> #   loan_size_outstanding <dbl>, loan_size_outstanding_currency <chr>, #> #   loan_size_credit_limit <dbl>, loan_size_credit_limit_currency <chr>, #> #   sector_classification_system <chr>, …"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"calculate-targets","dir":"Articles","previous_headings":"","what":"Calculate targets","title":"Introduction to r2dii.analysis","text":"can calculate scenario targets using two different approaches: Market Share Approach, Sectoral Decarbonization Approach.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"market-share-approach","dir":"Articles","previous_headings":"Calculate targets","what":"Market Share Approach","title":"Introduction to r2dii.analysis","text":"Market Share Approach used calculate scenario targets production technology sector. example, can use approach set targets production electric vehicles automotive sector. approach recommended sectors granular technology scenario roadmap exists. Targets can set portfolio level: company level:","code":"# Use these datasets to practice but eventually you should use your own data. scenario <- r2dii.data::scenario_demo_2020 regions <- r2dii.data::region_isos_demo  market_share_targets_portfolio <- matched %>%   target_market_share(     abcd = abcd,     scenario = scenario,     region_isos = regions   )  market_share_targets_portfolio #> # A tibble: 1,076 × 10 #>    sector     technology  year region scenario_source metric     production #>    <chr>      <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 automotive electric    2020 global demo_2020       projected     145649. #>  2 automotive electric    2020 global demo_2020       target_cps    145649. #>  3 automotive electric    2020 global demo_2020       target_sds    145649. #>  4 automotive electric    2020 global demo_2020       target_sps    145649. #>  5 automotive electric    2021 global demo_2020       projected     147480. #>  6 automotive electric    2021 global demo_2020       target_cps    146915. #>  7 automotive electric    2021 global demo_2020       target_sds    153332. #>  8 automotive electric    2021 global demo_2020       target_sps    147258. #>  9 automotive electric    2022 global demo_2020       projected     149310. #> 10 automotive electric    2022 global demo_2020       target_cps    148155. #> # ℹ 1,066 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl> market_share_targets_company <- matched %>%   target_market_share(     abcd = abcd,     scenario = scenario,     region_isos = regions,     # Output results at company-level.     by_company = TRUE    ) #> Warning: You've supplied `by_company = TRUE` and `weight_production = TRUE`. #> This will result in company-level results, weighted by the portfolio #> loan size, which is rarely useful. Did you mean to set one of these #> arguments to `FALSE`?  market_share_targets_company #> # A tibble: 14,505 × 11 #>    sector    technology  year region scenario_source name_abcd metric production #>    <chr>     <chr>      <int> <chr>  <chr>           <chr>     <chr>       <dbl> #>  1 automoti… electric    2020 global demo_2020       Bernardi… proje…     17951. #>  2 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  3 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  4 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  5 automoti… electric    2020 global demo_2020       Christia… proje…     11471. #>  6 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  7 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  8 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  9 automoti… electric    2020 global demo_2020       Donati, … proje…      5611. #> 10 automoti… electric    2020 global demo_2020       Donati, … targe…      5611. #> # ℹ 14,495 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"sectoral-decarbonization-approach","dir":"Articles","previous_headings":"Calculate targets","what":"Sectoral Decarbonization Approach","title":"Introduction to r2dii.analysis","text":"Sectoral Decarbonization Approach used calculate scenario targets emission_factor sector. example, can use approach set targets average emission factor cement sector. approach recommended sectors lacking technology roadmaps.","code":"# Use this dataset to practice but eventually you should use your own data. co2 <- r2dii.data::co2_intensity_scenario_demo  sda_targets <- matched %>%   target_sda(abcd = abcd, co2_intensity_scenario = co2, region_isos = regions) %>%    filter(sector == \"cement\", year >= 2020) #> Warning: Removing rows in abcd where `emission_factor` is NA  sda_targets #> # A tibble: 110 × 6 #>    sector  year region             scenario_source emission_factor_metric #>    <chr>  <dbl> <chr>              <chr>           <chr>                  #>  1 cement  2020 advanced economies demo_2020       projected              #>  2 cement  2020 developing asia    demo_2020       projected              #>  3 cement  2020 global             demo_2020       projected              #>  4 cement  2021 advanced economies demo_2020       projected              #>  5 cement  2021 developing asia    demo_2020       projected              #>  6 cement  2021 global             demo_2020       projected              #>  7 cement  2022 advanced economies demo_2020       projected              #>  8 cement  2022 developing asia    demo_2020       projected              #>  9 cement  2022 global             demo_2020       projected              #> 10 cement  2023 advanced economies demo_2020       projected              #> # ℹ 100 more rows #> # ℹ 1 more variable: emission_factor_value <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"visualization","dir":"Articles","previous_headings":"","what":"Visualization","title":"Introduction to r2dii.analysis","text":"large variety possible visualizations stemming outputs target_market_share() target_sda(). , highlight couple common plots can easily created using r2dii.plot package.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"market-share-sector-level-technology-mix","dir":"Articles","previous_headings":"Visualization","what":"Market Share: Sector-level technology mix","title":"Introduction to r2dii.analysis","text":"market share output, can plot portfolio’s exposure various climate sensitive technologies (projected), compare corporate economy, various scenario targets.","code":"# Pick the targets you want to plot. data <- filter(   market_share_targets_portfolio,   scenario_source == \"demo_2020\",   sector == \"power\",   region == \"global\",   metric %in% c(\"projected\", \"corporate_economy\", \"target_sds\") )  # Plot the technology mix qplot_techmix(data) #> The `technology_share` values are plotted for extreme years. #> Do you want to plot different years? E.g. filter . with:`subset(., year %in% c(2020, 2030))`. #> Warning: Removed 3 rows containing missing values or values outside the scale range #> (`geom_bar()`)."},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"market-share-technology-level-volume-trajectory","dir":"Articles","previous_headings":"Visualization","what":"Market Share: Technology-level volume trajectory","title":"Introduction to r2dii.analysis","text":"can also plot technology-specific volume trend. starting values normalized 1, emphasize comparing rates buildout /retirement.","code":"data <- filter(   market_share_targets_portfolio,   sector == \"power\",   technology == \"renewablescap\",   region == \"global\",   scenario_source == \"demo_2020\" )  qplot_trajectory(data)"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/r2dii-analysis.html","id":"sda-target","dir":"Articles","previous_headings":"Visualization","what":"SDA Target","title":"Introduction to r2dii.analysis","text":"SDA output, can compare projected average emission intensity attributed portfolio, actual emission intensity scenario, scenario compliant SDA pathway portfolio must follow achieve scenario ambition 2050.","code":"data <- filter(sda_targets, sector == \"cement\", region == \"global\") qplot_emission_intensity(data)"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-market-share.html","id":"scenario-market-shares","dir":"Articles","previous_headings":"","what":"Scenario market-shares","title":"Market Share Approach","text":"Say want study portfolio perform specific climate scenario. can allocate scenario efforts production profile portfolio? can two ways – technology, sector.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-market-share.html","id":"market-share-by-technology","dir":"Articles","previous_headings":"Scenario market-shares","what":"1. Market-share by technology","title":"Market Share Approach","text":"define market-share technology : \\[p_{}^{tmsr}(t) = p_{}(t_{0}) +  p_{}(t_{0}) * \\frac{s_i(t) - s_{}(t_0)}{s_i(t_0)}\\] can see reduces : \\[p_{}^{tmsr}(t) = p_{}(t_{0}) \\left(1 + \\frac{s_i(t) - s_{}(t_0)}{s_i(t_0)} \\right) \\\\ p_{}^{tmsr}(t) = p_{}(t_{0}) \\left(1 + \\frac{s_i(t)}{s_i(t_0)} -1 \\right) \\\\ p_{}^{tmsr}(t) = p_{}(t_{0}) * \\frac{s_i(t)}{s_i(t_0)}\\] : \\(s_i(t)\\) scenario production technology \\(\\) time \\(t\\), \\(p_{}(t_0)\\) production allocated portfolio technology, \\(\\) time \\(t_0\\), \\(p_{}^{tmsr}(t)\\) portfolio-specific target production technology. define “Technology Market Share Ratio” : \\[\\dfrac{s_i(t)}{s_i(t_0)}\\] method used set targets “decreasing” (ie. brown) technologies.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-market-share.html","id":"market-share-by-sector","dir":"Articles","previous_headings":"Scenario market-shares","what":"2. Market-share by sector","title":"Market Share Approach","text":"calculate market-share sector, use initial production portfolio scenario sector-level instead. \\[p_{}^{smsp}(t) = p_{}(t_0) +P(t_0) * \\left( \\dfrac{s_i(t)-s_i(t_0)}{S(t_0)}\\right)\\] : \\(P_i(t_0)\\) portfolio’s total production sector \\(t_0\\), \\(S(t_0)\\) scenario total production \\(t_0\\). define “Sector Market Share Percentage” : \\[\\dfrac{s_i(t)-s_i(t_0)}{S(t_0)}\\] method used calculate targets “increasing” (ie. green) technologies.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-market-share.html","id":"how-to-calculate-market-share-targets-for-a-given-scenario","dir":"Articles","previous_headings":"","what":"How to calculate market-share targets for a given scenario","title":"Market Share Approach","text":"calculate market-share targets, need use package r2dii.analysis number datasets. One datasets “matched” dataset (loanbook + asset-level data) can get package r2dii.match. datasets use come package r2dii.data; fake show structure data. Use packages. Match loanbook asset level data. Calculate market-share targets production portfolio level. Calculate market-share targets production company level.","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis) loanbook <- r2dii.data::loanbook_demo abcd <- r2dii.data::abcd_demo  matched <- match_name(loanbook, abcd) %>%   # WARNING: Remember to validate the output of match_name() before prioritize()   prioritize()  matched #> # A tibble: 177 × 28 #>    id_loan id_direct_loantaker name_direct_loantaker      id_intermediate_pare…¹ #>    <chr>   <chr>               <chr>                      <chr>                  #>  1 L6      C304                Kassulke-Kassulke          NA                     #>  2 L13     C297                Ladeck                     NA                     #>  3 L20     C287                Weinhold                   NA                     #>  4 L21     C286                Gallo Group                NA                     #>  5 L22     C285                Austermuhle GmbH           NA                     #>  6 L24     C282                Ferraro-Ferraro Group      NA                     #>  7 L25     C281                Lockman, Lockman and Lock… NA                     #>  8 L26     C280                Ankunding, Ankunding and … NA                     #>  9 L27     C278                Donati-Donati Group        NA                     #> 10 L28     C276                Ferraro, Ferraro e Ferrar… NA                     #> # ℹ 167 more rows #> # ℹ abbreviated name: ¹​id_intermediate_parent_1 #> # ℹ 24 more variables: name_intermediate_parent_1 <chr>, #> #   id_ultimate_parent <chr>, name_ultimate_parent <chr>, #> #   loan_size_outstanding <dbl>, loan_size_outstanding_currency <chr>, #> #   loan_size_credit_limit <dbl>, loan_size_credit_limit_currency <chr>, #> #   sector_classification_system <chr>, … # portfolio level targets scenario <- r2dii.data::scenario_demo_2020 regions <- r2dii.data::region_isos_demo   matched %>% target_market_share(abcd, scenario, regions) #> # A tibble: 1,076 × 10 #>    sector     technology  year region scenario_source metric     production #>    <chr>      <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 automotive electric    2020 global demo_2020       projected     145649. #>  2 automotive electric    2020 global demo_2020       target_cps    145649. #>  3 automotive electric    2020 global demo_2020       target_sds    145649. #>  4 automotive electric    2020 global demo_2020       target_sps    145649. #>  5 automotive electric    2021 global demo_2020       projected     147480. #>  6 automotive electric    2021 global demo_2020       target_cps    146915. #>  7 automotive electric    2021 global demo_2020       target_sds    153332. #>  8 automotive electric    2021 global demo_2020       target_sps    147258. #>  9 automotive electric    2022 global demo_2020       projected     149310. #> 10 automotive electric    2022 global demo_2020       target_cps    148155. #> # ℹ 1,066 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl> matched %>% target_market_share(abcd, scenario, regions, by_company = TRUE) #> Warning: You've supplied `by_company = TRUE` and `weight_production = TRUE`. #> This will result in company-level results, weighted by the portfolio #> loan size, which is rarely useful. Did you mean to set one of these #> arguments to `FALSE`? #> # A tibble: 14,505 × 11 #>    sector    technology  year region scenario_source name_abcd metric production #>    <chr>     <chr>      <int> <chr>  <chr>           <chr>     <chr>       <dbl> #>  1 automoti… electric    2020 global demo_2020       Bernardi… proje…     17951. #>  2 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  3 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  4 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  5 automoti… electric    2020 global demo_2020       Christia… proje…     11471. #>  6 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  7 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  8 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  9 automoti… electric    2020 global demo_2020       Donati, … proje…      5611. #> 10 automoti… electric    2020 global demo_2020       Donati, … targe…      5611. #> # ℹ 14,495 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-sda.html","id":"sda-methodology","dir":"Articles","previous_headings":"","what":"SDA Methodology","title":"Sectoral Decarbonization Approach (SDA)","text":"Sectoral Decarbonization Approach (SDA) method setting corporate CO2 emissions intensity reduction targets line climate science. method developed Science-Based Targets Initiative (SBTI), international initiative science-based target setting companies initiated CDP, United Nations Global Compact, World Resources Institute (WRI), Worldwide Fund Nature (WWF). context PACTA, methodology used calculate emission factor targets homogenous sectors (.e. sectors technology-level scenario pathways). First, distance, \\(d\\), company’s CO2 emissions intensity per unit production (emissions factor), \\(^{Co}(t)\\) base year, \\(t_0\\), scenario target intensity 2050, \\(^{Sc}(2050)\\) calculated. target intensity 2050 can taken relevant climate scenario: \\[d = ^{Co}(t_0) - ^{Sc}(2050)\\] company’s market share parameter, \\(m(t)\\), defined company’s expected future activity, \\(P^{Co}(t)\\) divided sector’s future activity, \\(P^{Sc}(t)\\) reflect expected forward-looking market share company. given ratio company’s base year market share, derived activity, \\(P^{Co}(t_0)\\) divided sector’s activity year, \\(P^{Sc}(t_0)\\). cases former calculated per company, latter determined climate scenario: \\[m (t) = \\dfrac{P^{Co}(t_0) / P^{Sc}(t_0)}{P^{Co}(t) / P^{Sc}(t)}\\] noted parameter capture change market share company rather inverse. useful equates decreasing parameter company’s market share increasing. equates larger reduction efforts companies market share increasing time. sector decarbonization factor, \\(p(t)\\) defined : \\[ p(t) = \\frac{^{Sc}(t) - ^{Sc}(2050)}{^{Sc}(t_0) - ^{Sc}(2050)}\\] \\(^{}(t)\\) \\(^{Sc}(t)\\) average market scenario emission intensities respectively, time \\(t\\). variable captures remaining effort needed market meet target 2050, per year. SDA assumptions CO2 intensity companies sector converge 2050. Note \\(p(t_0) = 1\\) \\(p(2050) = 0\\), indicating 100% expected decarbonization efforts still met base year 0% left 2050. company-level emission intensity target defined : \\[^{Target}(t) = \\left( d * p (t) * m (t) \\right) + ^{Sc}(2050)\\]","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-sda.html","id":"pacta-assumptions","dir":"Articles","previous_headings":"","what":"PACTA Assumptions","title":"Sectoral Decarbonization Approach (SDA)","text":"SDA applied PACTA differs slightly way applied SBTI. particular, must align top-approach laid climate scenarios bottom-asset-based company data used PACTA analysis. Assumption: Market share stays constant (\\(m(t)\\) = 1) Due lack quantitative data expected market share changes throughout entire time horizon 2050. \\(m(t)\\) set 1 years. SBTI method calculating \\(m(t)\\), higher intensity reduction target cases absolute pathway sector exceeds scenario target. makes sense. However, applying company level counter-intuitive: Companies decrease market share allowed higher CO2-Intensity average market actor. , companies increasing market share forced terms CO2-Intensity ones whose market share remains constant. follows company reaches targeted CO2-Intensity allowed increase share market. desirable outcome. assumption, target calculation reduces : \\[^{Target}(t) = \\left( d * p (t) \\right) + ^{Sc}(2050)\\] Approximation: Adjust base year scenario emission intensity SBTI PACTA methodology target emissions sector taken climate scenarios. implement global economy top-approach applies absolute emissions value year 2050 converts yearly emission intensities. However, may discrepancies Scenario projected emission intensities, bottom-ABCD emission intensities. reflect discrepancy, adjust scenario projections following factor, \\[\\dfrac{^{ABCD}(t_0)}{^{Sc}(t_0)}\\] yielding adjusted scenario pathway: \\['^{Sc}(t) = \\left(\\dfrac{^{ABCD}(t_0)}{^{Sc}(t_0)}\\right) * ^{Sc}(t)\\] yields final PACTA SDA target equation: \\[^{Target}(t) = \\left( d * p (t) \\right) + '^{Sc}(t)\\] Note: \\(d\\) \\(p(t)\\) also must re-calculated using adjusted scenario intensity, \\('^{Sc}\\).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/articles/target-sda.html","id":"calculating-sda-targets","dir":"Articles","previous_headings":"","what":"Calculating SDA Targets","title":"Sectoral Decarbonization Approach (SDA)","text":"calculate SDA targets need use package r2dii.analysis number datasets, including “matched” dataset (loanbook + asset-level data) can get package r2dii.match. datasets use come package r2dii.data; fake show structure data. Use packages. Match loanbook asset level data. Calculate SDA targets CO2 emissions intensities:","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis) loanbook <- r2dii.data::loanbook_demo abcd <- r2dii.data::abcd_demo  matched <- match_name(loanbook, abcd) %>%   # WARNING: Remember to validate the output of match_name() before prioritize()   prioritize()  matched #> # A tibble: 177 × 28 #>    id_loan id_direct_loantaker name_direct_loantaker      id_intermediate_pare…¹ #>    <chr>   <chr>               <chr>                      <chr>                  #>  1 L6      C304                Kassulke-Kassulke          NA                     #>  2 L13     C297                Ladeck                     NA                     #>  3 L20     C287                Weinhold                   NA                     #>  4 L21     C286                Gallo Group                NA                     #>  5 L22     C285                Austermuhle GmbH           NA                     #>  6 L24     C282                Ferraro-Ferraro Group      NA                     #>  7 L25     C281                Lockman, Lockman and Lock… NA                     #>  8 L26     C280                Ankunding, Ankunding and … NA                     #>  9 L27     C278                Donati-Donati Group        NA                     #> 10 L28     C276                Ferraro, Ferraro e Ferrar… NA                     #> # ℹ 167 more rows #> # ℹ abbreviated name: ¹​id_intermediate_parent_1 #> # ℹ 24 more variables: name_intermediate_parent_1 <chr>, #> #   id_ultimate_parent <chr>, name_ultimate_parent <chr>, #> #   loan_size_outstanding <dbl>, loan_size_outstanding_currency <chr>, #> #   loan_size_credit_limit <dbl>, loan_size_credit_limit_currency <chr>, #> #   sector_classification_system <chr>, … co2_intensity <- r2dii.data::co2_intensity_scenario_demo  matched %>% target_sda(abcd, co2_intensity) #> Warning: Removing rows in abcd where `emission_factor` is NA #> Warning: Found no matching regions for input scenario #> # A tibble: 0 × 4 #> # ℹ 4 variables: sector <chr>, year <int>, emission_factor_metric <chr>, #> #   emission_factor_value <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Alex Axthelm. Author, maintainer. Jackson Hoffart. Author, contractor. Mauro Lepore. Author, contractor. Klaus Hogedorn. Author. Nicky Halterman. Author. Rocky Mountain Institute. Copyright holder, funder.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Axthelm , Hoffart J, Lepore M, Hogedorn K, Halterman N (2024). r2dii.analysis: Measure Climate Scenario Alignment Corporate Loans. R package version 0.4.0,  https://rmi-pacta.github.io/r2dii.analysis/, https://github.com/RMI-PACTA/r2dii.analysis.","code":"@Manual{,   title = {r2dii.analysis: Measure Climate Scenario Alignment of Corporate Loans},   author = {Alex Axthelm and Jackson Hoffart and Mauro Lepore and Klaus Hogedorn and Nicky Halterman},   year = {2024},   note = {R package version 0.4.0,  https://rmi-pacta.github.io/r2dii.analysis/},   url = {https://github.com/RMI-PACTA/r2dii.analysis}, }"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"r2diianalysis-","dir":"","previous_headings":"","what":"Measure Climate Scenario Alignment of Corporate Loans","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"tools help assess financial portfolio aligns climate goals. summarize key metrics attributed portfolio (e.g. production, emission factors), calculate targets based climate scenarios. implement R last step free software ‘PACTA’ (Paris Agreement Capital Transition Assessment; https://www.transitionmonitor.com/). Financial institutions use ‘PACTA’ study capital allocation impacts climate.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"Install released version r2dii.analysis CRAN : install development version r2dii.analysis GitHub :","code":"install.packages(\"r2dii.analysis\") # install.packages(\"pak\") pak::pak(\"RMI-PACTA/r2dii.analysis\")"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"example","dir":"","previous_headings":"","what":"Example","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"Use library() attach packages need. r2dii.analysis depend packages r2dii.data r2dii.match; suggest install – install.packages(c(\"r2dii.data\", \"r2dii.match\")) – can reproduce examples. Use r2dii.match::match_name() identify matches loanbook asset level data.","code":"library(r2dii.data) library(r2dii.match) library(r2dii.analysis) matched <- match_name(loanbook_demo, abcd_demo) %>%   prioritize()"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"add-scenario-targets","dir":"","previous_headings":"Example","what":"Add Scenario Targets","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"Use target_sda() calculate SDA targets CO2 emissions. Use target_market_share calculate market-share scenario targets portfolio level: company level:","code":"matched %>%   target_sda(     abcd = abcd_demo,     co2_intensity_scenario = co2_intensity_scenario_demo,     region_isos = region_isos_demo   ) #> Warning: Removing rows in abcd where `emission_factor` is NA #> # A tibble: 220 × 6 #>    sector  year region             scenario_source emission_factor_metric #>    <chr>  <dbl> <chr>              <chr>           <chr>                  #>  1 cement  2020 advanced economies demo_2020       projected              #>  2 cement  2020 developing asia    demo_2020       projected              #>  3 cement  2020 global             demo_2020       projected              #>  4 cement  2021 advanced economies demo_2020       projected              #>  5 cement  2021 developing asia    demo_2020       projected              #>  6 cement  2021 global             demo_2020       projected              #>  7 cement  2022 advanced economies demo_2020       projected              #>  8 cement  2022 developing asia    demo_2020       projected              #>  9 cement  2022 global             demo_2020       projected              #> 10 cement  2023 advanced economies demo_2020       projected              #> # ℹ 210 more rows #> # ℹ 1 more variable: emission_factor_value <dbl> matched %>%   target_market_share(     abcd = abcd_demo,     scenario = scenario_demo_2020,     region_isos = region_isos_demo   ) #> # A tibble: 1,076 × 10 #>    sector     technology  year region scenario_source metric     production #>    <chr>      <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 automotive electric    2020 global demo_2020       projected     145649. #>  2 automotive electric    2020 global demo_2020       target_cps    145649. #>  3 automotive electric    2020 global demo_2020       target_sds    145649. #>  4 automotive electric    2020 global demo_2020       target_sps    145649. #>  5 automotive electric    2021 global demo_2020       projected     147480. #>  6 automotive electric    2021 global demo_2020       target_cps    146915. #>  7 automotive electric    2021 global demo_2020       target_sds    153332. #>  8 automotive electric    2021 global demo_2020       target_sps    147258. #>  9 automotive electric    2022 global demo_2020       projected     149310. #> 10 automotive electric    2022 global demo_2020       target_cps    148155. #> # ℹ 1,066 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl> matched %>%   target_market_share(     abcd = abcd_demo,     scenario = scenario_demo_2020,     region_isos = region_isos_demo,     by_company = TRUE   ) #> Warning: You've supplied `by_company = TRUE` and `weight_production = TRUE`. #> This will result in company-level results, weighted by the portfolio #> loan size, which is rarely useful. Did you mean to set one of these #> arguments to `FALSE`? #> # A tibble: 14,505 × 11 #>    sector    technology  year region scenario_source name_abcd metric production #>    <chr>     <chr>      <int> <chr>  <chr>           <chr>     <chr>       <dbl> #>  1 automoti… electric    2020 global demo_2020       Bernardi… proje…     17951. #>  2 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  3 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  4 automoti… electric    2020 global demo_2020       Bernardi… targe…     17951. #>  5 automoti… electric    2020 global demo_2020       Christia… proje…     11471. #>  6 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  7 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  8 automoti… electric    2020 global demo_2020       Christia… targe…     11471. #>  9 automoti… electric    2020 global demo_2020       Donati, … proje…      5611. #> 10 automoti… electric    2020 global demo_2020       Donati, … targe…      5611. #> # ℹ 14,495 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"utility-functions","dir":"","previous_headings":"Example","what":"Utility Functions","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"target_*() functions provide shortcuts common operations. wrap utility functions may also use directly: Use join_abcd_scenario() join matched dataset relevant scenario data, pick assets relevant regions. Use summarize_weighted_production() different grouping arguments calculate scenario-targets: Get started.","code":"loanbook_joined_to_abcd_scenario <- matched %>%   join_abcd_scenario(     abcd = abcd_demo,     scenario = scenario_demo_2020,     region_isos = region_isos_demo   ) # portfolio level loanbook_joined_to_abcd_scenario %>%   summarize_weighted_production(scenario, tmsr, smsp, region) #> # A tibble: 756 × 9 #>    sector_abcd technology  year scenario  tmsr    smsp region #>    <chr>       <chr>      <int> <chr>    <dbl>   <dbl> <chr>  #>  1 automotive  electric    2020 cps       1    0       global #>  2 automotive  electric    2020 sds       1    0       global #>  3 automotive  electric    2020 sps       1    0       global #>  4 automotive  electric    2021 cps       1.12 0.00108 global #>  5 automotive  electric    2021 sds       1.16 0.00653 global #>  6 automotive  electric    2021 sps       1.14 0.00137 global #>  7 automotive  electric    2022 cps       1.24 0.00213 global #>  8 automotive  electric    2022 sds       1.32 0.0131  global #>  9 automotive  electric    2022 sps       1.29 0.00273 global #> 10 automotive  electric    2023 cps       1.35 0.00316 global #> # ℹ 746 more rows #> # ℹ 2 more variables: weighted_production <dbl>, #> #   weighted_technology_share <dbl>  # company level loanbook_joined_to_abcd_scenario %>%   summarize_weighted_production(scenario, tmsr, smsp, region, name_abcd) #> # A tibble: 13,023 × 10 #>    sector_abcd technology  year scenario  tmsr  smsp region name_abcd            #>    <chr>       <chr>      <int> <chr>    <dbl> <dbl> <chr>  <chr>                #>  1 automotive  electric    2020 cps          1     0 global Bernardi, Bernardi … #>  2 automotive  electric    2020 cps          1     0 global Christiansen PLC     #>  3 automotive  electric    2020 cps          1     0 global Donati, Donati e Do… #>  4 automotive  electric    2020 cps          1     0 global DuBuque-DuBuque      #>  5 automotive  electric    2020 cps          1     0 global Ferrari-Ferrari SPA  #>  6 automotive  electric    2020 cps          1     0 global Ferry and Sons       #>  7 automotive  electric    2020 cps          1     0 global Goyette-Goyette      #>  8 automotive  electric    2020 cps          1     0 global Guerra, Guerra e Gu… #>  9 automotive  electric    2020 cps          1     0 global Gutkowski, Gutkowsk… #> 10 automotive  electric    2020 cps          1     0 global Hilpert, Hilpert an… #> # ℹ 13,013 more rows #> # ℹ 2 more variables: weighted_production <dbl>, #> #   weighted_technology_share <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/index.html","id":"funding","dir":"","previous_headings":"","what":"Funding","title":"Measure Climate Scenario Alignment of Corporate Loans","text":"project received funding European Union LIFE program International Climate Initiative (IKI). Federal Ministry Environment, Nature Conservation Nuclear Safety (BMU) supports initiative basis decision adopted German Bundestag. views expressed sole responsibility authors necessarily reflect views funders. funders responsible use may made information contains.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":null,"dir":"Reference","previous_headings":"","what":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"join_abcd_scenario() simple wrapper several calls dplyr::join_*(), forming master dataset used later steps analysis.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"","code":"join_abcd_scenario(   data,   abcd,   scenario,   region_isos = r2dii.data::region_isos,   add_green_technologies = FALSE )"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"data data frame like output r2dii.match::prioritize. abcd asset level data frame like r2dii.data::abcd_demo. scenario scenario data frame like r2dii.data::scenario_demo_2020. region_isos data frame like r2dii.data::region_isos (default). add_green_technologies Logical vector length 1. FALSE defaults outputting technologies present data abcd. Set FALSE add rows possible green technologies (0 production).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"Returns fully joined data frame, linking portfolio, abcd scenario.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/join_abcd_scenario.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Join a data-loanbook object to the abcd and scenario — join_abcd_scenario","text":"","code":"library(r2dii.data) library(r2dii.match)  valid_matches <- match_name(loanbook_demo, abcd_demo) %>% # WARNING: Remember to validate matches (see `?prioritize`)   prioritize()  valid_matches %>%   join_abcd_scenario(   abcd = abcd_demo,   scenario = scenario_demo_2020,   region_isos = region_isos_demo   ) #> # A tibble: 14,592 × 45 #>    id_loan id_direct_loantaker name_direct_loantaker id_intermediate_parent_1 #>    <chr>   <chr>               <chr>                 <chr>                    #>  1 L6      C304                Kassulke-Kassulke     NA                       #>  2 L6      C304                Kassulke-Kassulke     NA                       #>  3 L6      C304                Kassulke-Kassulke     NA                       #>  4 L6      C304                Kassulke-Kassulke     NA                       #>  5 L6      C304                Kassulke-Kassulke     NA                       #>  6 L6      C304                Kassulke-Kassulke     NA                       #>  7 L6      C304                Kassulke-Kassulke     NA                       #>  8 L6      C304                Kassulke-Kassulke     NA                       #>  9 L6      C304                Kassulke-Kassulke     NA                       #> 10 L6      C304                Kassulke-Kassulke     NA                       #> # ℹ 14,582 more rows #> # ℹ 41 more variables: name_intermediate_parent_1 <chr>, #> #   id_ultimate_parent <chr>, name_ultimate_parent <chr>, #> #   loan_size_outstanding <dbl>, loan_size_outstanding_currency <chr>, #> #   loan_size_credit_limit <dbl>, loan_size_credit_limit_currency <chr>, #> #   sector_classification_system <chr>, sector_classification_input_type <chr>, #> #   sector_classification_direct_loantaker <chr>, fi_type <chr>, …"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/pipe.html","id":null,"dir":"Reference","previous_headings":"","what":"Pipe operator — %>%","title":"Pipe operator — %>%","text":"See magrittr::%>% details.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/pipe.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Pipe operator — %>%","text":"","code":"lhs %>% rhs"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/pipe.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Pipe operator — %>%","text":"lhs value magrittr placeholder. rhs function call using magrittr semantics.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/pipe.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Pipe operator — %>%","text":"result calling rhs(lhs).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/r2dii.analysis-package.html","id":null,"dir":"Reference","previous_headings":"","what":"r2dii.analysis: Measure Climate Scenario Alignment of Corporate Loans — r2dii.analysis-package","title":"r2dii.analysis: Measure Climate Scenario Alignment of Corporate Loans — r2dii.analysis-package","text":"tools help assess corporate lending portfolio aligns climate goals. summarize key climate indicators attributed portfolio (e.g. production, emission factors), calculate alignment targets based climate scenarios. implement R last step free software 'PACTA' (Paris Agreement Capital Transition Assessment; https://www.transitionmonitor.com/). Financial institutions use 'PACTA' study capital allocation decisions align climate change mitigation goals.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/r2dii.analysis-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"r2dii.analysis: Measure Climate Scenario Alignment of Corporate Loans — r2dii.analysis-package","text":"Maintainer: Alex Axthelm aaxthelm@rmi.org (ORCID) Authors: Jackson Hoffart jackson.hoffart@gmail.com (ORCID) [contractor] Mauro Lepore maurolepore@gmail.com (ORCID) [contractor] Klaus Hogedorn klaus@2degrees-investing.org Nicky Halterman nicholas..halterman@gmail.com contributors: Rocky Mountain Institute PACTA4banks@rmi.org [copyright holder, funder]","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":null,"dir":"Reference","previous_headings":"","what":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"Based weight loan per sector per year, summarize_weighted_production() summarize_weighted_percent_change() summarize production percent-change, respectively.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"","code":"summarize_weighted_production(data, ..., use_credit_limit = FALSE)  summarize_weighted_percent_change(data, ..., use_credit_limit = FALSE)"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"data data frame like output join_abcd_scenario(). ... Variables group . use_credit_limit Logical vector length 1. FALSE defaults using column loan_size_outstanding. Set TRUE instead use column loan_size_credit_limit.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"tibble groups input () columns: sector, technology, year; weighted_production weighted_production summarize_weighted_production() summarize_weighted_percent_change(), respectively.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"warning","dir":"Reference","previous_headings":"","what":"Warning","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"percent-change analysis excludes companies 0 production. percent-change undefined companies initial production; including companies cause percent-change percentage infinite, wrong.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/summarize_weighted_production.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Summaries based on the weight of each loan per sector per year — summarize_weighted_production","text":"","code":"library(r2dii.data) library(r2dii.match)  loanbook <- head(loanbook_demo, 150) abcd <- head(abcd_demo, 100) master <- loanbook %>%   match_name(abcd) %>%   prioritize() %>%   join_abcd_scenario(     abcd = abcd,     scenario = scenario_demo_2020,     region_isos = region_isos_demo     ) %>%   dplyr::filter(production != 0)  summarize_weighted_production(master) #> # A tibble: 12 × 5 #>    sector_abcd technology     year weighted_production weighted_technology_share #>    <chr>       <chr>         <int>               <dbl>                     <dbl> #>  1 power       hydrocap       2020              50971.                     0.421 #>  2 power       hydrocap       2021              50230.                     0.421 #>  3 power       hydrocap       2022              49490.                     0.421 #>  4 power       hydrocap       2023              48749.                     0.421 #>  5 power       hydrocap       2024              48009.                     0.421 #>  6 power       hydrocap       2025              47268.                     0.421 #>  7 power       renewablescap  2020              61070.                     3.35  #>  8 power       renewablescap  2021              61103.                     3.35  #>  9 power       renewablescap  2022              61137.                     3.35  #> 10 power       renewablescap  2023              61170.                     3.35  #> 11 power       renewablescap  2024              61204.                     3.35  #> 12 power       renewablescap  2025              42533.                     2.85   summarize_weighted_production(master, use_credit_limit = TRUE) #> # A tibble: 12 × 5 #>    sector_abcd technology     year weighted_production weighted_technology_share #>    <chr>       <chr>         <int>               <dbl>                     <dbl> #>  1 power       hydrocap       2020              46073.                     0.381 #>  2 power       hydrocap       2021              45404.                     0.381 #>  3 power       hydrocap       2022              44734.                     0.381 #>  4 power       hydrocap       2023              44065.                     0.381 #>  5 power       hydrocap       2024              43396.                     0.381 #>  6 power       hydrocap       2025              42726.                     0.381 #>  7 power       renewablescap  2020              60695.                     3.37  #>  8 power       renewablescap  2021              60416.                     3.37  #>  9 power       renewablescap  2022              60138.                     3.37  #> 10 power       renewablescap  2023              59860.                     3.37  #> 11 power       renewablescap  2024              59582.                     3.37  #> 12 power       renewablescap  2025              44619.                     2.98   summarize_weighted_percent_change(master) #> # A tibble: 12 × 4 #>    sector_abcd technology     year weighted_percent_change #>    <chr>       <chr>         <int>                   <dbl> #>  1 power       hydrocap       2020                0        #>  2 power       hydrocap       2021               -0.0873   #>  3 power       hydrocap       2022               -0.175    #>  4 power       hydrocap       2023               -0.262    #>  5 power       hydrocap       2024               -0.349    #>  6 power       hydrocap       2025               -0.436    #>  7 power       renewablescap  2020                0        #>  8 power       renewablescap  2021                0.000439 #>  9 power       renewablescap  2022                0.000877 #> 10 power       renewablescap  2023                0.00132  #> 11 power       renewablescap  2024                0.00175  #> 12 power       renewablescap  2025               -0.0858    summarize_weighted_percent_change(master, use_credit_limit = TRUE) #> # A tibble: 12 × 4 #>    sector_abcd technology     year weighted_percent_change #>    <chr>       <chr>         <int>                   <dbl> #>  1 power       hydrocap       2020                 0       #>  2 power       hydrocap       2021                -0.0789  #>  3 power       hydrocap       2022                -0.158   #>  4 power       hydrocap       2023                -0.237   #>  5 power       hydrocap       2024                -0.316   #>  6 power       hydrocap       2025                -0.395   #>  7 power       renewablescap  2020                 0       #>  8 power       renewablescap  2021                -0.00364 #>  9 power       renewablescap  2022                -0.00729 #> 10 power       renewablescap  2023                -0.0109  #> 11 power       renewablescap  2024                -0.0146  #> 12 power       renewablescap  2025                -0.0898"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":null,"dir":"Reference","previous_headings":"","what":"Add targets for production, using the market share approach — target_market_share","title":"Add targets for production, using the market share approach — target_market_share","text":"function calculates portfolio-level production targets, calculated using market share approach applied relevant climate production forecast.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add targets for production, using the market share approach — target_market_share","text":"","code":"target_market_share(   data,   abcd,   scenario,   region_isos = r2dii.data::region_isos,   use_credit_limit = FALSE,   by_company = FALSE,   weight_production = TRUE,   increasing_or_decreasing = r2dii.data::increasing_or_decreasing )"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add targets for production, using the market share approach — target_market_share","text":"data \"data.frame\" like output r2dii.match::prioritize. abcd asset level data frame like r2dii.data::abcd_demo. scenario scenario data frame like r2dii.data::scenario_demo_2020. region_isos data frame like r2dii.data::region_isos (default). use_credit_limit Logical vector length 1. FALSE defaults using column loan_size_outstanding. Set TRUE use column loan_size_credit_limit instead. by_company Logical vector length 1. FALSE defaults outputting production_value portfolio-level. Set TRUE output production_value company-level. weight_production Logical vector length 1. TRUE defaults outputting production, weighted relative loan-size. Set FALSE output unweighted production values. increasing_or_decreasing data frame like r2dii.data::increasing_or_decreasing.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add targets for production, using the market share approach — target_market_share","text":"tibble including summarized columns metric, production, technology_share, percentage_of_initial_production_by_scope scope. by_company = TRUE, output also column name_abcd.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"handling-grouped-data","dir":"Reference","previous_headings":"","what":"Handling grouped data","title":"Add targets for production, using the market share approach — target_market_share","text":"function ignores existing groups outputs ungrouped data.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_market_share.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add targets for production, using the market share approach — target_market_share","text":"","code":"library(r2dii.data) library(r2dii.match)  loanbook <- head(loanbook_demo, 100) abcd <- head(abcd_demo, 100)  matched <- loanbook %>%   match_name(abcd) %>%   prioritize()  # Calculate targets at portfolio level matched %>%   target_market_share(     abcd = abcd,     scenario = scenario_demo_2020,     region_isos = region_isos_demo     ) #> # A tibble: 373 × 10 #>    sector technology  year region scenario_source metric     production #>    <chr>  <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 power  hydrocap    2020 global demo_2020       projected      16990. #>  2 power  hydrocap    2020 global demo_2020       target_cps     16990. #>  3 power  hydrocap    2020 global demo_2020       target_sds     16990. #>  4 power  hydrocap    2020 global demo_2020       target_sps     16990. #>  5 power  hydrocap    2021 global demo_2020       projected      16743. #>  6 power  hydrocap    2021 global demo_2020       target_cps     17004. #>  7 power  hydrocap    2021 global demo_2020       target_sds     17012. #>  8 power  hydrocap    2021 global demo_2020       target_sps     17005. #>  9 power  hydrocap    2022 global demo_2020       projected      16497. #> 10 power  hydrocap    2022 global demo_2020       target_cps     17018. #> # ℹ 363 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>  # Calculate targets at company level matched %>%   target_market_share(   abcd = abcd,   scenario = scenario_demo_2020,   region_isos = region_isos_demo,   by_company = TRUE   ) #> Warning: You've supplied `by_company = TRUE` and `weight_production = TRUE`. #> This will result in company-level results, weighted by the portfolio #> loan size, which is rarely useful. Did you mean to set one of these #> arguments to `FALSE`? #> # A tibble: 1,408 × 11 #>    sector technology  year region scenario_source name_abcd    metric production #>    <chr>  <chr>      <int> <chr>  <chr>           <chr>        <chr>       <dbl> #>  1 power  hydrocap    2020 global demo_2020       Giordano, G… proje…     16990. #>  2 power  hydrocap    2020 global demo_2020       Giordano, G… targe…     16990. #>  3 power  hydrocap    2020 global demo_2020       Giordano, G… targe…     16990. #>  4 power  hydrocap    2020 global demo_2020       Giordano, G… targe…     16990. #>  5 power  hydrocap    2021 global demo_2020       Giordano, G… proje…     16743. #>  6 power  hydrocap    2021 global demo_2020       Giordano, G… targe…     17004. #>  7 power  hydrocap    2021 global demo_2020       Giordano, G… targe…     17012. #>  8 power  hydrocap    2021 global demo_2020       Giordano, G… targe…     17005. #>  9 power  hydrocap    2022 global demo_2020       Giordano, G… proje…     16497. #> 10 power  hydrocap    2022 global demo_2020       Giordano, G… targe…     17018. #> # ℹ 1,398 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>  matched %>%   target_market_share(     abcd = abcd,     scenario = scenario_demo_2020,     region_isos = region_isos_demo,     # Calculate unweighted targets     weight_production = FALSE     ) #> # A tibble: 373 × 10 #>    sector technology  year region scenario_source metric     production #>    <chr>  <chr>      <int> <chr>  <chr>           <chr>           <dbl> #>  1 power  hydrocap    2020 global demo_2020       projected     121032. #>  2 power  hydrocap    2020 global demo_2020       target_cps    121032. #>  3 power  hydrocap    2020 global demo_2020       target_sds    121032. #>  4 power  hydrocap    2020 global demo_2020       target_sps    121032. #>  5 power  hydrocap    2021 global demo_2020       projected     119274. #>  6 power  hydrocap    2021 global demo_2020       target_cps    121129. #>  7 power  hydrocap    2021 global demo_2020       target_sds    121187. #>  8 power  hydrocap    2021 global demo_2020       target_sps    121139. #>  9 power  hydrocap    2022 global demo_2020       projected     117515. #> 10 power  hydrocap    2022 global demo_2020       target_cps    121227. #> # ℹ 363 more rows #> # ℹ 3 more variables: technology_share <dbl>, scope <chr>, #> #   percentage_of_initial_production_by_scope <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":null,"dir":"Reference","previous_headings":"","what":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"function calculates targets CO2 emissions per unit production portfolio-level, otherwise referred \"emissions factors\". uses sectoral-decarbonization approach (SDA) calculate targets.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"","code":"target_sda(   data,   abcd,   co2_intensity_scenario,   use_credit_limit = FALSE,   by_company = FALSE,   region_isos = r2dii.data::region_isos )"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"data dataframe like output r2dii.match::prioritize(). abcd asset-level data frame like r2dii.data::abcd_demo. co2_intensity_scenario scenario data frame like r2dii.data::co2_intensity_scenario_demo. use_credit_limit Logical vector length 1. FALSE defaults using column loan_size_outstanding. Set TRUE instead use column loan_size_credit_limit. by_company Logical vector length 1. FALSE defaults outputting weighted_production_value portfolio-level. Set TRUE output weighted_production_value company-level. region_isos data frame like r2dii.data::region_isos (default).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"tibble including summarized columns emission_factor_metric emission_factor_value. by_company = TRUE, output also column name_abcd.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"handling-grouped-data","dir":"Reference","previous_headings":"","what":"Handling grouped data","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"function ignores existing groups outputs ungrouped data.","code":""},{"path":[]},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/target_sda.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add targets for CO2 emissions per unit production at the portfolio level,\nusing the SDA approach — target_sda","text":"","code":"library(r2dii.match) library(r2dii.data)  loanbook <- head(loanbook_demo, 150) abcd <- head(abcd_demo, 100)  matched <- loanbook %>%   match_name(abcd) %>%   prioritize()  # Calculate targets at portfolio level matched %>%   target_sda(    abcd = abcd,    co2_intensity_scenario = co2_intensity_scenario_demo,    region_isos = region_isos_demo    ) #> Warning: Removing rows in abcd where `emission_factor` is NA #> Warning: Found no match between loanbook and abcd. #> # A tibble: 0 × 4 #> # ℹ 4 variables: sector <chr>, year <int>, emission_factor_metric <chr>, #> #   emission_factor_value <dbl>  # Calculate targets at company level matched %>%   target_sda(    abcd = abcd,    co2_intensity_scenario = co2_intensity_scenario_demo,    region_isos = region_isos_demo,    by_company = TRUE    ) #> Warning: Removing rows in abcd where `emission_factor` is NA #> Warning: Found no match between loanbook and abcd. #> # A tibble: 0 × 4 #> # ℹ 4 variables: sector <chr>, year <int>, emission_factor_metric <chr>, #> #   emission_factor_value <dbl>"},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/tidyeval.html","id":null,"dir":"Reference","previous_headings":"","what":"Tidy eval helpers — tidyeval","title":"Tidy eval helpers — tidyeval","text":"learn tidy eval use tools, check Metaprogramming section Advanced R.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/reference/tidyeval.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Tidy eval helpers — tidyeval","text":"sym() creates symbol string syms() creates list symbols character vector. enquo() enquos() delay execution one several function arguments. enquo() returns single quoted expression, like blueprint delayed computation. enquos() returns list quoted expressions. expr() quotes new expression locally. mostly useful build new expressions around arguments captured enquo() enquos(): expr(mean(!!enquo(arg), na.rm = TRUE)). as_name() transforms quoted variable name string. Supplying something else quoted variable name error. unlike as_label() also returns single string supports kind R object input, including quoted function calls vectors. purpose summarise object single label. label often suitable default name. know quoted expression contains (instance expressions captured enquo() variable name, call function, unquoted constant), use as_label(). know quoted simple variable name, like enforce , use as_name().","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-040","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.4.0","title":"r2dii.analysis 0.4.0","text":"target_market_share now outputs target_* value years scenario (#481). Complete deprecation ald favour abcd (#466). target_market_share now correctly handles input scenarios hyphen name (#425). target_market_share now handles abcd rows production NA filling 0 (#423).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-030","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.3.0","title":"r2dii.analysis 0.3.0","text":"CRAN release: 2023-10-23 target_sda now uses final year scenario convergence target by_company = TRUE (#445). target_market_share gains argument increasing_or_decreasing (#426).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-021","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.2.1","title":"r2dii.analysis 0.2.1","text":"CRAN release: 2022-11-03 r2dii.analysis transferred new organization: https://github.com/RMI-PACTA/.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-020","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.2.0","title":"r2dii.analysis 0.2.0","text":"CRAN release: 2022-05-05 New argument abcd target_market_share() target_sda supersedes argument ald (#404). target_sda() now outputs data sector values three input datasets (data, ald co2_intensity_scenario) (#390). target_sda() now outputs unweighted emission_factor by_company TRUE (#376). target_sda() gains region_isos argument (#323). target_market_share() now outputs values years ald scenario inputs (#394). target_market_share() now outputs two new columns, percentage_of_initial_production_by_scope scope (ADO #4143).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-0112","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.12","title":"r2dii.analysis 0.1.12","text":"CRAN release: 2021-08-18 target_market_share() now outputs 0 technology_share, companies 0 sectoral production (#306 @Antoine-Lalechere). target_sda() now filters scenario start year consistent ald start year (#346 @waltjl).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-0110","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.10","title":"r2dii.analysis 0.1.10","text":"CRAN release: 2021-07-09 target_market_share() now sets negative smsp targets zero (#336). target_market_share() now outputs sectors present input datasets (#329). target_market_share() now always adds targets green technologies (defined r2dii.data::green_or_brown), even present input data (#318 @Antoine-Lalechere). target_market_share() now correctly groups region calculating technology_share (#315 @Antoine-Lalechere).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-019","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.9","title":"r2dii.analysis 0.1.9","text":"CRAN release: 2021-06-30 target_sda() now outputs sector values present input co2_intensity_scenario data (#308). target_sda() now outputs targets range years input co2_intenstiy_scenario (#307).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-018","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.8","title":"r2dii.analysis 0.1.8","text":"CRAN release: 2021-05-22 target_market_share() now correctly outputs target technology share, line methodology (@georgeharris2deg #277). target_market_share() now correctly projects technology share ‘production / total production’ computing company, unweighted relative loan size (@KapitanKombajn #288). target_market_share() longer outputs columns sector_weighted_production technology_weighted_production. columns internal shouldn’t face users (#291).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-016","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.6","title":"r2dii.analysis 0.1.6","text":"CRAN release: 2021-03-10 target_market_share() now correctly outputs technology_share multiple loans different level company (@ab-bbva #265).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-015","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.5","title":"r2dii.analysis 0.1.5","text":"CRAN release: 2021-01-22 target_market_share() now errors input data unexpected column (@georgeharris2deg #267). target_market_share() now correctly outputs technology_share multiple loans company (@georgeharris2deg #262, @ab-bbva #265).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-014","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.4","title":"r2dii.analysis 0.1.4","text":"CRAN release: 2021-01-05 target_market_share() now correctly outputs unweighted production company, equal ald-production one company multiple loans different size (#255 @georgeharris2deg).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-013","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.3","title":"r2dii.analysis 0.1.3","text":"CRAN release: 2020-12-15 target_market_share() now correctly outputs unweighted production multiple levels exist company (#249).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-012","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.2","title":"r2dii.analysis 0.1.2","text":"CRAN release: 2020-12-05 target_market_share() now outputs weighted_technology_share correctly sums 1 grouped sector, metric scenario (#218). target_market_share() now correctly outputs unweighted production multiple loans exist company (#239). target_market_share() now outputs empty named tibble matching region definitions can found (#236). target_market_share now outputs technologies present ald, even present data (#235). target_sda() now interpolates input scenario file year correctly calculates target, regardless time-horizon ald (#234). Hyperlinks “Get Started” tab website now points correct links (#222 @apmanning). Depend dplyr >= 0.8.5, explicitly. commit version newer dplyr 1 still relatively new, represents major change users initially resist. Relax dependency rlang, mostly driven dynamically recursive dependencies. example, dplyr 0.8.5 depends specific version rlang recent version explicitly depended – suggests explicit rlang unhelpful misleading. New internal data loanbook_stable region_isos_stable make regression tests stable (#227).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-011","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.1","title":"r2dii.analysis 0.1.1","text":"CRAN release: 2020-09-12 Change license MIT. website’s home page now thanks founders. target_market_share() now works expected value column scenario missing value column region. longer results output columns production technology_share type “list” (#203). website now shows News tab.","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-010","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.1.0","title":"r2dii.analysis 0.1.0","text":"CRAN release: 2020-09-03 target_sda() now correctly handles differing country_of_domicile inputs (#171). target_market_share() now outputs technology_share (#184). join_ald_scenario() now returns visibly dev-magrittr (#188 @lionel-). target_market_share() gains weight_production parameter (#181). target_market_share() now correctly use sector_ald column input data argument (#178). target_sda() now automatically filters ald rows emissions_factor values NA (#173). join_ald_scenario() now converts lower case values columns sector_ald technology (#172). target_sda() now aggregates input ald technology plant_location prior calculating targets (@QianFeng2020 #160). target_sda() now errors input data duplicated id_loan (@QianFeng2020 #164). target_sda() gains by_company parameter (#155). target_market_share() now outputs actual aggregated corporate economy. Previously, output , erroneously, normalized starting portfolio value (#158). target_sda() now correctly calculates SDA targets (#153): Targets now calculated using scenario data adjusted corporate economy data. adjusted scenario data also output function along usual metrics. Methodology error fixed, reflected code. Previously, target , incorrectly, calculated multiplying adjusted scenario. Now scenario data added instead. New summarize_weighted_percent_change() allows user calculate new indicator (#141). target_market_share() longer errors combination sector scenario_target_value uniquely identify observation (@georgeharris2deg #142).","code":""},{"path":"https://rmi-pacta.github.io/r2dii.analysis/news/index.html","id":"r2diianalysis-001","dir":"Changelog","previous_headings":"","what":"r2dii.analysis 0.0.1","title":"r2dii.analysis 0.0.1","text":"CRAN release: 2020-06-28 First release CRAN","code":""}]