empserver/info/Update-sequence.t
Markus Armbruster b6509b7309 budget: Avoid unnecessary work
Ship, plane and land unit repairs depend on and change the state of
the sector.  To predict repairs, we need to predict the state of the
sector before repairs.  The obvious way to do that is to simulate the
sector update and all ship, plane and land unit updates there in the
correct order.

Until recently, we simulated only own sectors, ships, planes and land
units.  Wrong when foreign sectors, ships, planes or land units are
involved.  The fix (commit 70f6964) makes budget simulate all
countries.  Correct, but does much more work than necessary.  With a
little effort, we can track what needs to be simulated.

Use the bp map for tracking.  We need to mark the player's sectors and
all sectors where he has ships, planes or land units.  Do the former
in bp_alloc(), and the latter in prep_ships(), prep_planes(),
prep_lands().

Skip sectors not so marked.  This requires delaying prepare_sects()
until after prep_ships(), prep_planes(), prep_lands().  Their order
doesn't actually matter: prep_ships() & friends only spend money, and
nothing in preparation depends on whether the country is still
solvent.

Skip ships, planes and land units in sectors not so marked.

This speeds up budget by around a third in my testing, more for small
countries.  Roughly 15% slower than before the fix for repairs abroad.
The update has to do a bit more work than before, but the performance
difference is lost in the noise.

Signed-off-by: Markus Armbruster <armbru@pond.sub.org>
2017-08-06 20:09:06 +02:00

77 lines
2.9 KiB
Perl

.TH Concept Update-sequence
.NA Update-sequence "The order of events at the update"
.LV Expert
.s1
This document gives a rough order of events during the update.
.s1
.nf
1) Prepare
a) prepare all ships
a) pay military on board
b) prepare all planes
a) pay crew
c) prepare all land units
a) pay military on board
d) prepare all sectors
a) fallout is checked, if FALLOUT is defined
b) guerrilla warfare is checked
c) if the sector doesn't have the plague, see if it
catches it
otherwise plague the people
d) if there are no civs or mil in the sector, it
reverts to the deity
e) taxes are collected from civs & uws; mil are paid.
f) if the sector is a bank it makes $$ proportional to
its efficiency
e) pay for military reserves.
2) Produce
a) ship maintenance, in order of ship number
pay maintenance, then feed and plague people on board
b) plane maintenance, in order of plane number
c) land unit maintenance, in order of land unit number
pay maintenance, then feed and plague people on board
d) sectors, top to bottom, left to right
a) people in non-sanctuary sectors eat
If not enough is available, the excess people will
starve off. No more than 50% of the people
in a sector can die; the uw's die first, then
the civs, then the mil.
b) if there was starvation, the work percentage is set
to 0, otherwise the work rate rises by
8+(1-15), max of 100
c) population grows and is truncated
d) pay sector maintenance
e) sectors that are stopped are skipped (see info stop)
f) first increase eff
g) then make things
d) ship building, in order of ship number
first increase efficiency, then produce
stopped ships are started, but not built (see info stop)
e) plane building, in order of plane number
stopped planes are started, but not built (see info stop)
f) land unit building, in order of land unit number
stopped land units are started, but not built (see info stop)
3) Then, do deliveries for all sectors in the world, row by row, going from
top to bottom, left to right
4) Then, do exporting via distribution for all sectors in the world, row by
row, going from top to bottom, left to right
5) Then, do importing via distribution for all sectors in the world, row by
row, going from top to bottom, left to right
Also start sectors that are stopped
6) modify tech/res/hap/edu levels & do tech bleed
7) decrease levels due to passing of time
8) update war declarations (for slow war)
9) If MOB_ACCESS is not enabled, mobility is updated as follows:
a) Add mobility to ships
b) Add mobility to sectors
c) Add mobility to planes
d) Add mobility to land units
.fi
.s1
.SA "Innards, Updates"