diff --git a/README.md b/README.md
index 94ef3179..c7319183 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # FASTSim
 
-![FASTSim Logo](https://www.nrel.gov/transportation/assets/images/icon-fastsim.jpg)
+<img src="docs/assets/fastsim-icon.svg" height="200">
 
 [![homepage](https://img.shields.io/badge/homepage-fastsim-blue)](https://www.nrel.gov/transportation/fastsim.html) [![tests](https://github.com/NREL/fastsim/actions/workflows/tests.yaml/badge.svg)](https://github.com/NREL/fastsim/actions/workflows/tests.yaml) [![wheels](https://github.com/NREL/fastsim/actions/workflows/wheels.yaml/badge.svg)](https://github.com/NREL/fastsim/actions/workflows/wheels.yaml?event=release) [![python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10-blue)](https://pypi.org/project/fastsim/) [![documentation](https://img.shields.io/badge/documentation-book-blue.svg)](https://nrel.github.io/fastsim/) [![github](https://img.shields.io/badge/github-fastsim-blue.svg)](https://github.com/NREL/fastsim)
 
diff --git a/docs/assets/fastsim-icon.svg b/docs/assets/fastsim-icon.svg
new file mode 100755
index 00000000..7593aa29
--- /dev/null
+++ b/docs/assets/fastsim-icon.svg
@@ -0,0 +1 @@
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 130.61 171.76"><defs><style>.cls-1{fill:url(#linear-gradient);}.cls-2{fill:url(#linear-gradient-2);}.cls-3{fill:url(#linear-gradient-3);}.cls-12,.cls-4{fill:#f47422;}.cls-5{fill:url(#linear-gradient-4);}.cls-6{fill:url(#linear-gradient-5);}.cls-10,.cls-7,.cls-8,.cls-9{fill:#fff;}.cls-8{opacity:0.7;}.cls-9{opacity:0.5;}.cls-10{opacity:0;}.cls-11{fill:#6d6f70;}.cls-12{fill-rule:evenodd;}.cls-13{fill:url(#linear-gradient-6);}</style><linearGradient id="linear-gradient" x1="-269.64" y1="-48.33" x2="-186.68" y2="-131.29" gradientTransform="translate(-172.35 0.72) rotate(180)" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#fff"/><stop offset="0.32" stop-color="#fcfcfc"/><stop offset="0.58" stop-color="#f2f2f2"/><stop offset="0.82" stop-color="#e0e2e2"/><stop offset="1" stop-color="#ced0d0"/></linearGradient><linearGradient id="linear-gradient-2" x1="-276.93" y1="-124.89" x2="-294.6" y2="-67.89" gradientTransform="translate(-172.35 0.72) rotate(180)" gradientUnits="userSpaceOnUse"><stop offset="0.09" stop-color="#efaa21"/><stop offset="0.15" stop-color="#f0a321"/><stop offset="0.38" stop-color="#f28922"/><stop offset="0.58" stop-color="#f37922"/><stop offset="0.75" stop-color="#f47422"/></linearGradient><linearGradient id="linear-gradient-3" x1="-253.48" y1="-16.46" x2="-319.09" y2="-82.08" gradientTransform="translate(-172.35 0.72) rotate(180)" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#efaa21"/><stop offset="0.42" stop-color="#efa821"/><stop offset="0.63" stop-color="#f0a021"/><stop offset="0.79" stop-color="#f19321"/><stop offset="0.93" stop-color="#f38022"/><stop offset="1" stop-color="#f47422"/></linearGradient><linearGradient id="linear-gradient-4" x1="-232.21" y1="4.55" x2="-169.9" y2="-57.76" gradientTransform="translate(-172.35 0.72) rotate(180)" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#fff" stop-opacity="0"/><stop offset="0.04" stop-color="#fdf5e5" stop-opacity="0.12"/><stop offset="0.17" stop-color="#f8dba0" stop-opacity="0.43"/><stop offset="0.28" stop-color="#f4c66a" stop-opacity="0.67"/><stop offset="0.37" stop-color="#f1b742" stop-opacity="0.85"/><stop offset="0.45" stop-color="#f0ad2a" stop-opacity="0.96"/><stop offset="0.49" stop-color="#efaa21"/><stop offset="1" stop-color="#fff" stop-opacity="0"/></linearGradient><linearGradient id="linear-gradient-5" x1="838.01" y1="3310.61" x2="910.46" y2="3229.61" gradientTransform="translate(-851.39 -3240.76)" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#fff" stop-opacity="0"/><stop offset="0.03" stop-color="#fefbf4" stop-opacity="0.05"/><stop offset="0.09" stop-color="#fcf0d8" stop-opacity="0.18"/><stop offset="0.16" stop-color="#f9dea9" stop-opacity="0.39"/><stop offset="0.25" stop-color="#f4c669" stop-opacity="0.67"/><stop offset="0.34" stop-color="#efaa21"/><stop offset="0.5" stop-color="#f28d22"/><stop offset="0.61" stop-color="#f47422"/><stop offset="0.65" stop-color="#f47a2b" stop-opacity="0.96"/><stop offset="0.71" stop-color="#f68943" stop-opacity="0.85"/><stop offset="0.78" stop-color="#f8a26b" stop-opacity="0.67"/><stop offset="0.87" stop-color="#fac5a2" stop-opacity="0.42"/><stop offset="0.97" stop-color="#fef0e7" stop-opacity="0.11"/><stop offset="1" stop-color="#fff" stop-opacity="0"/></linearGradient><linearGradient id="linear-gradient-6" x1="29.21" y1="82.2" x2="70.09" y2="82.2" gradientTransform="matrix(1, 0, 0, 1, 0, 0)" xlink:href="#linear-gradient-2"/></defs><title>fastsim-icon-v2-final</title><path class="cls-1" d="M12.75,130.44V70.15L50.57,32.34c3-2.48,8.58-4.15,15-4.15s12.18,1.73,15.14,4.28l-.11-.12,1,1L113,64.73l.92.92c2.56,3,4.29,8.63,4.29,15.14s-1.67,12-4.17,15l-1.16,1.16L79.39,130.4Z"/><path class="cls-2" d="M79.38,130.4l.11-.11,33.34-33.35L114,95.78c2.5-3,4.17-8.59,4.17-15s-1.73-12.18-4.29-15.14l16.74,16.74v33.55a14.45,14.45,0,0,1-14.46,14.46Z"/><path class="cls-3" d="M50.57,32.34,61.87,21,62,20.9l3.57-3.55,0,0L70.4,12.5h45.75A14.46,14.46,0,0,1,130.61,27V82.39L113,64.73,81.6,33.37l-1-1,.11.12c-3-2.55-8.63-4.28-15.14-4.28S53.57,29.86,50.57,32.34Z"/><path class="cls-4" d="M12.71,70.19V27A14.46,14.46,0,0,1,27.18,12.5H70.4l-4.84,4.83h0L62,20.9l-.14.14-11.3,11.3L12.75,70.15Z"/><path class="cls-5" d="M9.24,74V26.89A17.72,17.72,0,0,1,26.93,9.19H74.05l-3.47,3.47-.18-.16H27.18A14.46,14.46,0,0,0,12.71,27V70.19l.17.16Z"/><path class="cls-6" d="M0,83.15v-56A27.2,27.2,0,0,1,27.16,0h56L73.93,9.22h-47A17.73,17.73,0,0,0,9.23,26.93v47Z"/><path class="cls-7" d="M27,3.67h1.13v2H27a22.49,22.49,0,0,0-2.85.19.34.34,0,0,1-.4-.29l-.2-1.27a.37.37,0,0,1,.31-.42A23.55,23.55,0,0,1,27,3.67Z"/><rect class="cls-7" x="29.89" y="3.67" width="4.5" height="2" rx="0.36" ry="0.36"/><rect class="cls-7" x="36.2" y="3.67" width="4.5" height="2" rx="0.36" ry="0.36"/><rect class="cls-7" x="42.49" y="3.67" width="4.5" height="2" rx="0.36" ry="0.36"/><rect class="cls-7" x="48.79" y="3.67" width="4.5" height="2" rx="0.36" ry="0.36"/><rect class="cls-7" x="55.09" y="3.67" width="4.5" height="2" rx="0.36" ry="0.36"/><rect class="cls-8" x="61.39" y="3.67" width="4.5" height="2" rx="0.36" ry="0.36"/><path class="cls-7" d="M21.7,4.65,22,5.9a.34.34,0,0,1-.26.42A22.67,22.67,0,0,0,18.34,7.5a.34.34,0,0,1-.46-.17l-.55-1.16a.38.38,0,0,1,.18-.49,24,24,0,0,1,3.74-1.3A.38.38,0,0,1,21.7,4.65Z"/><path class="cls-7" d="M15.69,7l.63,1.11a.35.35,0,0,1-.13.48,20.7,20.7,0,0,0-2.92,2.09.36.36,0,0,1-.5,0l-.84-1a.37.37,0,0,1,0-.52,22.81,22.81,0,0,1,3.23-2.3A.37.37,0,0,1,15.69,7Z"/><path class="cls-7" d="M10.58,11l.92.89a.36.36,0,0,1,0,.5,21.49,21.49,0,0,0-2.23,2.81.36.36,0,0,1-.49.11l-1.08-.69a.37.37,0,0,1-.11-.51A23.75,23.75,0,0,1,10.06,11,.37.37,0,0,1,10.58,11Z"/><path class="cls-7" d="M6.78,16.18l1.13.6a.36.36,0,0,1,.14.48,22.26,22.26,0,0,0-1.36,3.32.36.36,0,0,1-.44.24L5,20.46A.37.37,0,0,1,4.78,20a23.36,23.36,0,0,1,1.5-3.67A.37.37,0,0,1,6.78,16.18Z"/><path class="cls-7" d="M4.58,22.25l1.25.26a.35.35,0,0,1,.27.42,22.39,22.39,0,0,0-.37,3.57.35.35,0,0,1-.35.35H4.1a.38.38,0,0,1-.37-.38,24.59,24.59,0,0,1,.41-3.93A.38.38,0,0,1,4.58,22.25Z"/><rect class="cls-7" x="3.73" y="28.65" width="2" height="4.5" rx="0.36" ry="0.36"/><rect class="cls-7" x="3.73" y="34.95" width="2" height="4.5" rx="0.36" ry="0.36"/><rect class="cls-7" x="3.73" y="41.25" width="2" height="4.5" rx="0.36" ry="0.36"/><rect class="cls-7" x="3.73" y="47.55" width="2" height="4.5" rx="0.36" ry="0.36"/><rect class="cls-7" x="3.73" y="53.85" width="2" height="4.5" rx="0.36" ry="0.36"/><rect class="cls-8" x="3.73" y="60.15" width="2" height="4.5" rx="0.36" ry="0.36"/><rect class="cls-9" x="3.73" y="66.45" width="2" height="4.5" rx="0.36" ry="0.36"/><rect class="cls-10" x="3.73" y="72.75" width="2" height="4.5" rx="0.36" ry="0.36"/><path class="cls-11" d="M13,149.14H26.55v4.14H18v5.09h8v4.1H18v9H13Z"/><path class="cls-11" d="M32.18,165.71l-1.59,5.72H25.4l6.78-22.29H38.8l6.94,22.29H40.28l-1.72-5.72Zm5.66-3.77-1.39-4.73c-.4-1.32-.8-3-1.13-4.3h-.06c-.33,1.33-.67,3-1,4.3l-1.32,4.73Z"/><path class="cls-11" d="M47.6,166.24a12.65,12.65,0,0,0,5.59,1.39c2.31,0,3.54-1,3.54-2.41S55.67,163,53,162.11c-3.71-1.33-6.15-3.38-6.15-6.62,0-3.8,3.2-6.68,8.43-6.68A13,13,0,0,1,61,149.94l-1.12,4a10.47,10.47,0,0,0-4.64-1.06c-2.18,0-3.24,1-3.24,2.15,0,1.42,1.23,2.05,4.14,3.14,3.93,1.46,5.75,3.51,5.75,6.65,0,3.74-2.84,6.91-9,6.91a14.63,14.63,0,0,1-6.32-1.38Z"/><path class="cls-11" d="M68.57,153.37h-6v-4.23H79.68v4.23H73.6v18.06h-5Z"/><path class="cls-11" d="M81.27,166.24a12.69,12.69,0,0,0,5.59,1.39c2.32,0,3.54-1,3.54-2.41s-1.06-2.19-3.73-3.11c-3.71-1.33-6.16-3.38-6.16-6.62,0-3.8,3.21-6.68,8.44-6.68a13.06,13.06,0,0,1,5.69,1.13l-1.13,4a10.42,10.42,0,0,0-4.63-1.06c-2.18,0-3.24,1-3.24,2.15,0,1.42,1.22,2.05,4.13,3.14,3.94,1.46,5.76,3.51,5.76,6.65,0,3.74-2.84,6.91-9,6.91a14.63,14.63,0,0,1-6.32-1.38Z"/><path class="cls-11" d="M102.78,150.76a2.52,2.52,0,0,1-2.72,2.52,2.52,2.52,0,1,1,2.72-2.52Zm-5.2,20.67V155.26h5v16.17Z"/><path class="cls-11" d="M105.82,160.42c0-2-.07-3.7-.13-5.16H110l.2,2.18h.1a5.6,5.6,0,0,1,4.9-2.58,4.58,4.58,0,0,1,4.43,2.78h.07a6.91,6.91,0,0,1,2.11-2,6.16,6.16,0,0,1,3.08-.8c3.11,0,5.45,2.19,5.45,7v9.52H125.4v-8.79c0-2.35-.76-3.71-2.38-3.71a2.51,2.51,0,0,0-2.35,1.75,5.29,5.29,0,0,0-.17,1.29v9.46h-4.89v-9.09c0-2-.73-3.41-2.35-3.41a2.57,2.57,0,0,0-2.35,1.79,3.48,3.48,0,0,0-.19,1.29v9.42h-4.9Z"/><path class="cls-12" d="M95.44,84.24v2.59a.85.85,0,0,1-.85.85h-2.9a4.94,4.94,0,0,0,.13-1.17,5.55,5.55,0,1,0-11,1.17H72a3.87,3.87,0,0,0,.12-.84v-.23c0-.22,0-.43,0-.59s0-.32,0-.51A6,6,0,0,0,72,84.2c0-.14,0-.31,0-.48s0-.22,0-.39a4.37,4.37,0,0,0-1.32-2.62V68.22A1.18,1.18,0,0,1,71.75,67h9.42a1.32,1.32,0,0,1,1.51,1l2,6.12c2.31.52,9.44,2.41,9.44,5v4.19h.46A.86.86,0,0,1,95.44,84.24Z"/><path class="cls-12" d="M68.33,60.22V79.56C67.77,79.4,67,79.21,66,79s-2.06-.4-3.15-.57C61.5,78.2,60.21,78,59,77.89c-1.76-1-5.57-3.13-8.23-3.42-.68-.08-1.48-.13-2.38-.16h-.84l-.91,0A29.54,29.54,0,0,0,37.22,76c-2,.78-3.6,1.35-4.72,1.72V61.62a2.25,2.25,0,0,1,2.26-2.25H67.47A.86.86,0,0,1,68.33,60.22Z"/><path class="cls-12" d="M90.33,86.51a3.49,3.49,0,0,1-.1.86,1.77,1.77,0,0,1-.08.31,4.06,4.06,0,0,1-7.77,0c0-.1-.06-.21-.08-.31a4.06,4.06,0,1,1,8-.86Z"/><path class="cls-13" d="M70.09,85.55c0,.12,0,.25,0,.38s0,.36,0,.56v.27a1.44,1.44,0,0,1-.87,1.31l-2.92,0A3.7,3.7,0,0,0,58.92,88l-18.47-.17a3.71,3.71,0,0,0-7.27-.07l-3.16,0a2.25,2.25,0,0,1-.78-2.3c0-.09,0-.21,0-.26V85.1a1.59,1.59,0,0,1,.3-1.09l.11-.16,0-.18a4.66,4.66,0,0,1,.44-1.46l.07-.15v-.18a1.65,1.65,0,0,1,.2-.79,2.23,2.23,0,0,1,.59-.68,1,1,0,0,1,.39-.19c.43-.13,2.78-.84,6.56-2.31a27.5,27.5,0,0,1,8.77-1.57h1.66c.78,0,1.54.06,2.2.14,2.44.27,6.48,2.58,7.66,3.29l.13.08h.15c1.33.16,2.72.35,4,.56,1.09.17,2.13.36,3,.55a13.65,13.65,0,0,1,3.23,1,2.3,2.3,0,0,1,1,1.7,1.94,1.94,0,0,1,0,.24,5,5,0,0,1,0,.51v.12l0,.11A3.23,3.23,0,0,1,70.09,85.55Z"/><path class="cls-4" d="M39.07,88.61a2.26,2.26,0,0,1-.63,1.46,2.24,2.24,0,0,1-1.63.7,2.26,2.26,0,0,1-1.7-.77,2.23,2.23,0,0,1-.58-1.5,2.28,2.28,0,1,1,4.55,0Z"/><path class="cls-4" d="M64.85,88.61a2.21,2.21,0,0,1-.63,1.46,2.24,2.24,0,0,1-1.63.7,2.26,2.26,0,0,1-1.7-.77,2.23,2.23,0,0,1-.58-1.5,2.28,2.28,0,1,1,4.55,0Z"/><path class="cls-11" d="M89.22,100.74a.36.36,0,0,1-.36.36H82.78a.36.36,0,0,1-.36-.36v-4a.36.36,0,0,1,.36-.36h6.08a.36.36,0,0,1,.36.36Zm-8.69,0a.36.36,0,0,1-.36.36H74.1a.36.36,0,0,1-.36-.36v-4a.36.36,0,0,1,.36-.36h6.07a.36.36,0,0,1,.36.36Zm-8.68,0a.36.36,0,0,1-.36.36H65.41a.36.36,0,0,1-.36-.36v-4a.36.36,0,0,1,.36-.36h6.08a.36.36,0,0,1,.36.36Zm-8.69,0a.36.36,0,0,1-.36.36H56.73a.36.36,0,0,1-.36-.36v-4a.36.36,0,0,1,.36-.36H62.8a.36.36,0,0,1,.36.36Zm-8.68,0a.36.36,0,0,1-.36.36H48a.36.36,0,0,1-.36-.36v-4a.36.36,0,0,1,.36-.36h6.08a.36.36,0,0,1,.36.36Zm-8.69,0a.36.36,0,0,1-.36.36H39.36a.36.36,0,0,1-.36-.36v-4a.36.36,0,0,1,.36-.36h6.07a.36.36,0,0,1,.36.36Zm-8.68,0a.36.36,0,0,1-.36.36H30.68a.36.36,0,0,1-.36-.36v-4a.36.36,0,0,1,.36-.36h6.07a.36.36,0,0,1,.36.36Z"/><path class="cls-11" d="M91.58,103.8l8.64-5a.36.36,0,0,0,0-.62l-8.64-5a.36.36,0,0,0-.54.31v10A.37.37,0,0,0,91.58,103.8Z"/></svg>
\ No newline at end of file