Skip to content

Commit

Permalink
enrich help page content
Browse files Browse the repository at this point in the history
  • Loading branch information
@paulapreuss
paulapreuss committed Jun 3, 2024
1 parent bc958ab commit 5b55806
Show file tree
Hide file tree
Showing 6 changed files with 179 additions and 63 deletions.
42 changes: 26 additions & 16 deletions app/templates/cp_nigeria/help_pages/choose_location.html
View file
Original file line number Diff line number Diff line change
@@ -1,22 +1,32 @@
<main>
<div>
<!-- TODO should we be getting rid of the pre-loaded communities? what's the situation with datenschutz? -->
<!-- TODO should we be getting rid of the pre-loaded communities? what's the situation with datenschutz? -->
<h4>Project setup</h4>
<strong>Pre-loaded communities</strong>: In the step to pre-select a community, one of the five pilot communities
related to the project can be selected. Upon selection, the community will be automatically selected from the map
and the communities' name filled into the <b>Name</b> field. Additionally, the communities' number of households,
enterprises and public facilities will be pre-loaded to aggregate the demand in step 3. This step is not necessary and should
be left blank if the project to be created is unrelated to one of the pilot communities. <br>
<strong>Other communities</strong>:
If the process should be conducted for a different community, the project site should be selected. To select a site, simply select the location on the map.
The map can be zoomed in and out by scrolling and moved with drag-and-drop. Once a site is selected, the
latitude and longitude will be automatically filled in. <br>
<!-- TODO should we get rid of simulation start?-->
<strong>Currency exchange rate</strong>: The assumed exchange rate plays a role for the default costs used during the process of this toolbox.
Since default cost assumptions made are based on typical costs in USD, the assumed costs for the systems
<p>
<span class="helpvar">Pre-select a community (optional)</span>: In the step to pre-select a community, you may select one of the five pilot communities
related to the project. Upon selection, the community will be automatically selected from the map
and the communities' name filled into the <span class="helpvar">Name</span> field. Additionally, the communities' number of households,
enterprises and public facilities will be pre-loaded to aggregate the demand in <a href="#section-demand_profile">step 3</a>.
Pre-selecting a community is not necessary and should be left blank if the project to be created is unrelated to one of the pilot communities.
</p>
<p>
To conduct the process for your own community, please input the community name into the <span class="helpvar">Name</span> field.
You may optionally add a <span class="helpvar">description</span> for your project.
</p>
<p>
<span class="helpvar">Latitude and longitude</span>: To fill in the site's coordinates, simply select the location on the map.
You can zoom into the map by scrolling and panning by dragging. Once a site is selected, the
latitude and longitude will be automatically filled in.
</p>
<!-- TODO should we get rid of simulation start?-->
<p>
<span class="helpvar">Currency exchange rate</span>: The assumed exchange rate plays a role for the default costs used during the process of this toolbox.
Since default cost assumptions made are based on typical costs in USD (see sources for default values in
<a href="#section-scenario_setup">section 4</a>), the assumed costs for the systems
might be outdated if the exchange rate fluctuates significantly. The current exchange rate is fetched once
during the creation of the project, but won't update automatically after the project is created. As such,
the user should make sure that the given exchange rate still constitutes a reasonable assumption when working on older projects. <br>

during the creation of the project, but will <b>not</b> update automatically once the project is created. As such,
you should ensure that the given exchange rate still constitutes a reasonable assumption when working on older projects,
and manually update its value if necessary.<br>
</p>
</div>
</main>
133 changes: 103 additions & 30 deletions app/templates/cp_nigeria/help_pages/demand_profile.html
View file
Original file line number Diff line number Diff line change
@@ -1,36 +1,109 @@
{% load static %}

