Editing Containment

{{Anomaly}}
{{Stub|reason=General, but also interlinking, categories, etc. containment affects study rate? }}
{{Rewrite|reason=Formatting and sections}}

'''Containment''' refers to the process of capturing, imprisoning, and exploiting [[Entities]].

== Summary==
Containment is the desired end result when encountering Entities.  Colonies can hold entities on a [[Holding spot]] or a [[Holding platform]], the latter of which requires research and steel to build.  Once contained, entities can be researched or regularly harvested for resources or power.

Only creature entities are placed on holding platforms.  Item entities, such as the Cube, can be hauled around and placed in stockpiles - having an important stockpile dedicated to entities may be a good idea.  Building entities, such as the Monolith, must be studied in their current location, as none of them are mobile.  Be careful about integrating them into your base designs as they may be a source of risk down the road.

=== Containment strength ===
{{Stub|section=1|reason=Requires the exact impact of these factors, in terms of specific numbers}}
Any containment room is subject to containment breaches, the equivalent of prison breaks for entities. The containment strength of the room can be viewed by clicking on the platform. Containment is the sum of the following factors:

*'''Average Wall HP/10''' (e.g all wooden walls have 195 hp and will result in {{+|19.5}} containment)
*'''Average Door HP/5''' (an open door provides {{--|0}} containment)
*'''Average [[Environment#Light|light level]]/10''' (realistically limited to {{+|5}} through use of normal lights)
*[[bioferrite plate|Bioferrite plate]] flooring provides up to {{+|15}} Containment at 100% room coverage
*[[Roof|Unroofed]] containment rooms apply a {{--|30}} containment penalty
*[[Holding spot|Holding Spots]] modify the resulting containment for their specific spot by {{Bad|x70%}} 
*Each additional Holding Platform inflicts a roughly {{--|10%}} exponential cumulative penalty to all holding platforms in the same room. <!-- The cumulative remaining containment percentage of x platforms is roughly given by the exponential curve of y=111*e^(-.11*x), but I am unsure of how to present this information in a pretty and accurate manner and I've been at this edit for over two hours primarily trying to find out this info and I need to stop looking at spreadsheets... -Vilobion -->
*An [[Electric inhibitor]] increases containment by {{+|10}}
*A [[Shard inhibitor]] increases containment by {{+|20}}
*An [[Electroharvester]] lowers containment by {{--|25}}
*A [[Bioferrite harvester]] lowers containment by {{--|15}}

The walls and doors that make up the containment room contribute to containment strength based on the combined average of their {{HP}}, with stronger materials (e.g: [[granite]] or [[plasteel]]) having a higher contribution. Naturally occurring walls with HP greater than naturally occurring granite have their containment strength clamped. This relies on the structures' current HP, not their maximum HP, meaning that having damaged walls or doors will result in a lower containment strength. This effect only applies to fully enclosed rooms. If any door is held open too long, the room will no longer be considered enclosed. [[Holding spot|Holding Spots]] and [[Holding_platform|Holding Platforms]] should be placed with a 1-tile gap from doors to prevent colonists from triggering spurious insufficient containment warnings by keeping doors open while interacting with void entities.

Larger and more dangerous entities generally require more containment strength.  An entity can be held in a weak cell just fine in the short term, it simply increases the rate at which they will break out.  As a general rule, the average frequency of breaches for entities that are sufficiently contained is measured in years, while the frequency of those insufficiently contained are measured in days.  This is still likely to be enough time for an unprepared colony to quickly set up an adequate cell.

The size of the cell does not affect containment strength.  Note that storing multiple entities in the same room will increase the required containment strength.  This may still be worthwhile for harvesting certain resources more efficiently.

An entity incapable of moving will never breach.  This includes entities with broken spines, or entities with destroyed legs and insufficient arm strength.  Such entities can even be held outside in a holding spot without any risk, and are a useful resource to a colony.

Although possible, surrounding a containment spot with doors results in lower containment strength than using a room with both walls and doors.

