<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

    <title>Minimum Needs Manager &mdash; InaSAFE Documentation 2.2.0 documentation</title>

    <link rel="stylesheet" href="_static/basic.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    <link rel="stylesheet" href="_static/bootstrap/css/bootstrap.min.css" type="text/css" />
    <link rel="stylesheet" href="_static/theme.css" type="text/css" />
    <link rel="stylesheet" href="_static/bootstrap/css/bootstrap-responsive.min.css" type="text/css" />

    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '2.2.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <script type="text/javascript" src="_static/bootstrap/js/bootstrap.js"></script>
    <script type="text/javascript" src="_static/jQuery.equalHeights.js"></script>
    <link rel="shortcut icon" href="_static/favicon.ico"/>
    <link rel="top" title="InaSAFE Documentation 2.2.0 documentation" href="index.html" />

<style>
    .navbar-fixed-top .navbar-inner, .navbar-fixed-bottom .navbar-inner
    {
        padding-bottom : 0px;
        padding-left   : 0px;
        padding-right  : 0px;
        padding-top    : 0px;
    }

    .navbar .brand
    {
        background-image  : url("_static/img/logo.png");
        background-repeat : no-repeat;
        height            : 42px;
        padding-left      : 30px;
    }

    .navbar-inverse .navbar-inner
    {
        background-color : none;
    }
</style>

<script>
    // put a line below the current locale flag
    $(document).ready(function () {
        var currentPage = 'needs_manager.html';
        var currentLang = window.location.href.slice(
                window.location.href.indexOf(currentPage) - 3,
                window.location.href.indexOf(currentPage) - 1);
        $('#flag_' + currentLang).css('background-color', '#cccccc');
        // Make the search button pretty - issue 36
        $(':submit').addClass('btn btn-warning btn-small');
    })


    function gotoLang(lang) {
        var currentPage = 'needs_manager.html';
        var baseUrl = window.location.href.slice(0, window.location.href.indexOf(currentPage) - 3); // -3 removes current locale
        window.location.href = baseUrl + lang + '/' + currentPage;
    }
</script>


<!--[if lt IE 9]>
<script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->

<!-- Piwik -->
<script type="text/javascript">
  var _paq = _paq || [];
  _paq.push(["setDoNotTrack", true]);
  _paq.push(["trackPageView"]);
  _paq.push(["enableLinkTracking"]);

  (function() {
    var u=(("https:" == document.location.protocol) ? "https" : "http") + "://piwik.hotosm.org/";
    _paq.push(["setTrackerUrl", u+"piwik.php"]);
    _paq.push(["setSiteId", "2"]);
    var d=document, g=d.createElement("script"), s=d.getElementsByTagName("script")[0]; g.type="text/javascript";
    g.defer=true; g.async=true; g.src=u+"piwik.js"; s.parentNode.insertBefore(g,s);
  })();
</script>
<!-- End Piwik Code -->


<link rel="shortcut icon" href="_static/img/favicon.ico">
<link rel="apple-touch-icon-precomposed" sizes="144x144"
      href="_static/bootstrap/img/apple-touch-icon-114x114-precomposed.png">
<link rel="apple-touch-icon-precomposed" sizes="72x72"
      href="_static/bootstrap/img/apple-touch-icon-72x72-precomposed.png">
<link rel="apple-touch-icon-precomposed" sizes="57x57"
      href="_static/bootstrap/img/apple-touch-icon-57x57-precomposed.png">
<link rel="apple-touch-icon-precomposed"
      href="_static/bootstrap/img/apple-touch-icon-57x57-precomposed.png">

  </head>
  <body>


    <div class="navbar navbar-inverse navbar-fixed-top">
        <div class="navbar-inner">
            <div class="container">

                <a class="btn btn-navbar" data-toggle="collapse"
                   data-target=".nav-collapse">
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                </a>
                <a class="brand" href="#"></a>
                <div class="nav-collapse collapse">
                    <ul class="nav">
                        <font color="#333">
                        <li><h1>Ina<b>SAFE</b></h1></li>
                        </font>
                    </ul>
                </div>
            </div>
        </div>

        <div class="related">
            <ul class="breadcrumb" id="breadcrumbs">


                <li class="right"
                style="margin-right: 10px" >
                <a href="genindex.html"
                   title="General Index"
                   style="z-index:;"
                accesskey="I">index</a>
                </li>



                <li class="first">
                    <a style="z-index:100;" href="index.html"> InaSAFE Docs </a>
                </li>


                <li><a href="#">Minimum Needs Manager</a></li>
            </ul>
        </div>
    </div>




