<!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/xhtml;charset=UTF-8"/> <title>Frepple / Load </title> <link rel='stylesheet' href='../styles.css' type='text/css' /> <!--PageHeaderFmt--> </head> <body> <div id="container"> <div id="menubar"> <div id="logo" align="center"> <br/><img src='../frepple.bmp' alt="frepple" /><br/> <a href='http://www.frepple.com/'> <strong>a Free<br/>Production Planning<br/>Library</strong> </a></div> <div id="menu"> <br/> <h3><a href='../Main/HomePage.html'>Main</a></h3> <h3><a href='../UI/Main.html'>User Manual</a></h3> <h3><a href='../Tutorial/Main.html'>Tutorial</a></h3> <h3><a href='Main.html'>Reference Manual</a></h3> <h3><a href='../Main/FAQ.html'>FAQ</a></h3> <h3><a href='../reference/index.html'>C++ API</a></h3> <br/><div> </div> </div> </div> <div id="content"> <br/> <!--PageText--> <div id='wikitext'> <p><a class='wikilink' href='../Main/HomePage.html'>Main</a> > <span class='wikitrail'><a class='wikilink' href='Main.html'>Reference Manual</a> > <a class='wikilink' href='Modeling.html'>Modeling</a> > <a class='selflink' href='ModelingLoad.html'>Load</a></span> </p> <p class='vspace'>Loads are used to model the capacity consumption of an operation. </p> <div class='vspace'></div><h2>Fields</h2> <table border='1' width='100%' ><tr><td width='20%' valign='top'><strong>Field</strong> </td><td width='20%' valign='top'><strong>Type</strong> </td><td width='60%' valign='top'><strong>Description</strong> </td></tr><tr><td valign='top'>resource </td><td valign='top'>resource </td><td valign='top'> <p>Resource being loaded.<br />This is a required field. </p></td></tr><tr><td valign='top'>operation </td><td valign='top'>operation </td><td valign='top'> <p>Operation loading the resource.<br />This is a required field. </p></td></tr><tr><td valign='top'>quantity </td><td valign='top'>double </td><td valign='top'> <p>Load factor of the resource.<br />The default value is 1.0. </p></td></tr><tr><td valign='top'>effective_start </td><td valign='top'>dateTime </td><td valign='top'> <p>Date after which the resource load is valid.<br />Before this date the planned quantity is always 0. </p></td></tr><tr><td valign='top'>effective_end </td><td valign='top'>dateTime </td><td valign='top'> <p>Date at which the resource load becomes invalid.<br />After this date (and also at the exact date) the planned quantity is always 0. </p></td></tr><tr><td valign='top'>priority </td><td valign='top'>integer </td><td valign='top'> <p>Priority of the load, used in case of alternate load.<br />The default is 1. Lower numbers indicate more preferred loads. </p></td></tr><tr><td valign='top'>name </td><td valign='top'>non-empty string </td><td valign='top'> <p>Optional name of the load.<br />A name is only useful when using alternate loads. Otherwise leave it empty to save some memory. </p></td></tr><tr><td valign='top'>alternate </td><td valign='top'>non-empty string<br />or<br />load </td><td valign='top'>Name of the load of which this is an alternate.<br />When using the Python API the argument can be a load or a string.<br />When using the XML data format the argument is a string. </td></tr><tr><td valign='top'>setup </td><td valign='top'>non-empty string </td><td valign='top'>Name of the required setup on the resource. </td></tr><tr><td valign='top'>search </td><td valign='top'>string </td><td valign='top'> <p>Defines the order of preference among the alternate loads.<br />The valid choices are: </p><ul><li>PRIORITY<br /> Select the alternate with the lowest priority number.<br /> This is the default. </li><li>MINCOST<br /> Select the alternate which gives the lowest cost.<br /> The cost includes the cost of all upstream operations, resources and buffers. </li><li>MINPENALTY<br /> Select the alternate which gives the lowest penalty.<br /> The penalty includes the penalty of all penalties incurred in the upstream plan along the flow. </li><li>MINCOSTPENALTY<br /> Select the alternate which gives the lowest sum of the cost and penalty.<br /> The sum is computed for the complete upstream path. </li></ul></td></tr><tr><td valign='top'>action </td><td valign='top'>A<br />C<br />AC (default)<br />R </td><td valign='top'> <p>Type of action to be executed: </p><ul><li>A: Add an new entity, and report an error if the entity already exists. </li><li>C: Change an existing entity, and report an error if the entity doesn't exist yet. </li><li>AC: Change an entity or create a new one if it doesn't exist yet. </li><li>R: Remove an entity, and report an error if the entity doesn't exist. </li></ul></td></tr></table> <div class='vspace'></div><h2>Example XML structures</h2> <ul><li>Defining a load </li></ul><pre> <plan> <loads> <load> <resource name="machine A"/> <operation name="operation B"/> </load> </loads> </plan> </pre><div class='vspace'></div><ul><li>Defining a load nested in an operation structure.<br /> Resources A AND B are used by the operation. </li></ul><pre> <plan> <operations> <operation name="operation B"> <loads> <load> <resource name="machine A"/> <usage>1</usage> </load> <load> <resource name="machine B"/> <usage>1</usage> </load> </loads> </operation> </operations> </plan> </pre><div class='vspace'></div><ul><li>Defining a load nested in an operation structure.<br /> Resource A OR B is used by the operation. </li></ul><pre> <plan> <operations> <operation name="operation B"> <loads> <load> <resource name="machine A"/> <usage>1</usage> <priority>0</priority> <name>alt</name> </load> <load> <resource name="machine B"/> <usage>1</usage> <priority>1</priority> <alternate>alt</alternate> </load> </loads> </operation> </operations> </plan> </pre><div class='vspace'></div><ul><li>Defining a load nested in a resource structure </li></ul><pre> <plan> <resources> <resource name="machine A"> <loads> <load> <operation name="operation B"/> <usage>2</usage> </load> <load> <operation name="operation C"/> <usage>1</usage> </load> </loads> </resource> </resources> </plan> </pre><div class='vspace'></div><ul><li>Deleting a load </li></ul><pre> <plan> <loads> <load action="R"> <resource name="machine A"/> <operation name="operation B"/> </load> </loads> </plan> </pre> </div> <!--PageFooterFmt--> <!--HTMLFooter--> </div></div> </body> </html>