===Material Comparison===
The following table is for roofed containment cells with walls and a single door made completely out of the listed material, with a separate column for containment cells with walls of the listed material and a security door instead of a single door of the given material. The listed values include no bonuses for flooring, lighting, or containment boosting buildings, and are for containment rooms with a single [[Holding platform]].
{| class="wikitable"
! Material !! Containment Strength !! With Security Door !! Material !! Containment Strength !! With Security Door
|-
! [[Wood]]<br/>[[File:wood.png|42px]] || style="text-align:right;" | 40 || style="text-align:right;" |  180 ||  [[Steel]]<br/>[[File:steel.png|42px]] || style="text-align:right;" | 62 || style="text-align:right;" |  190
|-
! [[Sandstone]]<br/>[[File:Sandstone_blocks.png|42px]] || style="text-align:right;" | 87 || style="text-align:right;" |  202 || [[Granite]]<br/>[[File:Granite_blocks.png|42px]] || style="text-align:right;" | 105 || style="text-align:right;" |  211
|-
! [[Limestone]]<br/>[[File:Limestone_blocks.png|42px]] || style="text-align:right;" | 97 || style="text-align:right;" |  207 || [[Marble]]<br/>[[File:Marble_blocks.png|42px]] || style="text-align:right;" | 74 || style="text-align:right;" |  196
|-
! [[Uranium]]<br/>[[File:Uranium.png|42px]] || style="text-align:right;" | 155 || style="text-align:right;" |  235 || [[Plasteel]]<br/>[[File:Plasteel_c.png|42px]] || style="text-align:right;" | 174 || style="text-align:right;" |  244
|-
! [[Bioferrite]]<br/>[[File:Bioferrite_b.png|42px]] || style="text-align:right;" | 132 || style="text-align:right;" |  220 || [[Silver]]<br/>[[File:Silver.png|42px]] || style="text-align:right;" | 43 || style="text-align:right;" |  181
|-
! [[Gold]]<br/>[[File:Gold.png|42px]] || style="text-align:right;" | 37 || style="text-align:right;" |  178 || [[Jade]]<br/>[[File:Jade.png|42px]] || style="text-align:right;" | 31 || style="text-align:right;" |  175
|-
|}

===Escape Interval===
The chance an entity will escape is determined by their escape interval. Each entity has a base escape interval (specified as a mean time between in days).

The entity cannot escape if:
* Their base escape interval is zero or negative. Entities incapable of escaping are:
**{{Icon small|Nociosphere}} [[Nociosphere]]
**{{Icon small|Fleshmass nucleus}} [[Fleshmass nucleus]]
* The entity is incapable of moving (missing legs or incapacitated).

