Editing Plants

<!--Top Nav Box-->
{| align=center
! {{MainSection_Nav}}
|}
{| align=center
| {{Plants_Nav}}
|}
----
<!-- End Nav -->

{{TOCright}}
'''Plants''' come in varieties that are either cultivated or grow wild. Cultivated plants are planted by colonists in a [[growing zone]] or a [[hydroponics basin]], mainly for food. Wild plants grow naturally throughout the map. Some wild plants spread themselves via seeds. Animals mostly graze on wild plants but will happily eat cultivated crops as well, including tamed animals. Since Alpha 17, they leave [[filth|ash]] on the ground when burnt.

[[File:Plantation growing zone.png|500px]]


== Growth rate factors ==

===Fertility===
The medium used to grow the plants in matters for both for growth speed and if growing a plant is even possible in any given spot.

Most plants have a Fertiltiy requirement of at least 50%. However, most Trees come out with a measily 30% Fertility.

Most plants have a <fertilityFactorGrowthRate>, which is used to determine how "picky" a plant is about how fertile its terrain needs to be. Ingame this is also denoted as "Fertility sensitivity". A plant with a <fertilityFactorGrowthRate> of 0 will not care if it is planted on fertile soil or sand; it will grow at the same rate on any terrain tile that will accept its roots. In contrast, a plant with a <fertilityFactorGrowthRate> of 1 will not grow so well if it is planted on anything less fertile than standard soil.

'''Note''': Beyond 100% Fertility, high Fertiltiy Sensitivity becomes a bonus rather than a penalty. For such cases highly sensitive plants are preferable.

*Sand: 10%
*Stony soil and Marshy soil: 70%
*Soil and Lichen-covered dirt: 100%
*Rich soil: 140%
*Hydroponics: 280%

<big>{{math|''(GRF(F)) Growth Rate Factor(Fertility) {{=}} (Fertility &divide; 100% &minus; 1) &times; fertilityFactorGrowthRate + 1}}</big>

===Temperature===
For normal growth rate, plants require [[temperature]] between {{Temperature|10}} and {{Temperature|42}}. Plant growth rate drops by 10.0% for each degree Celsius below {{Temperature|10}}, and by 6.25% for each degree above {{Temperature|42}}. The plant's info window will show 'Non-ideal temperature. Temperature growth multiplier: #%'. Plants will not grow when the temperature falls below {{Temperature|0}} or rises above {{Temperature|58}}. The plant's info window will show 'Non-ideal temperature. Not growing.' If the temperature drops below {{Temperature|-10}}, the plant will either die or lose its leaves, depending on its type. This is obvious on trees, because it shows a new graphic with no leaves on it, but it actually applies to all plants, including grasses. Leafless plants are inedible by animals. This may cause problems to inexperienced players, as the game doesn't give a hint on why domesticated animals stop grazing and starve. Leafless plants cannot grow, and will take 24 hours to regrow their leaves after the temperature rises back above {{Temperature|-2}}.

The actual values of temperature and temperature growth multiplier are unseen real numbers, the game only shows rounded values. Thus, it is possible, for example, to see a 3% multiplier at 58°C (the actual temperature may be 57.52°C).

<big>{{math|''(GRF(T)) Growth Rate Factor(Temperature) {{=}} Temperature &divide; 10°C {{X|&nbsp;|15}}; Temperature < 10°C}}<br>
{{math|''(GRF(T)) Growth Rate Factor(Temperature) {{=}} 1 {{X|&nbsp;|44}} ; 10°C ≤ Temperature ≤ 42°C}}<br>
{{math|''(GRF(T)) Growth Rate Factor(Temperature) {{=}} (58°C &minus; Temperature) &divide; 16°C ; Temperature > 42°C}}</big>

