Deploying New Facilities

Often in fuel cycle analysis, transition scenarios are considered. These ask questins like: “How does the commissioning and decommissioning of reactors affect electrity production or material transactions?”. Transition analysis will require an institution that can deploy additional facilities at given time steps: the cycamore DeployInst archetype. This is the simplest institution that can deploy new facilities, in which the user simply defines the times at which new agents should be deployed as copies of available prototypes.

In this case, we will keep the current institutions and add another institution that will deploy more facilities over time.

Example: DeployInst

The DeployInst archetype must be added to the <archetypes> block of the input file:

<archetypes>
  ...
  ...
  <spec> <lib>cycamore</lib><name>DeployInst</name> </spec>
</archetypes>

Recall: in Adding a Second Reactor we left a blank spot in between our </institution> and </region> handles. We will now use this to add the institution for DeployInst.

DeployInst takes the form:

where:

  • prototype: Ordered list of prototypes to build
  • build_times: Time step on which to deploy agents given in prototype list
  • n_build: Number of each prototype given in prototype list to build

Activity: Add a New Institution

Using the table below and the DeployInst template above, fill out the commodities template.

Prototype | build_times | n_build
UraniumMine | 1 | 1
FuelFab | 1 | 1
1178MWe BRAIDWOOD-1 | 2 | 1
1000MWe Lightwater-1 | 3 | 1

Using the prototype facilities already created, the new institution should look like the following:

<institution>
  <name>ExampleInstitution</name>
  <config>
    <DeployInst>
      <prototypes>
        <val>UraniumMine</val>
        <val>FuelFab</val>
        <val>1178MWe BRAIDWOOD-1</val>
        <val>1000We Lightwater-1</val>
      </prototypes>

      <build_times>
        <val>1</val>
        <val>1</val>
        <val>2</val>
        <val>3</val>
      </build_times>

      <n_build>
        <val>1</val>
        <val>1</val>
        <val>1</val>
        <val>1</val>
      </n_build>
    </DeployInst>
  </config>
</institution>

The above institution will create 1 UraniumMine and 1 FuelFab facility on time step 1. The next time step will deploy the 1178MWe BRAIDWOOD-1 reactor prototype. And finally, at time step 3, the 1000We Lightwater-1 will be deployed. This institution block goes inside the Region block, with the previously created insitutions blocks.

ExampleInstitution is a placeholder for your institution name, and in this scenario only one of each prototype will be deployed since n_build has a value of 1 for each.

This example is now complete. Save your file as the desired file name (with .xml extension) and run your code through Cyclus. If your simulation runs into errors, sample files can be found here under input_deployinst.xml or ouput_deployinst.sqlite.