.TH Command POWER
-.NA power "Display arbitrarily measured strengths of all countries"
+.NA power "Display arbitrarily measured strengths of countries"
.LV Basic
-.SY "power [num]"
-.SY "power new [num]"
-.SY "power country <NATS>"
+.SY "power [new|update] [<NUM>|country <NATS>]"
The power report provides one view of national strengths.
-It can be particularly helpful in planning defense strategies
-and treaty voting.
+It can be particularly helpful in planning defense strategies.
.s1
-If the optional \*Qnum\*U argument is given, only the
-top num entries in the power chart will be displayed. Note that for
-deities, if you give a negative number, only the top num entries in
-the power chart will be displayed, and the power number rating will
-not be displayed.
+Normally, the last saved power report is shown.
+The optional arguments \*Qnew\*U and \*Qupdate\*U request a new power
+report based on up-to-date information.
+This costs 10 BTUs.
+The new report is saved for use by future power commands, except when
+a deity uses \*Qupdate\*U. This lets deities examine up-to-date power
+reports without affecting what players get to see.
.s1
-If the optional \*Qnew\*U argument is given,
-the program will take several minutes to gather information
-and generate a power report based on that up-to-date information.
-This costs 10 BTU's.
+If option AUTO_POWER is enabled, the command doesn't let you save new
+power reports. Instead, the power report is updated automatically
+right before the update.
.s1
-If the optional \*Qnew\*U argument is not given,
-the program will shown you the report generated
-the last time someone asked for new data.
+If the optional \*QNUM\*U argument is given, only the
+top NUM entries in the power chart will be displayed. Note that for
+deities, if you give a negative number, only the top NUM entries in
+the power chart will be displayed, and the power number rating will
+not be displayed.
.s1
If the optional \*Qcountry\*U argument is given, then the information
-is only given for those particular countries. Countries are
-separated by the "/" character as in:
-.EX power c Fodder/19/Mirky
-Note that countries may be specified as either names or numbers.
+is given for those particular countries.
.s1
In the power report the countries are listed
-in order of decreasing \*Qpower factor\*U,
-each being represented by a line in the following format:
+in order of decreasing \*Qpower factor\*U.
+Powerless countries are not shown unless explicitly requested with the
+\*Qcountry\*U argument.
.s1
-.NF
-sects eff civ mil shell gun pet iron dust oil pln ship unit money
-.FI
-
-Each column represents a different commodity or aspect for that country.
-The columns and values used in computing the \*Qpower factor\*U are:
-.NF
-a # of sectors
-b average sector efficiency
-c # of civilians
-d # of military
-e # of shells
-f # of guns
-h tons of iron ore (not displayed)
-i tons of gold dust
-j # of gold bars
-k tons of food (not displayed)
-l tanks of oil
-g # of planes
-m # of ships
-mm tons of ships (not displayed)
-r # of land units
-n # of dollars
-oo units of light construction materials (not displayed)
-pp units of heavy construction materials (not displayed)
-qq megatons of nuclear weaponry (not displayed)
-bb gold bars
-.FI
+The power report shows the following columns:
+.s1
+.in \w'money\0\0'u
+.L sects
+number of sectors
+.L eff
+average sector efficiency
+.L civ
+number of civilians
+.L mil
+number of military
+.L shell
+number of shells
+.L gun
+number of guns
+.L pet
+amount of petrol
+.L iron
+amount of iron
+.L dust
+amount of dust
+.L oil
+amount of oil
+.L pln
+number of planes
+.L ship
+number of ships
+.L unit
+number of land units
+.L money
+cash on hand
+.in
.s1
The \*Qpower factor\*U is determined by the following equation:
.s1
.NF
-power factor = for each land unit calculate and add the following
- ((((land unit lcm cost / 10) * (land unit effic / 100)) +
- ((land unit hcm cost / 10) * (land unit effic / 100))) * 2)
-power factor += for each ship calculate and add the following:
- ((((ship lcm cost / 10) * (ship effic / 100)) +
- ((ship hcm cost / 10) * (ship effic / 100))) * 2)
-power factor += for each plane calculate and add the following:
- (20 * (plane effic / 100) * (nation tech level / 500))
-power factor += ((nation money / 100) + (petrol / 500) +
- ((civilians + military) / 10) + (shells / 12.5) +
- (iron / 100) + (dust / 5) + (oil / 10) + bars +
- (guns / 2.5) + (lcms / 10) + (hcms / 5))
-power factor += ((number of sectors * (average sector effic / 100)) * 10)
-power factor = ((power factor) * (nation tech level / 500))
-power factor = ((power factor) * (research factor))
-
+power factor = ( power value of money
+ + power value of sectors
+ + power value of commodities in sectors
+ + power value of commodities loaded on ships and land units)
+ * (20 + nation tech level) / 500
+ + power value of ships, planes and land units
+ * (20 + their tech level) / 500
.FI
.s1
-The research factor is either 1, if RES_POP is not being used, or 1+(max
-pop in a sector)/10000, if it is being used.
+The power value of money is dollars / 100.
+.s1
+The power value of a sector is efficiency / 10.
+.s1
+The power value of a ship or land unit is (lcm cost / 10 + hcm cost +
+10) * efficiency / 100 * 2.
+.s1
+The power value of a plane is 20 * efficiency / 100 * (20 + nation
+tech level) / 500.
+.s1
+The power value of commodities is amount * type factor. \*Qshow
+item\*U shows the type factor in column \*Qpower\*U.
+.s1
+Efficiency is in percent.
.s1
.SA "census, nation, Communication, Nations, Diplomacy"