docs/tutorials/9 - Advanced topics - 1 axis torque tube Shading for 1 day (Research documentation).ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# 9 - Advanced topics - 1 axis torque tube Shading for 1 day (Research Documentation)\n",
    "## Recreating JPV 2019 / PVSC 2018 Fig. 13\n",
    "\n",
    "\n",
    "Calculating and plotting shading from torque tube on 1-axis tracking for 1 day, which is figure 13 in: \n",
    "\n",
    "            Ayala Pelaez S, Deline C, Greenberg P, Stein JS, Kostuk RK. Model and validation of single-axis tracking with bifacial PV. IEEE J Photovoltaics. 2019;9(3):715–21. https://ieeexplore.ieee.org/document/8644027 and https://www.nrel.gov/docs/fy19osti/72039.pdf (pre-print, conference version)\n",
    "\n",
    "\n",
    "This is what we will re-create:\n",
    "![Ayala JPV-2](../images_wiki/JPV_Ayala_Fig13.PNG)\n",
    "\n",
    "Use bifacial_radiance minimum v. 0.3.1 or higher. Many things have been updated since this paper, simplifying the generation of this plot:\n",
    "\n",
    "<ul>\n",
    "    <li> Sensor position is now always generated E to W on N-S tracking systems, so same sensor positions can just be added for this calculation at the end without needing to flip the sensors. </li>\n",
    "    <li> Torquetubes get automatically generated in makeModule. Following PVSC 2018 paper, rotation is around the modules and not around the torque tube axis (which is a new feature) </li>\n",
    "    <li> Simulating only 1 day on single-axis tracking easier with cumulativesky = False and gendaylit1axis(startdate='06/24', enddate='06/24' </li> \n",
    "    <li> Sensors get generated very close to surface, so all results are from the module surface and not the torquetube for this 1-UP case. </li>\n",
    "</ul>\n",
    "\n",
    "## Steps:\n",
    "\n",
    "<ol>\n",
    "    <li> <a href='#step1'> Running the simulations for all the cases: </li>\n",
    "    <ol type='A'> \n",
    "        <li> <a href='#step1a'>Baseline Case: No Torque Tube </a></li>\n",
    "        <li> <a href='#step1b'> Zgap = 0.1 </a></li>\n",
    "        <li> <a href='#step1c'> Zgap = 0.2 </a></li>\n",
    "        <li> <a href='#step1d'> Zgap = 0.3 </a></li>\n",
    "    </ol>\n",
    "    <li> <a href='#step2'> Read-back the values and tabulate average values for unshaded, 10cm gap and 30cm gap </a></li>\n",
    "    <li> <a href='#step3'> Plot spatial loss values for 10cm and 30cm data </a></li>\n",
    "    <li> <a href='#step4'> Overall Shading Factor (for 1 day) </a></li>\n",
    "</ol>\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='step1'></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 1. Running the simulations for all the cases"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Your simulation will be stored in C:\\Users\\sayala\\Documents\\GitHub\\bifacial_radiance\\bifacial_radiance\\TEMP\\Tutorial_09\n"
     ]
    }
   ],
   "source": [
    "import os\n",
    "from pathlib import Path\n",
    "\n",
    "testfolder = str(Path().resolve().parent.parent / 'bifacial_radiance' / 'TEMP' / 'Tutorial_09')\n",
    "if not os.path.exists(testfolder):\n",
    "    os.makedirs(testfolder)\n",
    "\n",
    "print (\"Your simulation will be stored in %s\" % testfolder)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "# VARIABLES of the simulation: \n",
    "lat = 35.1 # ABQ\n",
    "lon = -106.7 # ABQ\n",
    "x=1\n",
    "y = 2 \n",
    "numpanels=1\n",
    "limit_angle = 45 # tracker rotation limit angle\n",
    "backtrack = True\n",
    "albedo = 'concrete'     # ground albedo\n",
    "hub_height = y*0.75   # H = 0.75 \n",
    "gcr = 0.35  \n",
    "pitch = y/gcr\n",
    "#pitch = 1.0/gcr # Check from 1Axis_Shading_PVSC2018 file\n",
    "cumulativesky = False # needed for set1axis and makeScene1axis so simulation is done hourly not with gencumsky.\n",
    "limit_angle = 45 # tracker rotation limit angle\n",
    "nMods=10\n",
    "nRows=3\n",
    "sensorsy = 200\n",
    "module_type='test-module'\n",
    "datewanted='06_24' # sunny day 6/24/1972 (index 4180 - 4195). Valid formats starting version 0.4.0 for full day sim: mm_dd\n",
    "\n",
    "## Torque tube info\n",
    "tubetype='round'\n",
    "material = 'Metal_Grey'\n",
    "diameter = 0.1\n",
    "axisofrotationTorqueTube = False   # Original PVSC version rotated around the modules like most other software.\n",
    "# Variables that will get defined on each iteration below:\n",
    "zgap = 0 # 0.2, 0.3 values tested. Re-defined on each simulation.\n",
    "visible = False # baseline is no torque tube.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "0.3.4+387.g07a8343.dirty\n",
      "path = C:\\Users\\sayala\\Documents\\GitHub\\bifacial_radiance\\bifacial_radiance\\TEMP\\Tutorial_09\n",
      "Loading albedo, 1 value(s), 0.281 avg\n",
      "1 nonzero albedo values.\n",
      "Getting weather file: USA_NM_Albuquerque.723650_TMY2.epw\n",
      " ... OK!\n",
      "8760 line in WeatherFile. Assuming this is a standard hourly WeatherFile for the year for purposes of saving Gencumulativesky temporary weather files in EPW folder.\n",
      "Coercing year to 2021\n",
      "Filtering dates\n",
      "Saving file EPWs\\metdata_temp.csv, # points: 8760\n",
      "Calculating Sun position for Metdata that is right-labeled  with a delta of -30 mins. i.e. 12 is 11:30 sunpos\n",
      "Creating ~14 skyfiles. \n",
      "Created 13 skyfiles in /skies/\n"
     ]
    }
   ],
   "source": [
    "# Simulation Start.\n",
    "import bifacial_radiance\n",
    "import numpy as np\n",
    "\n",
    "print(bifacial_radiance.__version__)\n",
    "\n",
    "demo = bifacial_radiance.RadianceObj(path = testfolder)  \n",
    "demo.setGround(albedo)\n",
    "epwfile = demo.getEPW(lat, lon) \n",
    "metdata = demo.readWeatherFile(epwfile, starttime=datewanted, endtime=datewanted) \n",
    "trackerdict = demo.set1axis(metdata, limit_angle = limit_angle, backtrack = backtrack, gcr = gcr, cumulativesky = cumulativesky)\n",
    "trackerdict = demo.gendaylit1axis() \n",
    "sceneDict = {'pitch':pitch,'hub_height':hub_height, 'nMods': nMods, 'nRows': nRows}  "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='step1a'></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### A. Baseline Case: No Torque Tube\n",
    "\n",
    "When torquetube is False, zgap is the distance from axis of torque tube to module surface, but since we are rotating from the module's axis, this Zgap doesn't matter for this baseline case."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Module Name: _NoTT\n",
      "Module _NoTT updated in module.json\n",
      "Pre-existing .rad file objects\\_NoTT.rad will be overwritten\n",
      "Module _NoTT updated in module.json\n",
      "Pre-existing .rad file objects\\_NoTT.rad will be overwritten\n",
      "\n",
      "Making ~13 .rad files for gendaylit 1-axis workflow (this takes a minute..)\n",
      "13 Radfiles created in /objects/\n",
      "\n",
      "Making 13 octfiles in root directory.\n",
      "Created 1axis_2021-06-24_0600.oct\n",
      "Created 1axis_2021-06-24_0700.oct\n",
      "Created 1axis_2021-06-24_0800.oct\n",
      "Created 1axis_2021-06-24_0900.oct\n",
      "Created 1axis_2021-06-24_1000.oct\n",
      "Created 1axis_2021-06-24_1100.oct\n",
      "Created 1axis_2021-06-24_1200.oct\n",
      "Created 1axis_2021-06-24_1300.oct\n",
      "Created 1axis_2021-06-24_1400.oct\n",
      "Created 1axis_2021-06-24_1500.oct\n",
      "Created 1axis_2021-06-24_1600.oct\n",
      "Created 1axis_2021-06-24_1700.oct\n",
      "Created 1axis_2021-06-24_1800.oct\n",
      "Linescan in process: 1axis_2021-06-24_0600_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_0600_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0600_NoTT.csv\n",
      "Index: 2021-06-24_0600. Wm2Front: 160.73402666666667. Wm2Back: 17.121764033333335\n",
      "Linescan in process: 1axis_2021-06-24_0700_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_0700_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0700_NoTT.csv\n",
      "Index: 2021-06-24_0700. Wm2Front: 711.7897250000001. Wm2Back: 15.662987166666667\n",
      "Linescan in process: 1axis_2021-06-24_0800_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_0800_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0800_NoTT.csv\n",
      "Index: 2021-06-24_0800. Wm2Front: 924.5799430000001. Wm2Back: 69.3365472\n",
      "Linescan in process: 1axis_2021-06-24_0900_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_0900_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0900_NoTT.csv\n",
      "Index: 2021-06-24_0900. Wm2Front: 1039.2877216666666. Wm2Back: 84.73331776666666\n",
      "Linescan in process: 1axis_2021-06-24_1000_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_1000_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1000_NoTT.csv\n",
      "Index: 2021-06-24_1000. Wm2Front: 1077.4515266666667. Wm2Back: 107.66131883333334\n",
      "Linescan in process: 1axis_2021-06-24_1100_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_1100_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1100_NoTT.csv\n",
      "Index: 2021-06-24_1100. Wm2Front: 1083.8388816666668. Wm2Back: 133.7681057\n",
      "Linescan in process: 1axis_2021-06-24_1200_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_1200_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1200_NoTT.csv\n",
      "Index: 2021-06-24_1200. Wm2Front: 1085.4498483333332. Wm2Back: 150.34431866666668\n",
      "Linescan in process: 1axis_2021-06-24_1300_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_1300_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1300_NoTT.csv\n",
      "Index: 2021-06-24_1300. Wm2Front: 1083.580191666667. Wm2Back: 152.35295416666665\n",
      "Linescan in process: 1axis_2021-06-24_1400_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_1400_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1400_NoTT.csv\n",
      "Index: 2021-06-24_1400. Wm2Front: 1090.0554633333334. Wm2Back: 139.71770083333334\n",
      "Linescan in process: 1axis_2021-06-24_1500_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_1500_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1500_NoTT.csv\n",
      "Index: 2021-06-24_1500. Wm2Front: 1088.7448499999998. Wm2Back: 115.78704476666665\n",
      "Linescan in process: 1axis_2021-06-24_1600_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_1600_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1600_NoTT.csv\n",
      "Index: 2021-06-24_1600. Wm2Front: 1063.6545199999998. Wm2Back: 88.75401606666667\n",
      "Linescan in process: 1axis_2021-06-24_1700_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_1700_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1700_NoTT.csv\n",
      "Index: 2021-06-24_1700. Wm2Front: 973.7315478333334. Wm2Back: 74.38548493333333\n",
      "Linescan in process: 1axis_2021-06-24_1800_NoTT_Front\n",
      "Linescan in process: 1axis_2021-06-24_1800_NoTT_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1800_NoTT.csv\n",
      "Index: 2021-06-24_1800. Wm2Front: 795.1581940000001. Wm2Back: 29.155385466666665\n",
      "Saving a cumulative-results file in the main simulation folder.This adds up by sensor location the irradiance over all hours or configurations considered.\n",
      "Warning: This file saving routine does not clean results, so if your setup has ygaps, or 2+modules or torque tubes, doing a deeper cleaning and working with the individual results files in the results folder is highly suggested.\n",
      "\n",
      "Saving Cumulative results\n",
      "Saved: cumulative_results__NoTT.csv\n"
     ]
    }
   ],
   "source": [
    "#CASE 0 No torque tube\n",
    "# When torquetube is False, zgap is the distance from axis of torque tube to module surface, but since we are rotating from the module's axis, this Zgap doesn't matter.\n",
    "# zgap = 0.1 + diameter/2.0  \n",
    "torquetube = False \n",
    "customname = '_NoTT'\n",
    "module_NoTT = demo.makeModule(name=customname,x=x,y=y, numpanels=numpanels)\n",
    "module_NoTT.addTorquetube(visible=False, axisofrotation=False, diameter=0)\n",
    "trackerdict = demo.makeScene1axis(trackerdict, module_NoTT, sceneDict, cumulativesky = cumulativesky) \n",
    "trackerdict = demo.makeOct1axis(trackerdict)\n",
    "trackerdict = demo.analysis1axis(trackerdict, sensorsy = sensorsy, customname = customname)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='step1b'></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### B. ZGAP = 0.1"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Module Name: _zgap0.1\n",
      "Module _zgap0.1 updated in module.json\n",
      "\n",
      "Making ~13 .rad files for gendaylit 1-axis workflow (this takes a minute..)\n",
      "13 Radfiles created in /objects/\n",
      "\n",
      "Making 13 octfiles in root directory.\n",
      "Created 1axis_2021-06-24_0600.oct\n",
      "Created 1axis_2021-06-24_0700.oct\n",
      "Created 1axis_2021-06-24_0800.oct\n",
      "Created 1axis_2021-06-24_0900.oct\n",
      "Created 1axis_2021-06-24_1000.oct\n",
      "Created 1axis_2021-06-24_1100.oct\n",
      "Created 1axis_2021-06-24_1200.oct\n",
      "Created 1axis_2021-06-24_1300.oct\n",
      "Created 1axis_2021-06-24_1400.oct\n",
      "Created 1axis_2021-06-24_1500.oct\n",
      "Created 1axis_2021-06-24_1600.oct\n",
      "Created 1axis_2021-06-24_1700.oct\n",
      "Created 1axis_2021-06-24_1800.oct\n",
      "Linescan in process: 1axis_2021-06-24_0600_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_0600_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0600_zgap0.1.csv\n",
      "Index: 2021-06-24_0600. Wm2Front: 160.58522366666668. Wm2Back: 16.314374041666664\n",
      "Linescan in process: 1axis_2021-06-24_0700_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_0700_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0700_zgap0.1.csv\n",
      "Index: 2021-06-24_0700. Wm2Front: 711.8783271666666. Wm2Back: 14.72640245\n",
      "Linescan in process: 1axis_2021-06-24_0800_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_0800_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0800_zgap0.1.csv\n",
      "Index: 2021-06-24_0800. Wm2Front: 924.6545375000001. Wm2Back: 65.33095958333334\n",
      "Linescan in process: 1axis_2021-06-24_0900_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_0900_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0900_zgap0.1.csv\n",
      "Index: 2021-06-24_0900. Wm2Front: 1039.1562083333333. Wm2Back: 80.46069813333334\n",
      "Linescan in process: 1axis_2021-06-24_1000_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_1000_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1000_zgap0.1.csv\n",
      "Index: 2021-06-24_1000. Wm2Front: 1078.4097983333334. Wm2Back: 102.5569975\n",
      "Linescan in process: 1axis_2021-06-24_1100_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_1100_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1100_zgap0.1.csv\n",
      "Index: 2021-06-24_1100. Wm2Front: 1083.4543766666666. Wm2Back: 126.3588816\n",
      "Linescan in process: 1axis_2021-06-24_1200_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_1200_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1200_zgap0.1.csv\n",
      "Index: 2021-06-24_1200. Wm2Front: 1085.5948533333335. Wm2Back: 143.09100388333331\n",
      "Linescan in process: 1axis_2021-06-24_1300_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_1300_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1300_zgap0.1.csv\n",
      "Index: 2021-06-24_1300. Wm2Front: 1083.3561866666669. Wm2Back: 143.74302033333333\n",
      "Linescan in process: 1axis_2021-06-24_1400_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_1400_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1400_zgap0.1.csv\n",
      "Index: 2021-06-24_1400. Wm2Front: 1089.9818416666667. Wm2Back: 133.16825973333334\n",
      "Linescan in process: 1axis_2021-06-24_1500_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_1500_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1500_zgap0.1.csv\n",
      "Index: 2021-06-24_1500. Wm2Front: 1089.1320249999999. Wm2Back: 110.99724395000001\n",
      "Linescan in process: 1axis_2021-06-24_1600_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_1600_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1600_zgap0.1.csv\n",
      "Index: 2021-06-24_1600. Wm2Front: 1063.6464533333333. Wm2Back: 84.98364443333334\n",
      "Linescan in process: 1axis_2021-06-24_1700_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_1700_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1700_zgap0.1.csv\n",
      "Index: 2021-06-24_1700. Wm2Front: 974.0719039999999. Wm2Back: 71.22193366666666\n",
      "Linescan in process: 1axis_2021-06-24_1800_zgap0.1_Front\n",
      "Linescan in process: 1axis_2021-06-24_1800_zgap0.1_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1800_zgap0.1.csv\n",
      "Index: 2021-06-24_1800. Wm2Front: 795.5270095. Wm2Back: 27.774535033333333\n",
      "Saving a cumulative-results file in the main simulation folder.This adds up by sensor location the irradiance over all hours or configurations considered.\n",
      "Warning: This file saving routine does not clean results, so if your setup has ygaps, or 2+modules or torque tubes, doing a deeper cleaning and working with the individual results files in the results folder is highly suggested.\n",
      "\n",
      "Saving Cumulative results\n",
      "Saved: cumulative_results__zgap0.1.csv\n"
     ]
    }
   ],
   "source": [
    "#ZGAP 0.1 \n",
    "zgap = 0.1\n",
    "customname = '_zgap0.1'\n",
    "tubeParams = {'tubetype':tubetype,\n",
    "              'diameter':diameter,\n",
    "              'material':material,\n",
    "              'axisofrotation':False,\n",
    "              'visible':True} # either pass this into makeModule, or separately into module.addTorquetube()\n",
    "module_zgap01 = demo.makeModule(name=customname, x=x,y=y, numpanels=numpanels, zgap=zgap, tubeParams=tubeParams)\n",
    "trackerdict = demo.makeScene1axis(trackerdict, module_zgap01, sceneDict, cumulativesky = cumulativesky) \n",
    "trackerdict = demo.makeOct1axis(trackerdict)\n",
    "trackerdict = demo.analysis1axis(trackerdict, sensorsy = sensorsy, customname = customname)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='step1c'></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### C. ZGAP = 0.2"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Module Name: _zgap0.2\n",
      "Module _zgap0.2 updated in module.json\n",
      "Pre-existing .rad file objects\\_zgap0.2.rad will be overwritten\n",
      "\n",
      "Making ~13 .rad files for gendaylit 1-axis workflow (this takes a minute..)\n",
      "13 Radfiles created in /objects/\n",
      "\n",
      "Making 13 octfiles in root directory.\n",
      "Created 1axis_2021-06-24_0600.oct\n",
      "Created 1axis_2021-06-24_0700.oct\n",
      "Created 1axis_2021-06-24_0800.oct\n",
      "Created 1axis_2021-06-24_0900.oct\n",
      "Created 1axis_2021-06-24_1000.oct\n",
      "Created 1axis_2021-06-24_1100.oct\n",
      "Created 1axis_2021-06-24_1200.oct\n",
      "Created 1axis_2021-06-24_1300.oct\n",
      "Created 1axis_2021-06-24_1400.oct\n",
      "Created 1axis_2021-06-24_1500.oct\n",
      "Created 1axis_2021-06-24_1600.oct\n",
      "Created 1axis_2021-06-24_1700.oct\n",
      "Created 1axis_2021-06-24_1800.oct\n",
      "Linescan in process: 1axis_2021-06-24_0600_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_0600_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0600_zgap0.2.csv\n",
      "Index: 2021-06-24_0600. Wm2Front: 160.6793395. Wm2Back: 16.308693233333333\n",
      "Linescan in process: 1axis_2021-06-24_0700_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_0700_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0700_zgap0.2.csv\n",
      "Index: 2021-06-24_0700. Wm2Front: 711.6508748333333. Wm2Back: 14.997858851666665\n",
      "Linescan in process: 1axis_2021-06-24_0800_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_0800_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0800_zgap0.2.csv\n",
      "Index: 2021-06-24_0800. Wm2Front: 924.6050766666667. Wm2Back: 65.85995245000001\n",
      "Linescan in process: 1axis_2021-06-24_0900_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_0900_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0900_zgap0.2.csv\n",
      "Index: 2021-06-24_0900. Wm2Front: 1039.106215. Wm2Back: 81.24756816666667\n",
      "Linescan in process: 1axis_2021-06-24_1000_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_1000_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1000_zgap0.2.csv\n",
      "Index: 2021-06-24_1000. Wm2Front: 1078.0332999999998. Wm2Back: 103.389067\n",
      "Linescan in process: 1axis_2021-06-24_1100_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_1100_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1100_zgap0.2.csv\n",
      "Index: 2021-06-24_1100. Wm2Front: 1083.9385066666666. Wm2Back: 127.08079916666668\n",
      "Linescan in process: 1axis_2021-06-24_1200_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_1200_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1200_zgap0.2.csv\n",
      "Index: 2021-06-24_1200. Wm2Front: 1085.1381666666668. Wm2Back: 144.71764443333333\n",
      "Linescan in process: 1axis_2021-06-24_1300_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_1300_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1300_zgap0.2.csv\n",
      "Index: 2021-06-24_1300. Wm2Front: 1083.1195133333333. Wm2Back: 146.28812258333335\n",
      "Linescan in process: 1axis_2021-06-24_1400_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_1400_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1400_zgap0.2.csv\n",
      "Index: 2021-06-24_1400. Wm2Front: 1089.849945. Wm2Back: 135.0038261166667\n",
      "Linescan in process: 1axis_2021-06-24_1500_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_1500_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1500_zgap0.2.csv\n",
      "Index: 2021-06-24_1500. Wm2Front: 1090.1313516666667. Wm2Back: 111.87352368333333\n",
      "Linescan in process: 1axis_2021-06-24_1600_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_1600_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1600_zgap0.2.csv\n",
      "Index: 2021-06-24_1600. Wm2Front: 1064.4160566666667. Wm2Back: 86.25420585\n",
      "Linescan in process: 1axis_2021-06-24_1700_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_1700_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1700_zgap0.2.csv\n",
      "Index: 2021-06-24_1700. Wm2Front: 974.0041676666666. Wm2Back: 72.31188941666667\n",
      "Linescan in process: 1axis_2021-06-24_1800_zgap0.2_Front\n",
      "Linescan in process: 1axis_2021-06-24_1800_zgap0.2_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1800_zgap0.2.csv\n",
      "Index: 2021-06-24_1800. Wm2Front: 795.1022419999999. Wm2Back: 27.072133116666663\n",
      "Saving a cumulative-results file in the main simulation folder.This adds up by sensor location the irradiance over all hours or configurations considered.\n",
      "Warning: This file saving routine does not clean results, so if your setup has ygaps, or 2+modules or torque tubes, doing a deeper cleaning and working with the individual results files in the results folder is highly suggested.\n",
      "\n",
      "Saving Cumulative results\n",
      "Saved: cumulative_results__zgap0.2.csv\n"
     ]
    }
   ],
   "source": [
    "#ZGAP 0.2\n",
    "zgap = 0.2\n",
    "customname = '_zgap0.2'\n",
    "tubeParams = {'tubetype':tubetype,\n",
    "              'diameter':diameter,\n",
    "              'material':material,\n",
    "              'axisofrotation':False,\n",
    "              'visible':True} # either pass this into makeModule, or separately into module.addTorquetube()\n",
    "module_zgap02 = demo.makeModule(name=customname, x=x,y=y, numpanels=numpanels,zgap=zgap, tubeParams=tubeParams)\n",
    "trackerdict = demo.makeScene1axis(trackerdict, module_zgap02, sceneDict, cumulativesky = cumulativesky) \n",
    "trackerdict = demo.makeOct1axis(trackerdict)\n",
    "trackerdict = demo.analysis1axis(trackerdict, sensorsy = sensorsy, customname = customname)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='step1d'></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### D. ZGAP = 0.3"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Module Name: _zgap0.3\n",
      "Module _zgap0.3 updated in module.json\n",
      "\n",
      "Making ~13 .rad files for gendaylit 1-axis workflow (this takes a minute..)\n",
      "13 Radfiles created in /objects/\n",
      "\n",
      "Making 13 octfiles in root directory.\n",
      "Created 1axis_2021-06-24_0600.oct\n",
      "Created 1axis_2021-06-24_0700.oct\n",
      "Created 1axis_2021-06-24_0800.oct\n",
      "Created 1axis_2021-06-24_0900.oct\n",
      "Created 1axis_2021-06-24_1000.oct\n",
      "Created 1axis_2021-06-24_1100.oct\n",
      "Created 1axis_2021-06-24_1200.oct\n",
      "Created 1axis_2021-06-24_1300.oct\n",
      "Created 1axis_2021-06-24_1400.oct\n",
      "Created 1axis_2021-06-24_1500.oct\n",
      "Created 1axis_2021-06-24_1600.oct\n",
      "Created 1axis_2021-06-24_1700.oct\n",
      "Created 1axis_2021-06-24_1800.oct\n",
      "Linescan in process: 1axis_2021-06-24_0600_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_0600_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0600_zgap0.3.csv\n",
      "Index: 2021-06-24_0600. Wm2Front: 160.71439716666666. Wm2Back: 16.402217866666664\n",
      "Linescan in process: 1axis_2021-06-24_0700_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_0700_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0700_zgap0.3.csv\n",
      "Index: 2021-06-24_0700. Wm2Front: 711.8272646666668. Wm2Back: 14.969952549999999\n",
      "Linescan in process: 1axis_2021-06-24_0800_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_0800_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0800_zgap0.3.csv\n",
      "Index: 2021-06-24_0800. Wm2Front: 924.5672013333332. Wm2Back: 70.4617007\n",
      "Linescan in process: 1axis_2021-06-24_0900_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_0900_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_0900_zgap0.3.csv\n",
      "Index: 2021-06-24_0900. Wm2Front: 1039.4952816666666. Wm2Back: 82.29257826666668\n",
      "Linescan in process: 1axis_2021-06-24_1000_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_1000_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1000_zgap0.3.csv\n",
      "Index: 2021-06-24_1000. Wm2Front: 1077.7083666666667. Wm2Back: 104.50355728333332\n",
      "Linescan in process: 1axis_2021-06-24_1100_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_1100_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1100_zgap0.3.csv\n",
      "Index: 2021-06-24_1100. Wm2Front: 1083.7942533333332. Wm2Back: 130.08286796666667\n",
      "Linescan in process: 1axis_2021-06-24_1200_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_1200_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1200_zgap0.3.csv\n",
      "Index: 2021-06-24_1200. Wm2Front: 1085.1777233333335. Wm2Back: 145.488044\n",
      "Linescan in process: 1axis_2021-06-24_1300_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_1300_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1300_zgap0.3.csv\n",
      "Index: 2021-06-24_1300. Wm2Front: 1083.5996499999999. Wm2Back: 147.47137110000003\n",
      "Linescan in process: 1axis_2021-06-24_1400_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_1400_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1400_zgap0.3.csv\n",
      "Index: 2021-06-24_1400. Wm2Front: 1089.7519816666668. Wm2Back: 136.00649253333333\n",
      "Linescan in process: 1axis_2021-06-24_1500_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_1500_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1500_zgap0.3.csv\n",
      "Index: 2021-06-24_1500. Wm2Front: 1090.3138166666668. Wm2Back: 112.7980408\n",
      "Linescan in process: 1axis_2021-06-24_1600_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_1600_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1600_zgap0.3.csv\n",
      "Index: 2021-06-24_1600. Wm2Front: 1063.9477266666668. Wm2Back: 87.05726741666668\n",
      "Linescan in process: 1axis_2021-06-24_1700_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_1700_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1700_zgap0.3.csv\n",
      "Index: 2021-06-24_1700. Wm2Front: 973.9965698333332. Wm2Back: 72.18619936666667\n",
      "Linescan in process: 1axis_2021-06-24_1800_zgap0.3_Front\n",
      "Linescan in process: 1axis_2021-06-24_1800_zgap0.3_Back\n",
      "Saved: results\\irr_1axis_2021-06-24_1800_zgap0.3.csv\n",
      "Index: 2021-06-24_1800. Wm2Front: 795.2513158333334. Wm2Back: 27.609950083333334\n",
      "Saving a cumulative-results file in the main simulation folder.This adds up by sensor location the irradiance over all hours or configurations considered.\n",
      "Warning: This file saving routine does not clean results, so if your setup has ygaps, or 2+modules or torque tubes, doing a deeper cleaning and working with the individual results files in the results folder is highly suggested.\n",
      "\n",
      "Saving Cumulative results\n",
      "Saved: cumulative_results__zgap0.3.csv\n"
     ]
    }
   ],
   "source": [
    "#ZGAP 0.3\n",
    "zgap = 0.3\n",
    "customname = '_zgap0.3'\n",
    "tubeParams = {'tubetype':tubetype,\n",
    "              'diameter':diameter,\n",
    "              'material':material,\n",
    "              'axisofrotation':False,\n",
    "              'visible':True} # either pass this into makeModule, or separately into module.addTorquetube()\n",
    "module_zgap03 = demo.makeModule(name=customname,x=x,y=y, numpanels=numpanels, zgap=zgap, tubeParams=tubeParams)\n",
    "trackerdict = demo.makeScene1axis(trackerdict, module_zgap03, sceneDict, cumulativesky = cumulativesky) \n",
    "trackerdict = demo.makeOct1axis(trackerdict)\n",
    "trackerdict = demo.analysis1axis(trackerdict, sensorsy = sensorsy, customname = customname)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='step2'></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2. Read-back the values and tabulate average values for unshaded, 10cm gap and 30cm gap\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "C:\\Users\\sayala\\Documents\\GitHub\\bifacial_radiance\\bifacial_radiance\\TEMP\\Tutorial_09\\results\n"
     ]
    }
   ],
   "source": [
    "import glob\n",
    "import pandas as pd\n",
    "\n",
    "resultsfolder = os.path.join(testfolder, 'results')\n",
    "print (resultsfolder)\n",
    "filenames = glob.glob(os.path.join(resultsfolder,'*.csv'))\n",
    "noTTlist = [k for k in filenames if 'NoTT' in k]\n",
    "zgap10cmlist = [k for k in filenames if 'zgap0.1' in k]\n",
    "zgap20cmlist = [k for k in filenames if 'zgap0.2' in k]\n",
    "zgap30cmlist = [k for k in filenames if 'zgap0.3' in k]\n",
    "\n",
    "# sum across all hours for each case\n",
    "unsh_front = np.array([pd.read_csv(f, engine='python')['Wm2Front'] for f in noTTlist]).sum(axis = 0)\n",
    "cm10_front = np.array([pd.read_csv(f, engine='python')['Wm2Front'] for f in zgap10cmlist]).sum(axis = 0)\n",
    "cm20_front = np.array([pd.read_csv(f, engine='python')['Wm2Front'] for f in zgap20cmlist]).sum(axis = 0)\n",
    "cm30_front = np.array([pd.read_csv(f, engine='python')['Wm2Front'] for f in zgap30cmlist]).sum(axis = 0)\n",
    "unsh_back = np.array([pd.read_csv(f, engine='python')['Wm2Back'] for f in noTTlist]).sum(axis = 0)\n",
    "cm10_back = np.array([pd.read_csv(f, engine='python')['Wm2Back'] for f in zgap10cmlist]).sum(axis = 0)\n",
    "cm20_back = np.array([pd.read_csv(f, engine='python')['Wm2Back'] for f in zgap20cmlist]).sum(axis = 0)\n",
    "cm30_back = np.array([pd.read_csv(f, engine='python')['Wm2Back'] for f in zgap30cmlist]).sum(axis = 0)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='step3'></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 3. plot spatial loss values for 10cm and 30cm data"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "WARNING:matplotlib.font_manager:findfont: Font family ['sans-serif'] not found. Falling back to DejaVu Sans.\n",
      "WARNING:matplotlib.font_manager:findfont: Generic family 'sans-serif' not found because none of the following families were found: Helvetica\n",
      "WARNING:matplotlib.font_manager:findfont: Font family ['sans-serif'] not found. Falling back to DejaVu Sans.\n",
      "WARNING:matplotlib.font_manager:findfont: Generic family 'sans-serif' not found because none of the following families were found: Helvetica\n",
      "WARNING:matplotlib.font_manager:findfont: Font family ['sans-serif'] not found. Falling back to DejaVu Sans.\n",
      "WARNING:matplotlib.font_manager:findfont: Generic family 'sans-serif' not found because none of the following families were found: Helvetica\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 288x180 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "import matplotlib.pyplot as plt\n",
    "plt.rcParams['font.family'] = 'sans-serif'\n",
    "plt.rcParams['font.sans-serif'] = ['Helvetica']\n",
    "plt.rcParams['axes.linewidth'] = 0.2 #set the value globally\n",
    "\n",
    "fig = plt.figure()\n",
    "fig.set_size_inches(4, 2.5)\n",
    "ax = fig.add_axes((0.15,0.15,0.78,0.75))\n",
    "#plt.rc('font', family='sans-serif')\n",
    "plt.rc('xtick',labelsize=8)\n",
    "plt.rc('ytick',labelsize=8)\n",
    "plt.rc('axes',labelsize=8)\n",
    "plt.plot(np.linspace(-1,1,unsh_back.__len__()),(cm30_back - unsh_back)/unsh_back*100, label = '30cm gap',color = 'black')  #steelblue\n",
    "plt.plot(np.linspace(-1,1,unsh_back.__len__()),(cm20_back - unsh_back)/unsh_back*100, label = '20cm gap',color = 'steelblue', linestyle = '--')  #steelblue\n",
    "plt.plot(np.linspace(-1,1,unsh_back.__len__()),(cm10_back - unsh_back)/unsh_back*100, label = '10cm gap',color = 'darkorange')  #steelblue\n",
    "#plt.ylabel('$G_{rear}$ vs unshaded [Wm-2]')#(r'$BG_E$ [%]')\n",
    "plt.ylabel('$G_{rear}$ / $G_{rear,tubeless}$ -1 [%]')\n",
    "plt.xlabel('Module X position [m]')\n",
    "plt.legend(fontsize = 8,frameon = False,loc='best')\n",
    "#plt.ylim([0, 15])\n",
    "plt.title('Torque tube shading loss',fontsize=9)\n",
    "#plt.annotate('South',xy=(-10,9.5),fontsize = 8); plt.annotate('North',xy=(8,9.5),fontsize = 8)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='step4'></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 4. Overall Shading Loss Factor\n",
    "\n",
    "To calculate shading loss factor, we can use the following equation:\n",
    "\n",
    "\n",
    "\n",
    "<img src=\"../images_wiki/AdvancedJournals/Equation_ShadingFactor.PNG\">"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [],
   "source": [
    "ShadingFactor = (1 - cm30_back.sum() / unsh_back.sum())*100"
   ]
  }
 ],
 "metadata": {
  "anaconda-cloud": {},
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.8.8"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}