Editing Screw pump

{{migrated article}}
{{Quality|Unrated}}
{{av}}
{{V50 machine|name=Screw pump|key=p|job=[[Pump operator]]
|icon=[[File:screw_pump_icon.png]]
|construction=
* [[Block]]
* [[Trap component#Enormous corkscrew|Enormous corkscrew]]
* [[Pipe section]]
|construction_job={{Template:Material-specific building labors}}
|power=Needs 10 power.
}}

A '''screw pump''' is a small [[building]] that can lift liquids ([[water]] or [[magma]]) from one level below onto the same [[Z-level]] as the pump. It is two tiles by one tile in size, and it can be either manually operated by a [[dwarf]] allowed to do the the [[pump operator|pump operating]] work (by default there is no [[work detail]] for this [[labor]], and everyone is allowed to do it) or by being [[power]]ed by [[water wheel]]s and/or [[windmill]]s. A screw pump both accepts and transfers power using either tile of the pump, in all orthogonal directions, including above and below.

A screw pump has two sides. One side is the "input" side which accepts dwarven labor from the [[pump operator]], and which obtains the fluid that the machine will pump. The other side is the "output" side, which outputs the fluid being pumped. In previous versions of ''Dwarf Fortress'', the input side showed up as a light-colored tile, and the output side was a dark-colored tile, which will likely be a method of differentiating the two sides that you will encounter in descriptions and illustrations. In v50 a screw pump's orientation will be displayed by clicking on the pump. In the premium edition of ''Dwarf Fortress'' (v50), a pump has detailed graphics, which visually shows the orientation of the pump. The input side has many gears, and the output side has jutting pipes.

The direction you want the fluid to travel must be chosen at the time of construction. Pumping only occurs in a straight line, and involves a total of 4 tiles in a row - 1) the liquid source, two for the pump, and the output (details below, under Construction).

The "rise" in levels occurs on the first tile, the intake side, from one level below up to the level of the pump. Pumped fluids can and will flow immediately after being pumped, as normal for that fluid. Pumped fluids will have a [[pressure]] equal to the exit [[z-level]] - a pump never "forces" water to a higher [[z-level]] than the output tile.

[[Water#Salt Water|Salt water]] pumped through a pump will desalinate and become drinkable, but only if the [[cistern]] has never contained salty water. [[Water#Stagnant Water|Stagnant water]] pumped through a pump will become clean, letting dwarves drink it without getting an unhappy [[thought]] and letting [[doctor]]s clean [[wound]]s without causing an [[Health care#Infection|infection]]. As with desalination, this only works if the [[cistern]] has never contained stagnant water.

''For a basic overview of how the different machine parts work and work together, see [[machine component|machinery]].''

== Construction ==

Building a screw pump requires an [[Trap component#Enormous corkscrew|enormous corkscrew]], a [[block]], and a [[pipe section]]. These can be made of any material if the pump is intended to move water, but each component must be [[magma-safe]] if the pump is to be used to move [[magma]]. As with construction of other buildings, a dwarf first brings all materials to the planned site, then construction can begin. Both bringing the materials and the construction labor requires that the dwarf is allowed to do [[carpentry]], [[metalsmithing]], or [[masonry]], depending on the material of the block. The constructing dwarf will finish the labor by standing on the input side of the pump, and so  will require access to that tile. Deconstructing a screw pump requires the same labor as it took to construct it.

[[Image:Small pump.jpg|thumb|right|300px|'''Basic Side View of a Pump'''. <br /> This pump "pumps from the west to east", flowing from left to right. The area to the right may fill to the top of that level, but no more  (See [[pressure]]; see [[Screw pump#Pump stack|Pump stack]]). Note that the entire space required is 4 tiles long by 1 tile wide, not including any retaining walls for the outflow. If pumped manually, the [[pump operator]] stands in the input side, as the output tile is [[impassable tile|impassable]] to both fluid and movement.<br /><br />''(Although the "liquid" is shown as blue, this can work for [[magma]] as well, with the [[magma-safe|appropriate precautions]].)'']]

Although the screw itself is only 2 tiles long by 1 tile wide, the entire system must be thought of as 4 tiles long (see diagram, "Basic Side View of a Pump", right). This consists of (left to right)... 1) a liquid-source tile (where the liquid is, -1 z-level below), 2) the input end of the pump itself, 3) the output end of the pump, and 4) the tile where the liquid will be deposited, which is on the <u>same level</u> as the pump.

It's easily possible to allow that output liquid to drain away to lower z-levels, but it ''starts'' on the same level as the pump, 1 z-level above where it started. It's also possible to use walls to prevent the liquid from spreading, and this is recommended if you do not have a reliable drain system.

To build a pump, open the {{k|b}}uild menu, select {{k|m}}achines/fluids and then Screw {{k|p}}ump. It's important to choose the proper orientation for your pump (to specify the source and destination tiles) using the sub-menu that appears in the upper-right of the screen. In Dwarf Fortress Classic v50, the arrows on this menu point in the direction of the source of the pump's fluid, not in the direction the fluid will be pumped (for instance, if you click on the →→ symbol, the machine will be built to pump from east to west). These same buttons in Dwarf Fortress Premium show an icon that more intuitively displays the movement of fluid by the machine, and are in an opposite layout. The default (as shown above in the sidebar), "pumps from the north", which is the center-bottom button in Dwarf Fortress Premium, and the center-top option in Dwarf Fortress Classic. When clicking the map to choose a location for a pump, the tile you select will be the output side of the pump.

If pumped manually, the pump operator stands on the input tile, as the output tile is [[impassable tile|impassable]]. After construction is complete, orientation of the pump will be displayed by clicking on the pump. Orientation of a pump cannot be changed after being constructed, but, as with any building, it can be deconstructed into its component parts and rebuilt with a new orientation, and/or a new location.

Having specified the direction of travel, you must ensure that the source side of the pump is placed adjacent to and above (in the [[z-axis]]) a liquid. That end of the pump is '''not''' directly over the source - it is one level above but <u>adjacent</u> to it. The screw pump will draw the liquid up from below its level, and distribute it out of the other side of the pump.

Construction of a screw pump can be prohibited with a "needs screw trap component" message if your enormous corkscrews are in a bin which has ''any'' current tasks attached to it (such as the relocation of a newly constructed corkscrew, or a military member moving a weapon). One workaround is to create a separate weapon stockpile for your corkscrews, and for best effectiveness, disallow the use of bins in that stockpile. This will force your corkscrew storage to work as smoothly (and space-consumingly) as a furniture stockpile.

== Notes ==
* Dwarves must be able to access and stand on the input tile of the pump in order to build the pump and then to be able to operate the pump manually.
* Liquids to be pumped must be 1 level below the (empty) area ''adjacent'' to the input tile. 
* The space above the fluid source cannot be a floor, stairway or wall. Screw pumps can pull water through a [[grate]], floor [[bars]], or a [[construction|constructed]] [[fortification]] on the Z-level below.
* Liquids will appear in the tile adjacent to the output side of the pump.
* The output tile blocks liquid flow and creature movement, and can be built between wall segments to create a solid barrier. The input tile of the pump does not block flow or movement.
* Pumps can also be used in conjunction with a [[water wheel]] or a [[windmill]] to become powered by these machines, rather than by a dwarf.
* Actively-powered mechanisms connected to either pump tile will automatically start the pump; to prevent this, either restrict liquid flow using floodgates or hatches, or build a [[gear assembly]] linked to a [[lever]] to disconnect the [[power]].
* If a pump is powered, the pump will also output power to connected machines ([[gear assemblies]], [[axle|axles]], other pumps, etc.).
* Adjacent pumps ''automatically'' transfer mechanical power to any other adjacent pump(s); no [[axle]] or [[mechanism]] is required.  If too many pumps are adjacent, there may be insufficient power to power them. In this case, ''all'' pumps (and other items) connected to that power network will fail to work. By clicking on a powered pump, axle, gear assembly, windmill, or water wheel you can see the "Total Power" and "Total Power Needed" in the system.
* Dwarves operating pumps do '''NOT''' generate power. Thus, one cannot use a single [[pump operator]] to power an entire [[pump stack]] or anything else that accepts or transfers power.
* In order to build pumps in a "hanging" state, as in the stacked screw pump example (below), one of its tiles must be able to connect to a nearby machine, either already existing or designated to be built. If, when the screw pump's construction is completed, the supporting mechanism has not yet been completed, it will promptly collapse into its component parts.
* Pumps do '''not''' push liquids '''up''' additional Z-levels above them.  They only deliver water to their own level.  That is, if you direct the output of a screw pump into a 1-square space surrounded by walls, the water will not "overflow" the walls. Consequently, a pump will refuse to move liquid if the level it is pumping to is completely filled.  Higher levels can be achieved using a "pump stack" (below). (See [[Pressure]])
* In order to safely pump magma, you must use [[magma-safe]] materials, though magma-unsafe metals have been observed to be safe unless the input tile is going to be submerged in magma. Wooden parts (except for [[nether-cap]]s) will burst into flames the instant the pump is activated, and magma-unsafe stone [[block]]s melt after a short time. Despite the requirement for magma-safe materials, the exterior of the pump does not heat up, and dwarves do not mind operating a magma pump directly.
* Magma, which normally has no pressure, will behave as though pressurized when pumped. For example, when pumped into a U-turn, magma will come out at the other end. Normal (non-pumped) magma would just pool at the lowest level. This may be either very useful (can be used to build pressure towers for magma) or deadly (forge level flooded with magma, because someone tried to pump magma into a volcano).
* Pump's pseudo-pressure doesn't work across diagonals. If there is a diagonal-only passage in your tunnel, liquids will seep slowly through it, instead of bursting through above their normal maximal speed, like they would if there was a clear orthogonal passage.
* The liquid in a pump's intake tile must have a depth of at least 2/7 for the pump to be able to remove any amount of liquid from it.
* If a pump's intake tile on the z-level below the pump becomes blocked (e.g. cave-in, magma cooling into obsidian, or a sapling maturing into a [[tree]]) the pump will still run but not pump any fluid.
* If a pump's output tile contains magma and the pump is pumping water or vice versa, the output tile will be turned into [[obsidian]].
* Pumps operate in the reverse order in which they were built-- the most recently built will try to pump, then the next recent, and so on.  You can use this to your advantage for [[mist]] generation, to maximize fluid throughput, or for advanced [[repeater]] design.
* Screw pumps continue to operate for a short period (49 ticks) after losing power-- that is, a screw pump supplied power for exactly 1 tick will actually pump for 50 ticks.
* Screw pumps attempt to pump everything from the inlet tile to the outlet tile on every turn (so long as there is more than 1/7 liquid in the square).  Actual pump rate tends to be slower than this due to liquid needing to flow to the pump inlet, which can take a few turns depending on the source.
* In previous versions, in [[Adventure mode]], if you bring your adventurer to a site with working pumps, the pumps would run as long as you were close enough to the fortress, but once you moved far enough away, the site got offloaded, causing the pumps to stop. 

====Common mistakes====
* Orienting a pump incorrectly, and/or not having a proper open liquid source.
* Pumping water into an area with a path to other parts of your fortress. (The pump may work perfectly - the fortress quickly [[flood]]s.)
* Expecting water to rise up above the level of a pump.
* Building a wall attached only to the input tile - this leaves a diagonal leak between the wall and the output tile unless sealed there.  (If that's not a problem, don't worry about it.)
* Having stairs in the liquid of the intake tile. Stairs block the intake tile, thus rendering the pump useless, even though liquids usually ignore stairs. The liquid output tile can be any liquid-passable tile.
* Not channeling below the [[impassable tile]] of an individual pump in a pump stack. This is how power is transmitted to the pump below.
* Pumping magma into a lower z-level (same as the source) and then being surprised it is forced back up to the pump's z-level further down the line (where you were planning your magma forges, for example.)

== Example layouts ==
=== Single pump ===

[[Image:jt_screwpump.png|frame|left|This screw pump delivers water (or magma) from the lower level (on the right in this diagram) to the same z-level as the screw pump (on the left). When placing the screw pump to be built, the output tile would be on the left - that entire tile is impassible to movement and fluids.]]<br style="clear: both"/>

=== Pump stack ===
[[File:PumpStack2010.png|thumb|right|300px|'''Illustrated Side View of a Pump Stack.''']]
[[File:PumpStackTopView.png|thumb|right|300px|'''Illustrated Top View of a Pump Stack Layer.''']]
[[File:Pumpstack.gif|thumb|right|'''Animation showing the general construction.''']]

A pump stack is a method used to draw water or magma vertically across multiple z-levels requiring a minimum of parts. The basic functionality is possible because the output side of the pump can be built over open space with a machine component located directly below, in this case another screw pump. Note that for power to properly transfer, the input side of the pump must line up with the output side of the pump on the floor above it through a space in the floor, as in the illustration. While pumps can transfer power to and from either tile, you need flooring below the pump's input side, because that's where the dwarf stands to construct the pump.

A pump stack minimizes the amount of machinery required to lift water or magma by allowing for power to be supplied directly to only the most accessible pump (typically the topmost) which in turn allows the player to operate a stack limited only by how many windmills/water wheels they can fit into the area. The price of optimal parts density is fragility: each pump relies on the pump below it for support. If [[forgotten beast|anything]] breaks a pump in your stack, every pump above it will be disassembled. This means that a single pump accidentally assembled with non-[[magma-safe]] parts can cause an entire magma pump stack to spontaneously disassemble. 

To prevent such a disassembly cascade, you can "anchor" each pump with a mechanism or stable horizontal axle. For water applications, placing this axle on the output tile of the pump also conveniently prevents plant growth; for magma applications, the axle must be protected from the magma, unless you are using [[nether-cap]].

Typical applications for a pump stack include moving magma from a lower level (often the [[magma sea]]) up to a convenient level for forges and furnaces, extracting water from a flooded fort, raising water for a decorative [[waterfall]] (and extracting it afterwards), or any other purpose that requires water/magma on a z-level significantly above its current location.  

The 'Illustrated Top View of a Pump Stack Layer' shows a basic section of a pump stack. Only the door (or a floodgate) on the containment side is strictly necessary in order to prevent flooding. Two doorways are used here, each lining up with the solid ground within the pump assembly, in order to prevent workers from trapping themselves after digging channels or assembling the pump.

Be warned: pump stacks move water '''fast.''' If you are pumping from a large reservoir into an open area, be prepared for a huge outflow, roughly akin to the kind of water dump you'd get if the whole reservoir was balanced above the pump output and then released. If you are using pumps to empty a large underground reservoir (or, say, a flooded fortress) onto open land, use an aqueduct or some other method to make sure the pump system outlet is a good distance away from anything you wouldn't want to get drenched.

As an alternative to a large reservoir, it is also possible to combine a [[Dwarven Atom Smasher]] with the top layer of the pump stack to create a "vacuum cleaner" of sorts.

====Tips====

* Ramps can be used in place of channeling. Liquids will transmit through ramps, unlike stairs, and when pumps are constructed they annihilate the ramp they're built on much as walls do. Power will still be transmitted, so they don't need to be removed by miners prior to pump construction. Ramps make it virtually impossible to strand your miners and allow the stack to be dug out using only access doorways on the input side of the pump, so no construction or doors are later needed to eliminate leaks. A pump stack can be very rapidly carved out with this method as even if a miner/builder is trapped on the containment side of a pump, they can walk up the ramp to the intake side of the pump above and walk out.
* Power can be transmitted to the stack by channeling out the tile directly above the topmost pump and mounting a gear assembly. If the gear assembly is supported by an adjacent gear assembly or horizontal axle on a stable floor (be careful to not have that adjacent gear assembly disengage via lever), this will allow the stack to hang from the gear assembly. If a lower pump needs to be removed, or should self-destruct, the problem of the entire pump stack disassembling described above is eliminated. Further, if the supported gear assembly is built first, the pump stack can be built both from the top and bottom simultaneously, halving construction time, assuming that sufficient attention is paid to make sure that the pumps will align with the proper orientation when the two partial stacks meet. Properly channeling/ramping out the stack should ensure this.
* While expensive in both power and mechanisms, it is also possible to power a pump stack horizontally with a gear assembly or power source connected directly to the side of the pump (preferably to the input side). This is most useful when you are building an above ground pump stack. You can attach an axle or gear assembly to the side or end of the screw pump's output tile, but it's generally not a good idea because they do not block fluids, which would allow the pump's outlet fluid to leak along a diagonal. Unless that's your plan.
* When pumping water, make sure all tiles on the containment side of the stack are covered with a [[ramp]], [[road]], or [[fortification]] to prevent subterranean trees from growing and blocking flow of the stack. Fortifications have the added advantage that, when used with water, they will never become muddy.
* When using pumps to empty a large body of liquid, make sure that the pump outlet is properly isolated from the intake, otherwise the liquid can flow backwards into the pump's walkable tile and cause problems (such as flushing the dwarf operating it into the body of liquid being drained).
* The order in which the screw pumps were constructed matters. If built from lowest to highest, they will be able to transfer liquids one z-level per tick. However, if built from highest to lowest, they will transport liquids all the way from the bottom to the top in just one tick.

===Improved magma pump stack===

Because a pump stack pumping magma is known to cause significant [[Maximizing_framerate|lag]], a [http://www.bay12forums.com/smf/index.php?topic=72296.0 new type of pump stack] was developed by [http://www.bay12forums.com/smf/index.php?action=profile;u=19835 NecroRebel] that causes a much smaller drop in [[FPS]].  Changing the single tile magma chamber at the output of every pump from a 1 x 1 to a 3 x 3 area reduces the lag to 1/15th of that caused by the original pump stack. The designer hypothesizes that the larger chamber requires many fewer temperature calculations when magma is pumped in or out; that also implies that there will be no FPS improvement for water pumps by using this design.

====Newer magma pump breakthroughs====

Newer breakthroughs in magma pump design have since made the 3x3 reservoir design obsolete.
Testing has found a [http://www.bay12forums.com/smf/index.php?topic=72296.msg1772802#msg1772802 1x3 head-over-tail variation] (which is very similar to [[Screw_pump#Pump_stack|the typical 1 by 1 pump stack]]) as well as a [http://www.bay12forums.com/smf/index.php?topic=72296.msg1795907#msg1795907 2x3 head-over-head variation]. Both of these new designs require less space and work as effectively as his original 3x3 reservoir head-over-head design, with no significant drop in FPS. The 1x3 head-over-tail design has the advantages of requiring the least amount of space and being simple to refit from the standard 1 by 1 water pump stack.

{{d for dwarf}}
:From the components used in construction, a DF pump can be imagined as a simple [http://en.wikipedia.org/wiki/Archimedes%27_screw archimedes screw]. However, given its effect on contaminated water, the lack of pump components *in* the water itself, and general dwarven mechanical aptitude, it seems more accurate - and more dwarfy - to infer the speed of rotation to be high enough that the building actually operates as a [http://en.wikipedia.org/wiki/Turbomolecular_pump turbopump] using the principle of [http://en.wikipedia.org/wiki/Vacuum_distillation vacuum distillation] to simultaneously transfer and purify water. Some Dwarven historians say that ancient screw pumps were also used as a torture device used to interrogate [[goblins]] and [[elves|hippies]].

[[File:Schroef van Archimedes.jpg|thumb|300px|center|A modern era screw pump, though still mechanically different than the game's.]]
{{buildings}}