<main>
<!-- TODO change this description based on if we keep the different wealth tiers or not-->
<div>
<h2>Community load input</h2>
Several typical standardized demand profiles have been developed from roughly 3600 energy appliance
ownership and usage surveys that were conducted across Nigeria in 2020 in 3 prioritized geopolitical zones.
Survey details can be found in the following publication:
<a href="https://www.nature.com/articles/s41597-023-02185-0">PeopleSuN (2023) Electricity supply quality and
use among rural and peri-urban households and small firms in Nigeria</a> <br>
Since the toolbox uses standardized demand profiles from electrified regions, the aggregated demand estimated in this
step is assumed to be able to cover future demand, and thus does not include a growth factor over time. To address concerns regarding
system oversizing, the household coverage parameter was introduced <!-- TODO link to the section where that is explained-->
In this step, the user should input all households, enterprises and public facilities present in the community.
All enterprise load profiles only include typical low power appliances in their respective demand profiles. As such,
if machinery responsible for large loads should be included, this needs to be done separately by adding "Machinery"
consumers to the list. As such, the user filling out the community demand should not only have information about
the general community size and consumers, but also about specific large load related to existing enterprises. If a
specific demand profile is not found on the list, the user may default to the generic load profiles included in the list.
<h2>SHS Threshold</h2>
Typically, not all households would be connected to the mini-grid. Instead, for households for which the grid connection
cost is too high, a Solar Home System might provide a more feasible alternative. Normally, both spatial distribution
and estimated demand play a part in defining these households. Since the spatial component is not included in this
toolbox, households can instead be excluded from the simulation based on their estimated demand. By default,
all households assumed to belong to the "Very Low Consumption" tier are assumed to be served by Solar Home Systems
instead. For the toolbox, this means that the demand belonging to these households is not included when sizing the mini-grid. <br>
By de-selecting the "Served by SHS" trace in the given graph, the total demand used to size the mini-grid can be seen.
If the SHS Threshold is set to the highest demand tier, the demand is equivalent to only considering enterprises and public facilities.
<h4>General Information</h4>
<p>
Several typical standardized demand profiles have been developed from roughly 3600 energy appliance
ownership and usage surveys that were conducted across Nigeria in 2020 in 3 prioritized geopolitical zones.
Survey details can be found in the following publication:
<a href="https://www.nature.com/articles/s41597-023-02185-0">PeopleSuN (2023) Electricity supply quality and
use among rural and peri-urban households and small firms in Nigeria</a>. Within this toolbox, the standardized
load profiles are aggregated based on user input to create an estimated demand profile for the community. To construct
this profile, you should have information about households, public facilities and enterprises (including specific machinery) available.
</p>
<!-- TODO change this description based on if we keep the different wealth tiers or not-->
<p>
<span class="helpvar">Households:</span>
</p>
<p>
<span class="helpvar">Enterprises:</span> Please input the enterprises in the community.
The standardized demand profiles for enterprises only include typical low power appliances. If the enterprise
employs high power appliances, these should be added separately by adding additional consumers with the
<span class="helpvar">Consumer Type</span> "Machinery". If a specific demand profile is not found,
you may default to the generic load profiles included in the list.
</p>
<p>
<i>
<b>Example:</b> The community has a car repair shop. Apart from basic appliances, such as lighting, the shop
also has a welder and two angle grinders. For this, three consumer groups need to be input:
</i>
<p>
<ol>
<li><i>Enterprise - Trades_Car or Motorbike Repair - 1</i></li>
<li><i>Machinery - Welder - 1</i></li>
<li><i>Machinery - Angle Grinder - 2</i></li>
</ol>
<p>
<span class="helpvar">Public facilities:</span> Please input the public facilities in the community. If a
specific demand profile is not found, you may default to the generic load profiles included in the list.
</p>
<h4>Adding consumers</h4>
<p>
To add a consumer, first select its <span class="helpvar">Consumer Type</span> from the drop-down menu. The possible
consumer types are <i>Household, Public facility, Enterprise</i> and <i>Machinery</i>. After selecting the consumer type,
you can select the specific <span class="helpvar">Demand Profile</span> from the next drop-down menu. Finally,
you can input the number of consumers. </p>
<p>
<i><b>Example:</b> The community has three restaurants. First, we select "Enterprise" from the <span class="helpvar">Consumer Type</span> menu.
</i></p>
<p style="text-align: center">
<img src="{% static 'help_pages/demand_input_1.png' %}" alt="Demand input: Step 1" style="width: 80%">
</p>
<p><i>Next, we select "Food_Restaurant" from the <span class="helpvar">Demand Profile</span> menu.</i></p>
<p style="text-align: center">
<img src="{% static 'help_pages/demand_input_2.png' %}" alt="Demand input: Step 1" style="width: 80%">
</p>
<p><i>
Finally, we input the number "3" in the <span class="helpvar">Nr. of consumers</span> field.</i></p>
<p style="text-align: center">
<img src="{% static 'help_pages/demand_input_3.png' %}" alt="Demand input: Step 3" style="width: 80%">
</p>
<p><i>
To add more consumer groups, we click on the <a>Add Consumer Group</a> button.
</i></p>
<p style="text-align: center">
<img src="{% static 'help_pages/demand_input_4.png' %}" alt="Demand input: Step 4" style="width: 80%">
</p>