The base escape interval is then further modified by:
* '''Entity's moving capacity'''
** It is multiplied by (10000 / Entity's Moving Capacity)%
** The moving capacity is clamped between 1 and 100%
** For example, at 70% moving it'll be (10000 / 70) = 143% (rounded up)
** At 100% moving, it'll just be (10000 / 100) = 100%, meaning it'll not affect the escape interval
* '''Days in captivity'''
** At 15 days or less, it doesn't affect it at all (multiplies it by 100%)
** At 60 days, it multiplies the escape interval by 120%
** At 120 days, it multiplies the escape interval by 150%
** At 240 days or more, it multiplies the escape interval by 200%
** It scales linearly between the values
* '''Containment strength minus entity's minimum containment strength''' (so if an entity needs 30 and the containment is 50, the value is 50 - 30 = 20)
** Below 0 strength multiplies the escape interval by 5% (lowers it significantly)
** At 0, it doesn't affect it at all (multiplies it by 100%)
** At 100, it multiplies it by 300%
** At 200 or more, it multiplies it by 800%
** It scales linearly between the values
* '''Temperature'''
** At 0°C and above, it doesn't affect it at all (multiplies it by 100%)
** At -30°C and below, it multiplies the escape interval by 150%
** It scales linearly between the values
** Affected entities:
***{{Icon small|Fingerspike}} [[Fleshbeasts]]
***{{Icon small|Shambler}} [[Shambler]]s
***{{Icon small|Ghoul}} [[Ghoul]]s

=== Containment facilities ===
There are a handful of facilities that can be constructed alongside holding spots or platforms. Some facilities help to make entities easier to contain, while others allow you to exploit entities for resources.
{| class="wikitable"
! Building !! Research !! Cost !! Limit !! Effects
|-
! [[Electric inhibitor]]<br/>[[File:ElectricInhibitor east.png|128px]]
|| [[Research#Entity containment|Entity containment]] || {{Required Resources|Electric inhibitor}} || - 6 per holding platform<br/>- Max distance: 4<br/>- Min distance: 1<br/>- Must be pointed at platform<br/>- Requires line-of-sight || - {{+|10}} containment strength
|-
! [[Shard inhibitor]]<br/>[[File:ShardInhibitor.png|64px]]
|| [[Research#Entity containment|Entity containment]] || {{Required Resources|Shard inhibitor}} || - 1 per holding platform<br/>- Max distance: 5.9 || - {{+|20}} containment strength
|-
! [[Bioferrite harvester]]<br/>[[File:BioferriteHarvester east.png|128px]]
|| [[Research#Bioferrite harvesting|Bioferrite harvesting]] || {{Required Resources|Bioferrite harvester}} || - 1 per holding platform<br/>- Max distance: 5.9<br/>- Requires line-of-sight || - {{--|15}} containment strength<br/>- Produces [[bioferrite]]
|-
! [[Electroharvester]]<br/>[[File:Electroharvester south.png|128px]]
|| [[Research#Electroharvester|Electroharvester]] || {{Required Resources|Electroharvester}} || - 1 per holding platform<br/>- Max distance: 5.9<br/>- Requires line-of-sight || - {{--|25}} containment strength<br/>- {{Bad|x50%}} entity study rate<br/>- Periodically applies electrical burns to entities<br/>- Produces up to 2000W of power
|}

== Containment Effect on Dark Study ==
The amount of Dark Study gained while studying contained entities is affected by containment strength. In general, the higher the containment strength over the minimum containment level of the entity then the larger multiplier of Dark Study.

If the entity is contained at exactly the minimum containment required then Dark Study is not adjusted from the base value.

At containment levels below the required amount, Dark Study is multiplied by 50%.

At containment levels 100 above the required amount, Dark Study is multiplied by 130%. 

At containment levels 200 above the required amount, Dark Study is multiplied by 150%. This 50% additional Dark Study amount is the maximum value possible from containment.

In between minimum containment required and 200 additional containment the Dark Study multiplier is linearly interpolated.

{| class="wikitable"
| '''Dark Study Effectiveness'''
|-
| {{Graph:Chart|width=400|height=100|type=line|yAxisMin = 0 |xGrid =| yGrid=| xAxisTitle = Containment Above Entity's Requirement |yAxisTitle = Dark Study (%) |x=-50,-0.001,0,100,200,250|y=50,50,100,130,150,150}}
|}

== Analysis ==
Higher Containment values lower the frequency of entity escape attempts, making it worthwhile to maximize them:

* Use a [[Security door]] for an immediate gain of roughly {{Good|+160}} Containment. <!-- It's 160-(Previous door HP) -->
* Use the highest HP wall and door materials possible- which will generally be naturally occurring ore deposits, natural stone walls, Plasteel, Uranium, Bioferrite, and Granite, in that order.
* Ensure the rooms are lit and covered by a roof
* Avoid the {{Bad|30%}} containment penalty from using [[Holding spot]]s. Use [[Holding platform]]s instead.
* Use [[Bioferrite plating]] for flooring
* Do not keep entities with a high minimum containment stat in rooms with multiple holding platforms

Containment boosting buildings come with downsides- [[Shard inhibitor]]s require a [[Shard]] to construct, and [[Electric inhibitor]]s take up a lot of space and can only affect a single platform at a time. Shard Inhibitors are generally better suited for negating the penalties associated with [[Bioferrite harvester]]s and [[Electroharvester]]s or utilizing multiple platforms in a single room, while Electric Inhibitors are well suited for use with especially dangerous or annoying specimens (e.g: [[Revenant]]s).

===Maximizing Research Gains===
* Do not use Bioferrite Harvesters or Electroharvesters as they reduce containment and the Electroharvester also inflicts a {{Bad|-50%}} penalty to research gains.
* Do not use multiple holding platforms in a single room.
* Ensure the room is lit
* Consider having colonists use [[Voidsight serum]]

===Bioferrite Harvesting===
* Prioritize capturing [[Toughspike]]s, [[Gorehulk]]s, and [[Noctol]]s, which give good amounts of Bioferrite while still having low or managable minimum containment requirements, which makes them well suited to rooms with six holding platforms. None of them are particularly threatening in combat.
* [[Metalhorror]]s and [[Devourer]]s require very high minimum containment strength and are unlikely to survive frequent escape attempts.
* A [[Revenant]] that escapes is highly annoying. [[Trispike]]s and [[Bulbfreak]]s will split when damaged which is very annoying and reduces future bioferrite gain even if parts of them survive, which makes them poorly suited for Bioferrite harvesting. 
* Realistically Bioferrite Harvesters can only reach 6 Holding Platforms at once, which will decrease Containment. This can be partially offset by using a [[Shard inhibitor]].
* Even with marble walls, a lit containment room with six holding platforms, bioferrite flooring, and a shard inhibitor will reach ~130 containment, sufficient to give Noctols a prison break interval of roughly 2 years.

It is possible to use Hypothermia to render Toughspikes unable to move after frostbite destroys their limbs, which makes it impossible to escape regardless of containment strength. 

A downed a high-risk entity can be stored in a [[cryptosleep casket]] until a suitable containment cell can be constructed, if one is not available.

===Trivia===
The highest possible containment score is '''403.9''', possible only by having a roofed containment cell whose entirely made of unmined [[Plasteel]] ore, with a security door, bioferrite plating floors, six electric inhibitors, and a shard beacon- lit entirely by [[Sunlamp]]s. A healthy [[Metalhorror]], the entity with the highest containment requirements, would have a prison break interval of 8 years with such a setup.