Changeset 699
- Timestamp:
- 09/19/17 02:35:09 (7 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
java/Framclipse/com.framsticks.framclipse/res/framscript.xml
r693 r699 128 128 <description><![CDATA[Note that the index changes depending on the current creature position in the population. Use Creature.uid if you need a permanent identifier that persists through the entire object lifetime.]]></description> 129 129 </element> 130 <element name="num" type="integer"> 131 <description><![CDATA[Acts as a unique identifier, but less strict than "uid". Unlike "uid", "num" can be changed and therefore can be saved and restored, providing persistence and continuity beyond a single application run. "num" is only guaranteed to be unique if it is autogenerated and not changed by the user, otherwise it is user's responsibility to manage the proper values of "num". Autogenerated "num" is always equal to the largest previously used "num" + 1. The largest previously used value is stored in Simulator.last_creature_num and can be changed as well (and is automatically saved and restored as a part of the Simulator state). Limitation: being a 32-bit integer, "num" overflows at about 2 billion counts. 132 See also: uid]]></description> 133 </element> 130 134 <element name="gnum" type="integer"/> 131 135 <element name="buildproblems" type="integer" flags="34"/> … … 365 369 </element> 366 370 <element name="uid" type="string" flags="1"> 367 <description><![CDATA[Unique identifier]]></description> 371 <description><![CDATA[Unique identifier that is generated on object creation. "uid" is only unique during a single application run. Subsequent runs generate the same sequence of uid values. 372 See also: num]]></description> 368 373 </element> 369 374 <element name="signals" type="CreatureSignals" flags="35"/> … … 479 484 </type> 480 485 <type name="CreatureSnapshot" context="Global context"> 481 <description><![CDATA[A data object consisting of the same fields as the serialized Creature. Typically used for reading a Creature back from a file, then Population.add(snapshot_object) creates the Creature object from the snapshot.]]></description> 486 <description><![CDATA[A data object consisting of the same fields as the serialized Creature. Typically used for reading a Creature back from a file; Population.add(snapshot_object) recreates the Creature object from the snapshot. When the creature is added to a population and it happens to collide with the terrain, the creature will be automatically moved upwards just enough to avoid the collision. 487 Serialized Creature preserves most of its data fields (including the 'data' dictionary) but only keeps aggregated information about its physical state, which is body orientation and location of the bounding box center. Individual physical body parts' locations, states and neuron states are lost. 488 Restoring the state of a formerly living, serialized creature using its CreatureSnapshot is not perfect. Apart from losing information about individual body and brain parts and their states, the usual flow of calculating performance may be disturbed, which is related to the 'performance sampling period' being interrupted as well as the specifics of the 'freezing period' mechanism. In consequence, the intended behavior of 'lifespan', 'steps_in_lifespan', and performance fields may be broken. For example, when period=100, after every 100 'steps_in_lifespan', the 'lifespan' increases by 100 and the new performance data is calculated. When the period is interrupted by saving/restoring, 'steps_in_lifespan' continues to increase from the saved value, but performance counters will be waiting another full 100 steps before the next update, losing the information from the unfinished period. The resulting 'lifespan' will be lower than it would have been without interruptions, and will be inconsistent with 'steps_in_lifespan'. Because of these issues, it is strongly advised to thoroughly inspect and test the behavior of the restored Creatures in various moments in their lifepspan, and use CreatureSnapshot only when necessary. 489 See also: scripts/standard_exploadsave.inc 490 See also: Population.add() 491 ]]></description> 482 492 <element name="new" function="true" type="Creature"><arguments/></element> 483 493 <element name="name" type="string" max="40"/> … … 485 495 <element name="info" type="string"> 486 496 <description><![CDATA[Additional info or comments]]></description> 497 </element> 498 <element name="num" type="integer"> 499 <description><![CDATA[Acts as a unique identifier, but less strict than "uid". Unlike "uid", "num" can be changed and therefore can be saved and restored, providing persistence and continuity beyond a single application run. "num" is only guaranteed to be unique if it is autogenerated and not changed by the user, otherwise it is user's responsibility to manage the proper values of "num". Autogenerated "num" is always equal to the largest previously used "num" + 1. The largest previously used value is stored in Simulator.last_creature_num and can be changed as well (and is automatically saved and restored as a part of the Simulator state). Limitation: being a 32-bit integer, "num" overflows at about 2 billion counts. 500 See also: uid]]></description> 487 501 </element> 488 502 <element name="gnum" type="integer"/> … … 544 558 </element> 545 559 <element name="uid" type="string"> 546 <description><![CDATA[Unique identifier]]></description> 560 <description><![CDATA[Unique identifier that is generated on object creation. "uid" is only unique during a single application run. Subsequent runs generate the same sequence of uid values. 561 See also: num]]></description> 547 562 </element> 548 563 </type> … … 1704 1719 <element name="numneurons" type="integer" flags="16"/> 1705 1720 <element name="numconnections" type="integer" flags="16"/> 1706 <element name="num" type="integer"/> 1721 <element name="num" type="integer"> 1722 <description><![CDATA[Acts as a unique identifier, but less strict than "uid". Unlike "uid", "num" can be changed and therefore can be saved and restored, providing persistence and continuity beyond a single application run. "num" is only guaranteed to be unique if it is autogenerated and not changed by the user, otherwise it is user's responsibility to manage the proper values of "num". "Genotype.num" is generated on adding a Genotype object to a group, unless it already has a non-zero "num" (previously autogenerated or user-assigned). Autogenerated "num" is always equal to the largest previously used "num" + 1. The largest previously used value is stored in Simulator.last_genotype_num and can be changed as well (and is automatically saved and restored as a part of the Simulator state). Limitation: being a 32-bit integer, "num" overflows at about 2 billion counts. 1723 See also: uid]]></description> 1724 </element> 1707 1725 <element name="gnum" type="integer"/> 1708 1726 <element name="popsiz" type="integer" deprecated="true" flags="8226"> … … 1751 1769 </element> 1752 1770 <element name="uid" type="string" flags="1"> 1753 <description><![CDATA[Unique identifier]]></description> 1771 <description><![CDATA[Unique identifier that is generated on object creation. "uid" is only unique during a single application run. Subsequent runs generate the same sequence of uid values. 1772 See also: num]]></description> 1754 1773 </element> 1755 1774 <element name="getModel" function="true" type="Model" flags="32"><arguments/></element> … … 3073 3092 </element> 3074 3093 <element name="add" function="true" type="Creature" flags="34"> 3075 <arguments> 3076 <argument name="genotype object or geno object or string genotype" type="untyped"/> 3094 <description><![CDATA[Adding CreatureSnapshot object automatically copies the CreatureSnapshot fields into the Creature, including creature location (the center of the bounding box is preserved) and orientation. 3095 See also: CreatureSnapshot]]></description> 3096 <arguments> 3097 <argument name="Genotype object or Geno object or string genotype or CreatureSnapshot object" type="untyped"/> 3077 3098 </arguments> 3078 3099 </element> … … 3480 3501 <element name="time" type="integer" deprecated="true" flags="8226"> 3481 3502 <description><![CDATA[Simulator.time will be removed because of its misleading name, please use Simulator.stepNumber instead.]]></description> 3503 </element> 3504 <element name="last_genotype_num" type="integer" min="0" max="-1" default="0" flags="32"> 3505 <description><![CDATA[See: Genotype.num]]></description> 3506 </element> 3507 <element name="last_creature_num" type="integer" min="0" max="-1" default="0" flags="32"> 3508 <description><![CDATA[See: Creature.num]]></description> 3482 3509 </element> 3483 3510 <element name="stepNumber" type="integer" flags="34"/> … … 4658 4685 <element name="time" type="integer" deprecated="true" flags="8226"> 4659 4686 <description><![CDATA[Simulator.time will be removed because of its misleading name, please use Simulator.stepNumber instead.]]></description> 4687 </element> 4688 <element name="last_genotype_num" type="integer" min="0" max="-1" default="0" flags="32"> 4689 <description><![CDATA[See: Genotype.num]]></description> 4690 </element> 4691 <element name="last_creature_num" type="integer" min="0" max="-1" default="0" flags="32"> 4692 <description><![CDATA[See: Creature.num]]></description> 4660 4693 </element> 4661 4694 <element name="stepNumber" type="integer" flags="34"/> … … 5650 5683 <element name="numneurons" type="integer" flags="16"/> 5651 5684 <element name="numconnections" type="integer" flags="16"/> 5652 <element name="num" type="integer"/> 5685 <element name="num" type="integer"> 5686 <description><![CDATA[Acts as a unique identifier, but less strict than "uid". Unlike "uid", "num" can be changed and therefore can be saved and restored, providing persistence and continuity beyond a single application run. "num" is only guaranteed to be unique if it is autogenerated and not changed by the user, otherwise it is user's responsibility to manage the proper values of "num". "Genotype.num" is generated on adding a Genotype object to a group, unless it already has a non-zero "num" (previously autogenerated or user-assigned). Autogenerated "num" is always equal to the largest previously used "num" + 1. The largest previously used value is stored in Simulator.last_genotype_num and can be changed as well (and is automatically saved and restored as a part of the Simulator state). Limitation: being a 32-bit integer, "num" overflows at about 2 billion counts. 5687 See also: uid]]></description> 5688 </element> 5653 5689 <element name="gnum" type="integer"/> 5654 5690 <element name="popsiz" type="integer" deprecated="true" flags="8226"> … … 5697 5733 </element> 5698 5734 <element name="uid" type="string" flags="1"> 5699 <description><![CDATA[Unique identifier]]></description> 5735 <description><![CDATA[Unique identifier that is generated on object creation. "uid" is only unique during a single application run. Subsequent runs generate the same sequence of uid values. 5736 See also: num]]></description> 5700 5737 </element> 5701 5738 <element name="getModel" function="true" type="Model" flags="32"><arguments/></element> … … 5761 5798 <element name="index" type="integer" flags="35"> 5762 5799 <description><![CDATA[Note that the index changes depending on the current creature position in the population. Use Creature.uid if you need a permanent identifier that persists through the entire object lifetime.]]></description> 5800 </element> 5801 <element name="num" type="integer"> 5802 <description><![CDATA[Acts as a unique identifier, but less strict than "uid". Unlike "uid", "num" can be changed and therefore can be saved and restored, providing persistence and continuity beyond a single application run. "num" is only guaranteed to be unique if it is autogenerated and not changed by the user, otherwise it is user's responsibility to manage the proper values of "num". Autogenerated "num" is always equal to the largest previously used "num" + 1. The largest previously used value is stored in Simulator.last_creature_num and can be changed as well (and is automatically saved and restored as a part of the Simulator state). Limitation: being a 32-bit integer, "num" overflows at about 2 billion counts. 5803 See also: uid]]></description> 5763 5804 </element> 5764 5805 <element name="gnum" type="integer"/> … … 5999 6040 </element> 6000 6041 <element name="uid" type="string" flags="1"> 6001 <description><![CDATA[Unique identifier]]></description> 6042 <description><![CDATA[Unique identifier that is generated on object creation. "uid" is only unique during a single application run. Subsequent runs generate the same sequence of uid values. 6043 See also: num]]></description> 6002 6044 </element> 6003 6045 <element name="signals" type="CreatureSignals" flags="35"/>
Note: See TracChangeset
for help on using the changeset viewer.