<h4> Advanced Options</h4>
<p>
Since the toolbox uses standardized demand profiles from electrified regions, the aggregated demand estimated in this
step is assumed to be able to cover future demand, and thus does not include a growth factor over time. To address concerns regarding
system oversizing, two advanced options are available.
</p>
<p>
<span class="helpvar">Threshold for SHS users:</span>
Typically, not all households would be connected to the mini-grid. Instead, a Solar Home System might provide a
more feasible alternative for households where the grid connection
cost would be too high. Normally, both spatial distribution
and estimated demand play a part in defining these households. Since the spatial component is not included in this
toolbox, households can instead be excluded from the simulation based on their estimated demand. By default,
all households assumed to belong to the "Very Low Consumption" tier are assumed to be served by Solar Home Systems
instead. For the toolbox, this means that the demand belonging to these households is not included when sizing the mini-grid.
If the SHS Threshold is set to the highest demand tier, the demand is equivalent to only considering enterprises and public facilities. </p>
<p>When changing the Solar Home Threshold, the corresponding demand is displayed as hashed in the demand graph.
By de-selecting the <i>"Served by SHS"</i> trace in the graph legend, the demand to be covered by the mini-grid can be displayed.
</p>
<p>
<span class="helpvar">Minimal percentage of demand to fulfill:</span>
To avoid oversizing the mini-grid, it may make sense to size a system to only reliably satisfy a percentage of the future demand.
The percentage given in this factor indicates what percentage of the household demand should be satisfied by the mini-grid.
Demand from enterprises and facilities is always 100% satisfied.
</p>
<p>
<i>
<b>Example:</b> The community has been added into the tool represented by its consumer groups. To simulate
an alternative system, we want to consider a mini-grid that only consumers with a <i>Middle Consumption Estimate</i>
or higher will be connected to. Additionally, we want to size the initial system to only
satisfy 80% of the estimated demand. To accomplish this:

<h2>Household demand coverage</h2>
To avoid oversizing the mini-grid, it can sometimes be helpful to size a system not according to the total demand
(which in the case of this toolbox represents future demand), but to only reliably satisfy a percentage of the total demand.
The percentage given in this factor indicates what percentage of the household demand should be able to be satisfied by the mini-grid.
Demand from enterprises and facilities is always 100% satisfied.
</i>
</p>
<ol>
<li><i>We set the <span class="helpvar">Threshold for SHS users</span> to "Middle Consumption Estimate"</i></li>
<li><i>We set the <span class="helpvar">Minimal percentage of demand to fulfill</span> to 80%</i></li>
</ol>
</div>