<div class="container">
    <div class="row">
        <div class="span12">

  <div class="section" id="minimum-needs-manager">
<span id="id1"></span><h1>Minimum Needs Manager<a class="headerlink" href="#minimum-needs-manager" title="Permalink to this headline">¶</a></h1>
<p>As of version 2.2, the minimum needs system have received a major overhaul.
The minimum needs manager is a new tool that allows you to define &#8216;profiles&#8217;
of minimum needs to make them relevant to your country or region.</p>
<div class="figure align-center">
<a class="reference internal image-reference" href="_images/minimum_needs_manager.png"><img alt="Minimum Needs Manager" src="_images/minimum_needs_manager.png" style="width: 498.0px; height: 495.0px;" /></a>
<p class="caption">Minimum Needs Manager</p>
</div>
<p>We ship InaSAFE with standard profiles for:</p>
<ul class="simple">
<li>Indonesia - based on &#8216;Perka 7/2008&#8217;</li>
<li>Philippines (based on &#8216;Guidelines on Evacuation Center Coordination and
Management Joint Memorandom Circular No. Series of 2013&#8217;)</li>
</ul>
<p>There are two key concepts to be aware of in the minimum needs manager:</p>
<ul class="simple">
<li>profiles</li>
<li>resources</li>
</ul>
<div class="section" id="minimum-needs-profiles">
<h2>Minimum needs profiles<a class="headerlink" href="#minimum-needs-profiles" title="Permalink to this headline">¶</a></h2>
<p>A profile is a collection of resources that define the minimum needs for
a particular country or region. Typically a profile should be based on a
regional, national or international standard. The actual definition of
which resources are needed in a given profile is dependent on the local
conditions and customs for the area where the contingency plan is being
devised.</p>
<p>For example in the middle east, rice is a staple food whereas in South Africa,
maize meal is a staple food and thus the contingency planning should take
these localised needs into account.</p>
</div>
<div class="section" id="minimum-needs-resources">
<h2>Minimum needs resources<a class="headerlink" href="#minimum-needs-resources" title="Permalink to this headline">¶</a></h2>
<p>Each item in a minimum needs <strong>profile</strong> is a resource. Each resource is
described as a simple natural language sentence e.g.:</p>
<p>&#8220;Each person should be provided with 2.8 kilograms of Rice weekly.&#8221;</p>
<p>By clicking on a resource entry in the profile window, and then clicking the
<em class="guilabel">black pencil</em> icon you will be able to edit the resource using the resource
editor. Alternatively you can create a new resource for a profile by clicking
on the black <em class="guilabel">+</em> icon in the profile manager. You can also remove any
resource from a profile using the <em class="guilabel">-</em> icon in the profile manager.</p>
<div class="figure align-center">
<a class="reference internal image-reference" href="_images/resource-editor.png"><img alt="Resource Editor" src="_images/resource-editor.png" style="width: 519.0px; height: 522.0px;" /></a>
<p class="caption">Resource editor</p>
</div>
<p>When switching to edit or add resource mode, the minimum needs manager will
be updated to look like the screenshot above. Each resource is described in
terms of:</p>
<ul class="simple">
<li>resource name e.g. Rice</li>
<li>a description of the resource e.g. Basic food</li>
<li>unit in which the resource is provided e.g. kilogram</li>
<li>pluralised form of the units e.g. kilograms</li>
<li>abbreviation for the unit e.g. kg</li>
<li>the default allocation for the resource e.g. 2.8. This number can be
overridden on a per-analysis basis.</li>
<li>minimum allowed which is used to prevent allocating e.g. no drinking water
to displaced persons</li>
<li>maximum allowed which is used to set a sensible upper limit for the resource</li>
<li>a readable sentence which is used to compile the sentence describing the
resource in reports.</li>
</ul>
<p>These parameters are probably all fairly self explanatory, but the readable
sentence probably needs further detail. The sentence is compiled using a simple
keyword token replacement system. The following tokens can be used:</p>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">{{</span> <span class="pre">Default</span> <span class="pre">}}</span></tt></li>
<li><tt class="docutils literal"><span class="pre">{{</span> <span class="pre">Unit</span> <span class="pre">}}</span></tt></li>
<li><tt class="docutils literal"><span class="pre">{{</span> <span class="pre">Units</span> <span class="pre">}}</span></tt></li>
<li><tt class="docutils literal"><span class="pre">{{</span> <span class="pre">Unit</span> <span class="pre">abbreviation</span> <span class="pre">}}</span></tt></li>
<li><tt class="docutils literal"><span class="pre">{{</span> <span class="pre">Resource</span> <span class="pre">name</span> <span class="pre">}}</span></tt></li>
<li><tt class="docutils literal"><span class="pre">{{</span> <span class="pre">Frequency</span> <span class="pre">}}</span></tt></li>
<li><tt class="docutils literal"><span class="pre">{{</span> <span class="pre">Minimum</span> <span class="pre">allowed</span> <span class="pre">}}</span></tt></li>
<li><tt class="docutils literal"><span class="pre">{{</span> <span class="pre">Maximum</span> <span class="pre">allowed</span> <span class="pre">}}</span></tt></li>
</ul>
<p>When the token is placed in the sentence it will be replaced with the actual
value at report generation time. This contrived example shows a
tokenised sentence that includes all possible keywords:</p>
<div class="highlight-python"><div class="highlight"><pre>A displaced person should be provided with {{ Default }}
{{ Unit }}/{{ Units }}/{{ Unit abbreviation }} of {{ Resource name }}.
Though no less than {{ Minimum allowed }} and no more than
{{ Maximum allowed }}. This should be provided {{ Frequency }}.
</pre></div>
</div>
<p>Would generate a human readable sentence like this:</p>
<div class="highlight-python"><div class="highlight"><pre>A displaced person should be provided with 2.8
kilogram/kilograms/kg of rice.
Though no less than 0 and no more than
100. This should be provided daily.
</pre></div>
</div>
<p>Once you have populated the resource elements, click the <em class="guilabel">Save
resource</em> button to return to the profile view. You will see the new resource
added in the profile&#8217;s resource list.</p>
</div>
<div class="section" id="managing-profiles">
<h2>Managing profiles<a class="headerlink" href="#managing-profiles" title="Permalink to this headline">¶</a></h2>
<p>In addition to the profiles that come as standard with InaSAFE, you can create
new ones, either from scratch, or based on an existing one (which you can
then modify).</p>
<p>Use the <em class="guilabel">New</em> button to create new profile. When prompted, give your
profile a name e.g. <a href="#id2"><span class="problematic" id="id3">:keyboard:`JakartaProfile`</span></a>.</p>
<p><strong>Note:</strong> The profile must be saved in your home directory under <tt class="file docutils literal"><span class="pre">.qgis2/minimum_needs</span></tt>
in order for InaSAFE to successfully detect it.</p>
<p>An alternative way to create a new profile is to use the <em class="guilabel">Save as</em>
to clone an existing profile. The clone profile can then be edited according to your specific needs.</p>
</div>
<div class="section" id="active-profile">
<h2>Active profile<a class="headerlink" href="#active-profile" title="Permalink to this headline">¶</a></h2>
<p>It is important to note, that which ever profile you select in the <em class="guilabel">Profile</em>
pick list, will be considered <strong>active</strong> and will be used as the basis for all
minimum needs analysis.</p>
</div>
</div>


        </div>
        <hr>
    </div>
</div>


    <div class="container">
        <div class="alert alert-info centered">
            Contact
            <a href="mailto:info@inasafe.org?subject=[inasafe-info]">
            <b>info@inasafe.org</b></a> for more information.
            Source code available on
            <a href="https://github.com/AIFDR/inasafe"><b>GitHub</b></a>!
            Please <a href="https://github.com/AIFDR/inasafe/issues"><b>
            file a ticket</b></a> if you have discovered an issue.<br>
            This document is licensed under a
            <a rel="license" href="http://creativecommons.org/licenses/by/3.0/au/deed.en_GB">Creative Commons Attribution 3.0 Australia License.</a><br>
            <a href="http://creativecommons.org/licenses/by/3.0/au/deed.en_GB"><b>CCByA</b></a>,
            Copyright 2014, Indonesian Government-BNPB, Australian
            Government-AIFDR and the World Bank-GFDRR.
        </div>
    </div>

    <div class="footer">
    </div>
  </body>
</html>
