docs/tasks.txt

   1 The following tasks are used:
   2 -----------------------------
   3
   4  Name             | Done | Description
   5 ------------------+------+--------------------------------
   6  map_expander     |   0% | Expands the city map if needed
   7  household_growth |   0% | Growths a single household
   8 ------------------+------+--------------------------------
   9
  10 - - - - -
  11
  12 Task 'map_expander':
  13 --------------------
  14
  15 The task is responsible for expanding the city map around outer-most zones and
  16 roads. It also initializes the map at first startup (if the city has been
  17 "founded").
  18
  19 For doing this, around the outer-most zones/roads the map is expanded for a
  20 configurable value (default: 100). After the first road has been constructed,
  21 the map is not expanded directly as this would cause permanent expansion of it
  22 which leads to more system load.
  23
  24 Instead, the map is being expanded if the outer-most zone/road has come to
  25 close ("city border threashold") to the border (default: 10). If that value
  26 has reached or surpassed (to close, e.g. by constructing a long road) the map
  27 is expanded (default: 10+100 from outer-most).
  28
  29 - - - - -
  30
  31 Task 'household_growth':
  32 ------------------------
  33
  34 The task is responsible for growing all households. The task checks if an empty
  35 zone is given and several pre-conditions are met:
  36
  37 1) A road/path way is nearby (must be given but it will be checked anyway).
  38
  39 2) The zone is not to small (minimum: 2x1 as 1 square must be given as distance
  40    to the road. This however will be pre-checked by the client.
  41
  42 3) The land value of the resitential zone is not to low (below zero) as this
  43    hinders that people move in. Please note that some other zones (e.g.
  44    landfills) may reduce land value around them).
  45
  46 4) The land value is not to high for the citizen (cannot effort to buy the
  47    zone).
  48
  49 5) There is no initial "building" (e.g. hut) on the zone or the existing
  50    building is a multi-household building and has at least one appartment for
  51    sale. Please note that rich people prefer low-density and high land-value
  52    zones over high-density zones except it is an expansive multi-household
  53    building.
  54
  55 The task also checks if an existing household has 2 adults of different gender
  56 (1 male, 1 female). Only under this condition reproduction is possible and a
  57 3rd person may be added to it (after about 260-280 days). Adoption is not yet
  58 simulated and may not be added. Please note that this is a city growth
  59 simulation and not a social simulation.
  60
  61 [EOF]