source: cpp/tests/genomanipulation-default.goal @ 1143

Last change on this file since 1143 was 1143, checked in by sz, 3 years ago

update test results, mostly because of r1142 (rgb defaults change)

File size: 14.0 KB
Line 
1    #############################################
2   ##                                           ##
3  ##    Welcome to Genotype Manipulation Demo!    ##
4   ##                                           ##
5    #############################################
6Found converter accepting f1: "Recursive encoding"
7Found 6 converter(s) producing f0
8
9Source genotype: 'X[|G:1.23]'
10                  ( format 1 )
11Converted to f0:
12p:
13p:1.0
14j:0, 1, dx=1.0, 0.0, 0.0
15n:p=1
16n:j=0, d="|:p=0.25,r=1"
17n:j=0, d=G
18c:0, 2, 1.23
19c:1, 0
20
21Model contains: 2 part(s)
22                1 joint(s)
23                3 neuron(s)
24
25Investigating details...
26    #############################################
27   ##                                           ##
28  ##    P A R T    O B J E C T                   ##
29   ##                                           ##
30    #############################################
31            (part # 1)
32Here is the full listing of properties as they are printed in f0
33 (please compare with f0 genotype).
34Some properties have special meaning (eg. geometry and connections groups)
35and should be handled with care, because they influence other elements of the model.
36
37 [this data is provided by Part::properties() ]
38 #        id                      type  name        group (21 properties)
39 0.        x = 1.0                  f   position.x  Geometry 
40 1.        y = 0.0                  f   position.y  Geometry 
41 2.        z = 0.0                  f   position.z  Geometry 
42 3.       sh = 0                    d 0 3 0 shape       Geometry 
43 4.        s = 1.0                  f 0.1 10.0 1.0 size        Geometry 
44 5.       sx = 1.0                  f 0.05 5.0 1.0 scale.x     Geometry 
45 6.       sy = 1.0                  f 0.05 5.0 1.0 scale.y     Geometry 
46 7.       sz = 1.0                  f 0.05 5.0 1.0 scale.z     Geometry 
47 8.        h = 0.0                  f 0 1 0 hollow      Other properties
48 9.       dn = 1.0                  f 0.2 5.0 1.0 density     Other properties
4910.       fr = 0.4                  f 0.0 4.0 0.4 friction    Other properties
5011.      ing = 0.25                 f 0.0 1.0 0.25 ingestion   Other properties
5112.       as = 0.25                 f 0.0 1.0 0.25 assimilation  Other properties
5213.       rx = 0.0                  f   rot.x       Geometry 
5314.       ry = 0.0                  f   rot.y       Geometry 
5415.       rz = 0.0                  f   rot.z       Geometry 
5516.        i =                      s   info        Other properties
5617.   Vstyle = part                 s 0 0 part vis_style   Visual   
5718.       vr = 0.5                  f 0.0 1.0 0.5 red component  Visual   
5819.       vg = 0.5                  f 0.0 1.0 0.5 green component  Visual   
5920.       vb = 0.5                  f 0.0 1.0 0.5 blue component  Visual   
60
61However, there is a subset of properties which may be modified more freely.
62Properties on this list are related only to this part and can be changed
63without much consideration. They are guaranteed to be always valid; any inconsistencies
64will be silently repaired.
65
66 [this data is provided by Part::extraProperties() ]
67 #        id                      type  name        group (8 properties)
68 0.        h = 0.0                  f 0 1 0 hollow      Extra properties
69 1.       dn = 1.0                  f 0.2 5.0 1.0 density     Extra properties
70 2.       fr = 0.4                  f 0.0 4.0 0.4 friction    Extra properties
71 3.      ing = 0.25                 f 0.0 1.0 0.25 ingestion   Extra properties
72 4.       as = 0.25                 f 0.0 1.0 0.25 assimilation  Extra properties
73 5.       vr = 0.5                  f 0.0 1.0 0.5 red component  Extra properties
74 6.       vg = 0.5                  f 0.0 1.0 0.5 green component  Extra properties
75 7.       vb = 0.5                  f 0.0 1.0 0.5 blue component  Extra properties
76
77This set of properties can vary from release to release,
78but can be safely accessed by using extraProperties() call.
79This method accesses the full set of properies (even those
80which appear in future releases).
81Now we will try to change some of properties:
82
83      Change property #4 to random value from range [0..1]
84      Current value of 'as' (assimilation) is '0.25'
85      Setting new value... [ using ParamInterface::set() ]
86      The value is now '0.715189'
87
88Let's see f0... (check out part #1 !)
89
90p:
91p:1.0, as=0.715189
92j:0, 1, dx=1.0, 0.0, 0.0
93n:p=1
94n:j=0, d="|:p=0.25,r=1"
95n:j=0, d=G
96c:0, 2, 1.23
97c:1, 0
98
99    #############################################
100   ##                                           ##
101  ##    J O I N T    O B J E C T                 ##
102   ##                                           ##
103    #############################################
104            (joint # 0)
105Similarly as with Part, the full list of properties comes first:
106
107 #        id                      type  name        group (27 properties)
108 0.       p1 = 0                    d -1 999999 -1 part1 ref#  Connections
109 1.       p2 = 1                    d -1 999999 -1 part2 ref#  Connections
110 2.       rx = 0.0                  f   rotation.x  Geometry 
111 3.       ry = 0.0                  f   rotation.y  Geometry 
112 4.       rz = 0.0                  f   rotation.z  Geometry 
113 5.       dx = 1.0                  f -2 2 0 delta.x     Geometry 
114 6.       dy = 0.0                  f -2 2 0 delta.y     Geometry 
115 7.       dz = 0.0                  f -2 2 0 delta.z     Geometry 
116 8.       sh = 0                    d 0 3 0 shape       Geometry 
117 9.       hx = 0.0                  f   hinge position.x  Geometry 
11810.       hy = 0.0                  f   hinge position.y  Geometry 
11911.       hz = 0.0                  f   hinge position.z  Geometry 
12012.      hrx = 0.0                  f   hinge rotation.x  Geometry 
12113.      hry = 0.0                  f   hinge rotation.y  Geometry 
12214.      hrz = 0.0                  f   hinge rotation.z  Geometry 
12315.      hxn = -1.5708              f -6.2832 0 -1.5708 hinge x negative limit  Geometry 
12416.      hxp = 1.5708               f 0 6.2832 1.5708 hinge x positive limit  Geometry 
12517.      hyn = -1.5708              f -6.2832 0 -1.5708 hinge y negative limit  Geometry 
12618.      hyp = 1.5708               f 0 6.2832 1.5708 hinge y positive limit  Geometry 
12719.     stif = 1.0                  f 0.0 1.0 1.0 stiffness   Other properties
12820.  rotstif = 1.0                  f 0.0 1.0 1.0 rotation stiffness  Other properties
12921.     stam = 0.25                 f 0.0 1.0 0.25 stamina     Other properties
13022.        i =                      s   info        Other properties
13123.   Vstyle = joint                s 0 0 joint vis_style   Visual   
13224.       vr = 0.5                  f 0.0 1.0 0.5 red component  Visual   
13325.       vg = 0.5                  f 0.0 1.0 0.5 green component  Visual   
13426.       vb = 0.5                  f 0.0 1.0 0.5 blue component  Visual   
135
136Actually, there are two kinds of Joints: delta and absolute.
137For this object, Joint::isDelta() returns 1, so this is the delta Joint.
138
139Delta fields (dx,dy,dz) describe relative location of the second part.
140This joint will change the second Part's positions to preserve delta distance.
141Let's move the first Part (#0) along y axis (+0.1) and change delta.z (dz) by 0.1.
142Position of the second Part referenced by this joint (part #1) is now changed:
143
144p:y=0.1
145p:1.0, 0.1, 0.1, as=0.715189
146j:0, 1, dx=1.0, 0.0, 0.1
147n:p=1
148n:j=0, d="|:p=0.25,r=1"
149n:j=0, d=G
150c:0, 2, 1.23
151c:1, 0
152
153If no delta fields are defined, they will be computed automatically.
154You can always delete existing delta values by using Joint::resetDelta().
155Now we will change the second Part's z position by -0.2 and call resetDelta()...
156As you can see, Joint's delta fields have altered:
157
158p:y=0.1
159p:1.0, 0.1, -0.1, as=0.715189
160j:0, 1, dx=1.0, 0.0, -0.1
161n:p=1
162n:j=0, d="|:p=0.25,r=1"
163n:j=0, d=G
164c:0, 2, 1.23
165c:1, 0
166
167How would this joint look like with delta option disabled?
168[ by calling Joint::useDelta(0) ]
169f0 is now:
170
171p:y=0.1
172p:1.0, 0.1, -0.1, as=0.715189
173j:0, 1
174n:p=1
175n:j=0, d="|:p=0.25,r=1"
176n:j=0, d=G
177c:0, 2, 1.23
178c:1, 0
179
180...so this is an absolute joint.
181
182Absolute Joints adapt to its Parts' positions.
183We can move a Part, and it does not influence the second part, nor the Joint.
184Let's move the first Part along y axis by -0.1...
185The Part's position is changed, but everything else stays intact:
186
187p:
188p:1.0, 0.1, -0.1, as=0.715189
189j:0, 1
190n:p=1
191n:j=0, d="|:p=0.25,r=1"
192n:j=0, d=G
193c:0, 2, 1.23
194c:1, 0
195
196Part references and delta fields are the 'core' properties of the Joint.
197The other properties are available from Joint::extraProperties()
198and at the moment are defined as follows:
199
200 #        id                      type  name        group (5 properties)
201 0.     stif = 1.0                  f 0.0 1.0 1.0 stiffness   Extra properties
202 1.  rotstif = 1.0                  f 0.0 1.0 1.0 rotation stiffness  Extra properties
203 2.       vr = 0.5                  f 0.0 1.0 0.5 red component  Extra properties
204 3.       vg = 0.5                  f 0.0 1.0 0.5 green component  Extra properties
205 4.       vb = 0.5                  f 0.0 1.0 0.5 blue component  Extra properties
206
207They can be changed just like Part's extra properties:
208      Change property #3 to random value from range [0..1]
209      Current value of 'vg' (green component) is '0.5'
210      Setting new value... [ using ParamInterface::set() ]
211      The value is now '0.857946'
212And after that we have this genotype:
213
214p:
215p:1.0, 0.1, -0.1, as=0.715189
216j:0, 1, vg=0.857946
217n:p=1
218n:j=0, d="|:p=0.25,r=1"
219n:j=0, d=G
220c:0, 2, 1.23
221c:1, 0
222
223    #############################################
224   ##                                           ##
225  ##    N E U R O    O B J E C T                 ##
226   ##                                           ##
227    #############################################
228            (neuro # 1)
229Basic features of Neuro object are similar to those of Part and Joint.
230We can request a property list:
231
232 #        id                      type  name        group (10 properties)
233 0.        p = -1                   d -1 999999 -1 part ref#   Connections
234 1.        j = 0                    d -1 999999 -1 joint ref#  Connections
235 2.        d = |:p=0.25,r=1         s   details     Other     
236 3.        i =                      s   info        Other     
237 4.   Vstyle = neuro                s 0 0 neuro vis_style   Visual   
238 5. getInputCount = 1                    d   input count  Connections
239 9. classObject = null                 oNeuroClass neuron class  Connections
240
241...and extra properties (which are designed to be always valid and easy to change):
242
243 #        id                      type  name        group (0 properties)
244
245As usual, we will change something:
246Each neuron can have any number of inputs = weighted connections
247 with other neurons.
248According to Neuro::getInputCount(), this one has 1 inputs.
249Standard API is provided for accessing those inputs (getInput(int)),
250adding inputs (addInput(Neuro*)) and removing them (removeInput(int)).
251
252
253The most unusual thing is 'details' field (d).
254It is something like separate object with its own set of properties.
255Currently the value of 'd' is '|:p=0.25,r=1'.
256'|' is the class name (Neuro::getClassName() == '|') and means 'Bend muscle'.
257Neuro::getClass() gives you information about basic characteristic
258of the class, that can be analyzed automatically.
259For the current object we can learn that it supports 1 inputs (getPreferredInputs()) and doesn't provide useful output signal (getPreferredOutput()==0).
260Instances of '|' can be used in models having shape types: 'ball-and-stick'.
261Instances of '|' can be attached to Joints having any shapes.
262The class defines its own properties:
263
264 [ data provided by Neuro::classProperties() ]
265 #        id                      type  name        group (2 properties)
266 0.        p = 0.25                 f 0.0 1.0 0.25 power       Bend muscle
267 1.        r = 1.0                  f 0.0 1.0 1.0 bending range  Bend muscle
268and they can be changed:
269      Change property #1 to random value from range [0..1]
270      Current value of 'r' (bending range) is '1.0'
271      Setting new value... [ using ParamInterface::set() ]
272      The value is now '0.423655'
273After that, 'details' contains the new object: '|:r=0.423655'.
274The class of this object can be changed using Neuro::setClassName()
275The following classes are available:
276 [ data provided by Neuro::getClassInfo()->getProperties() ]
277
278 #  class  description       properties
279 0.     N  Neuron                 4
280 1.    Nu  Unipolar neuron [EXPERIMENTAL!]   4
281 2.     G  Gyroscope              0
282 3. Gpart  Part Gyroscope         2
283 4.     T  Touch                  3
284 5.Tcontact  Touch contact          0
285 6.Tproximity  Touch proximity        3
286 7.     S  Smell                  0
287 8.     *  Constant               0
288 9.     |  Bend muscle            2
28910.     @  Rotation muscle        1
29011.     M  Muscle for solids      2
29112.     D  Differentiate          0
29213. Fuzzy  Fuzzy system [EXPERIMENTAL!]   4
29314.   Sti  Sticky [EXPERIMENTAL!]   0
29415.   LMu  Linear muscle [EXPERIMENTAL!]   1
29516. Water  Water detector         0
29617.Energy  Energy level           0
29718.    Ch  Channelize             0
29819. ChMux  Channel multiplexer    0
29920. ChSel  Channel selector       1
30021.   Rnd  Random noise           0
30122.   Sin  Sinus generator        2
302
303Let's change the Neuro's class to 'Sti'...
304[WARN] Param.loadSingleLine: Unknown property 'Sti.r' (ignored)
305Info for input #0 = ""
306Info for input #0, field "abc" = ""
307The final object description will be then: 'Sti'
308And the full f0 genotype:
309
310p:
311p:1.0, 0.1, -0.1, as=0.715189
312j:0, 1, vg=0.857946
313n:p=1
314n:j=0, d=Sti
315n:j=0, d=G
316c:0, 2, 1.23
317c:1, 0, i="test=44,abc=yeah"
318
319
320######### THE END ###########
321
322Hints:
323  1. You can redirect output: genomanipulation >filename.txt
324  2. Each run can yield different results and new behaviors, but you
325     need to uncomment rndRandomizeSeed() in genomanipulation.cpp.
326  3. This application will use custom genotype passed as
327     a commandline parameter: genomanipulation "/*9*/FULU"
328
329
Note: See TracBrowser for help on using the repository browser.