</main>
30 changes: 24 additions & 6 deletions app/templates/cp_nigeria/help_pages/economic_params.html
View file
Original file line number Diff line number Diff line change
@@ -1,16 +1,34 @@
<main>
<div>
<h2>Financing sources</h2>
<h4>Financing sources</h4>
<p>
There are multiple sources of financing for a potential mini-grid project: Equity from the project developer,
equity from the community and an acquired grant. A loan is assumed to cover the rest of the costs that can‘t be
covered though grants and equity. In this page, the user can input the share of the upfront investments that might
covered though grants and equity. The total size of the loan will is not given as a user input, but instead
will be calculated from the remaining costs after subtracting <span class="helpvar">Grant share</span>,
<span class="helpvar">Mini-grid company equity</span> and <span class="helpvar">Community equity</span> from
the total investment costs.
</p>
<p>
<i>
<b>Note:</b> Please consider that <span class="helpvar">Grant share</span> and <span class="helpvar">Mini-grid company equity</span>
are input as percentages of the total investment costs, while <span class="helpvar">Community equity</span> is an absolute number.
This is done to allow the user to input a realistic amount of money that could be raised within the community,
regardless of the total project costs. Please also consider that percentages should be input as numbers ranging to 100
(e.g. 5% instead of 0.05) and community equity should be input as Million (e.g. 3 Million NGN instead of
3.000.000 Million NGN).
</i>
</p>

To
consider the loan repayments in the project cash flow, please input the expected <span class="helpvar">interest rate for the loan</span>, as well as
the repayment period. In this page, the user can input the share of the upfront investments that might
be covered by a grant and the share that might be covered by a project developer, as well as a fixed amount that
could realistically be raised by the community, if desired. <br>
A loan is assumed to cover the rest of the investment costs that can‘t be covered though grants and equity. To
model the loan repayments, this page also allows the user to input the expected interest rate for the loan, as well as
the repayment period.
A loan is assumed to cover the rest of the investment costs that can‘t be covered though grants and equity.
</p>

<h2>Additional parameters</h2>
<h4>Additional parameters</h4>
<strong>Interest rate for replacement loan</strong>: After the given loan maturity years, the initial loan
would be fully repaid. However, there are some assets that may need replacement, as their lifetime is typically
shorter than the project lifetime. To cover these costs, the tool considers an additional loan after ten years
Expand Down
13 changes: 10 additions & 3 deletions app/templates/cp_nigeria/help_pages/general.html
View file
Original file line number Diff line number Diff line change
@@ -1,8 +1,11 @@
<main>
<div>
Welcome to the CP Nigeria Toolbox. This toolbox is aimed towards communities interested in approaching stakholders
to initiate a mini-grid project. The Toolbox aims to empower communities by equipping them with all necessary tools
and information to start reaching out to potential stakeholders. <br>
Welcome to the CP Nigeria Toolbox. This toolbox is aimed towards communities interested in approaching stakeholders
to initiate a mini-grid project. The toolbox seeks to empower communities by equipping them with all necessary tools
and information to start reaching out to potential project partners.
The toolbox has been developed within the frame of the project <b>"CP Nigeria: Communities of Practice as drivers of
a bottom-up energy transition in Nigeria"</b> by the <a href="https://reiner-lemoine-institut.de/en/project-cp-nigeria/">Reiner Lemoine Institute</a>. This project is funded by the
<a href="https://www.international-climate-initiative.com/en/project/communities-of-practice-as-driver-of-a-bottom-up-energy-transition-in-nigeria-img2020-i-003-nga-energy-transition-communities-of-practice/">International Climate Initiative (IKI)</a>.
The toolbox will guide you through a number of steps with the goal of
<ol>
<li>Estimating the communities' future electricity demand</li>
Expand All @@ -11,5 +14,9 @@
<li>Conducting a financial analysis and estimating a potential tariff for the mini-grid project</li>
<li>Generating a comprehensive report that can be used to address project partners</li>
</ol>
<!-- TODO we should probably change that clicking on the top ribbon also saves changes-->
Each step will as you to input certain information. The inputs on each page will be saved upon clicking
the <button class="btn btn-small">Next</button> button, and will be lost if you close the page (or jump between
non-consecutive steps).
</div>
</main>
Loading

0 comments on commit 5b55806

Please sign in to comment.