===Light===
Most plants typically require at least 51% [[Environment#Light|light]] to grow.

Decorative Plants typically require at least 30% [[Environment#Light|light]] to grow.

In [[Modding|mods]], this minimum light value can be modified by changing a plant's <growMinGlow> value. When a plant lacks adequate light its info window indicates this with the text <tt>'Needs light level: ##%'</tt>. Over that minimum a plant's growth rate will increase until it reaches its optimal light level (100% standard). A plant's optimal light level can be modified by changing its <growOptimalGlow> value.

Most artificial light sources only provide 50% light. Only decorative plants can grown under such poor light conditions. The [[sun lamp]] provides 100% light in its radius, and is thus usually required for any indoor growing.

<big>{{math|''(GRF(L)) Growth Rate Factor(Light) {{=}} (Light &minus; growMinGlow) &divide; (growOptimalGlow &minus; growMinGlow)}}</big>

==Rest==
[[File:Plants-Growing_Time.png|right|thumb|Overview of the hourly plant activity.]]
All plants rest from hour 19 through hour 5. More accurately, plants rest for 11h of the day, leaving 13h of the day for growing.

During the plant resting time period, plants will not grow no matter the light level.

A new constant, Growing Ticks/Day, can be found by multiplying Ticks/Day by 13/24 (approx. 54.167%) :

<big>{{math|''Growing Ticks/Day {{=}} (60,000 Ticks/Day &times; 13/24) {{=}} 32,500 Ticks}}</big><br>
{{clr}}

==Initial growth==
All plants receive an instantaneous growth of 5% when sown (planted).<br>
This is relevant because it means that all plants only need to grow 95% from the moment they are sown to become fully grown (100%).<br>
You'll see this show up in a later equation as a new value: Growth Remaining<br>
You can use this value to help determine how long a plant has left before it is fully grown.<br>

<big>{{math|''Growth Remaining'' {{=}} 1 &minus; 0.05 {{=}} 0.95}}; Plant was just sown<br>
{{math|''Growth Remaining'' {{=}} 1 &minus; ''Current Growth'' &lt; 0.95}}; Plant was sown some time ago</big><br>

==Actual growth time==
The Growth Time displayed in-game can tend to confuse a player into thinking a plant will be fully grown in X number of days.<br>
Due to the various Growth Rate Factors (Fertility, Temperature, Light) and every plant's need to rest, the growDays or "Growth Time" listed in-game is not an accurate/intuitive representation of how long a plant actually takes to grow.<br>
For example: A Raspberry Bush (3:growDays), on Soil (1:Fert), experiencing optimal temperature and light 100% of the time (1:Temp, 1:Light), will take approximately 5.18 actual in-game days to grow.<br>
It is important to remember this when setting up your growing zones.

<big>{{math|''Actual Growth Time {{=}} (Growth Remaining &times; 60,000 Ticks/Day &times; growDays) &divide; (Growing Ticks/Day &times; GRF(F) &times; GRF(T) &times; GRF(L))}}</big><br>

==Lifespan==
If they are not harvested or eaten, plants will eventually die. This is called *dying of rot*. The counting of their lifetime starts when the plant is sown/spawned. Since plants only grow during certain hours, and growth rate varies greatly under different circumstances, it is possible for a plant to die before it reaches full maturity or even while still on the initial progress. A plant will also die from rotting if it is completely deprived of light - for example, if a roof is built over it.

The lifespan of a plant is calculated by  multiplying the plant's ''growDays'' by its ''lifespanFraction''.
Most vanilla plants have a default ''lifespanFraction'' of 5, but some go as high as 8. Trees have this property as well, but due to their long growth time (''growDays''), their lifespan is longer than is generally relevant.<br>

=== Domesticated plants ===
{{#ask: [[Category:Domesticated plants]]
| ?Grow Days
| ?Harvest Yield
| ?Real Grow Days
| ?Nutrition per Day # = Nutrition Per Day (normal)
| ?Nutrition per Day (140) # = Nutrition Per Day (fertile)
| ?Nutrition per Day (70) # = Nutrition Per Day (gravel)
| ?Nutrition per Day (280) # = Nutrition Per Day (hydroponic)
| ?Fertility Sensitivity
}}

{{math|''Real Grow Days'' {{=}} Grow Days &divide; 0.5417}}

{{math|''Nutrition per Day'' {{=}} Harvest Yield &times; Nutrition (0.05) &divide; Real Grow Days}}

=== Decorative plants ===
{{#ask: [[Category:Decorative plants]]
| ?Beauty
| ?Minimum Yield
| ?Maximum Yield
| ?Product
| ?Growth Time
| ?Fertility Factor
}}

=== Wild plants ===
{{#ask: [[Category:Wild plants]]
| ?Beauty
| ?Minimum Yield
| ?Maximum Yield
| ?Product
| ?Growth Time
| ?Fertility Factor
}}

== Trees ==
{{#ask: [[Category:Trees]]
| ?Beauty
| ?Minimum Yield
| ?Maximum Yield
| ?Product
| ?Growth Time
| ?Fertility Factor
}}

{{math|''Yield per Day' {{=}} Yield  &times; (1 &minus; Plant Resting<ref>This is the fraction of the day were plants don't grow, 0.45 is used in above calculation.   [[Plant|Plants]] for more information</ref>)&times;[(Fertility of Soil<ref>Normal soil (1.00) is used in above equation.</ref> &times; Fertility Factor) + 1 &minus; Fertility Factor) &divide; Growth Time]}}

{{math|''Plants per Colonist' {{=}} Hunger<ref>This is 0.8 , [[Saturation]] for more information</ref> &divide; (Yield per Day &times; Nutrition<ref>This is 0.05 for raw food, [[Food]] for more information</ref>)}}
<references/>

==Plant growth approaches==
The player has a number of options to get plants grown for food and raw material. Each of them has their up- and downsides and a proper mix of them is nesseary to be resistant to disruptions, inclding seasons.

===Fields===
You just define a growing zone, select the crop and let nature and your pawns set to growing do the rest.

'''Upsides:'''
* No cost, excluding the work time to clear trees, sow crops, and harvesting.
* Available at the start, regardless of technology level

'''Downsides:'''
* Outdoor growing is dependent on the local seasonal weather and even impossible in the coldest biomes
* Highly vulnerable to irregular temperature variations such as [[Events#Cold snap|cold snaps]] and [[Events#Heat Wave|heat waves]] that could stop growth or even kill plants
* Outdoor growing is vulnerable to events like [[Events#Toxic fallout|toxic fallout]] and [[Events#Volcanic winter|volcanic winter]]
* Without walls, raiders can easily set your crops ablaze and wild animals can eat your crops. Tamed animals can be excluded via zones however

===Greenhouse===

The Greenhouse is a walled and roofed growing zone, with a sunlamp providing light and heaters or coolers maintaining climate

'''Upsides:'''
* Walling off your crops keeps out raiders and wild animals
* Low costs for the walls and sun lamp alone
* Full resistance to temperature variations once [[heater]]s or [[cooler]]s are built
* Slightly increased growth, due to the persistent 100% lighting level from the sun lamp during the day
* Energy shortages will only kill existing plants if the temperature gets too extreme
* Immune to events like toxic fallout and volcanic winter

'''Downsides:'''
* Trees cannot be planted in greenhouses
* Needs tiles that can support building walls to support the roof, which is difficult in swamp biomes
* Sun lamps require incredible amounts of power during the day: 1-2 solar generators worth of production for the entirety of the plant's non-rest cycle
* High energy costs for maintaining sun lamps
* Requires electricity research to unlock

===Hydroponics bay===

Hydroponics allows plants to grow without soil by using nutrients dissolved in a water bath. In-game, it requires research to unlock and the construction of one or more Hydroponics basins. These basins will override any growing zone they are placed on top of.

'''Upsides:'''
* Basins provide fertility of 280%, the highest rating in the game
* Plants with high fertility sensitivity grow especially well
* Can be combined with [[#Greenhouse|greenhouses]] for growing in environments too cold or hot for outdoor plant growth, including mountains

'''Downsides:'''
* Building a sunlamp and 24 basins (the maximum amount of basins that can fit within a sun lamp's radius of light) requires a huge resource and power commitment, requiring 4580 watts, 1720 steel, and 24 components.
* If the basin loses power, the plants will die within an in-game hour, unless it can be repaired immediately.  If not, manually harvest ASAP
* A power outage including [[Events#Solar flare|solar flares]] will wipe out the entire plant stock in all basins, requiring extensive replanting and usually disrupting food production
* There are fewer options for growing crops within hydroponics basins

<noinclude>
== Version History ==
* [[Version/0.10.785|0.10.785]] - Rebalanced and reformatted plant ecology tunings to lengthen crop cycles and slow wild plant spread. Reworked plant growth in relation to light levels so plants can still grow slowly in dim light (e.g. tundra summers).
{{nav|plant|wide}}
<noinclude/>

[[Category:Plants]]