{"abstract":"Every reachable pose has the elbow bent to the supplementary angle and misses the target.","category":"Inverse kinematics solvers","checks":7,"contract":"Input [l1,l2,px,py,elbow] with positive link lengths. Return [q1,q2] in degrees (4 decimals) for a planar two-link arm whose end effector reaches (px,py); elbow \"up\" gives q2>=0, \"down\" gives q2<=0; q1 is wrapped to [-180,180). Points outside the annulus |l1-l2|<=r<=l1+l2 (1e-9 slack on r squared) return \"unreachable\".","evaluation_group":"w2-inverse_kinematics_solvers-two-link-analytic","failed_approach":"Dropping the factor 2 in the denominator doubles the cosine and saturates the clamp.","family":"w2-inverse_kinematics_solvers-two-link-analytic-elbow-law-of-cosines","id":"FA-87851","implementations":{"attempt":{"sha256":"990b6a2b15d1091e4e0428b49847e1f2068ec81067dfde5b98047b9d64f993e6","source":"\"\"\"Failure Map reference implementation. Python standard library only.\"\"\"\nimport json\nimport math\nN = 1\nobservations = []\ndef solve(x):\n    l1,l2,px,py,elbow=x\n    r2=px*px+py*py\n    reach=l1+l2\n    if r2>reach*reach+1e-9: return 'unreachable'\n    if r2<(l1-l2)**2-1e-9: return 'unreachable'\n    c=(r2-l1*l1-l2*l2)/(l1*l2)\n    c=max(-1.0,min(1.0,c))\n    s=math.sqrt(1-c*c)\n    if elbow=='down': s=-s\n    q2=math.atan2(s,c)\n    q1=math.atan2(py,px)-math.atan2(l2*s,l1+l2*c)\n    d1=math.degrees(q1)\n    d1=(d1+180.0)%360.0-180.0\n    return [round(d1,4),round(math.degrees(q2),4)]\ndef check(label, actual, expected):\n    observations.append({\"check\": label, \"actual\": actual, \"expected\": expected, \"passed\": actual == expected})\nfixtures = [[['general elbow up', [[2, 1, 2, 1, 'up']], [0.0, 90.0]], ['general elbow down', [[2, 1, 2, 1, 'down']], [53.1301, -90.0]], ['fully extended on x axis', [[2, 1, 3, 0, 'up']], [0.0, 0.0]], ['fully extended diagonal', [[3, 4, 4.2, 5.6, 'up']], [53.1301, 0.0]], ['outside workspace', [[2, 1, 3, 1, 'up']], 'unreachable'], ['between reach and reach squared', [[1, 1, 1.9, 1.2, 'up']], 'unreachable'], ['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]]], [['fully extended diagonal', [[3, 4, 4.2, 5.6, 'up']], [53.1301, 0.0]], ['outside workspace', [[2, 1, 3, 1, 'up']], 'unreachable'], ['between reach and reach squared', [[1, 1, 1.9, 1.2, 'up']], 'unreachable'], ['inside inner hole', [[3, 1, 1, 0, 'up']], 'unreachable'], ['inner boundary folded', [[3, 1, 2, 0, 'down']], [0.0, -180.0]], ['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]], ['second quadrant target', [[2, 1.5, -2, 1, 'down']], [-165.5619, -102.0247]]], [['inside inner hole', [[3, 1, 1, 0, 'up']], 'unreachable'], ['inner boundary folded', [[3, 1, 2, 0, 'down']], [0.0, -180.0]], ['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]], ['second quadrant target', [[2, 1.5, -2, 1, 'down']], [-165.5619, -102.0247]], ['negative y axis', [[1.5, 1, 0, -2, 'up']], [-118.955, 75.5225]], ['behind base elbow down', [[2, 1, -2.5, -0.5, 'down']], [-147.3681, -67.9757]], ['equal links near base', [[1, 1, 0.5, 0.2, 'up']], [-52.5785, 148.7597]]], [['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]], ['negative y axis', [[1.5, 1, 0, -2, 'up']], [-118.955, 75.5225]], ['behind base elbow down', [[2, 1, -2.5, -0.5, 'down']], [-147.3681, -67.9757]], ['equal links near base', [[1, 1, 0.5, 0.2, 'up']], [-52.5785, 148.7597]], ['long forearm hole', [[1, 3, 0.5, 1, 'down']], 'unreachable'], ['long forearm reachable', [[1, 3, 2.5, 0.5, 'up']], [-95.7981, 125.6853]], ['positive y axis', [[2, 2, 0, 3, 'down']], [131.4096, -82.8192]]], [['second quadrant target', [[2, 1.5, -2, 1, 'down']], [-165.5619, -102.0247]], ['equal links near base', [[1, 1, 0.5, 0.2, 'up']], [-52.5785, 148.7597]], ['long forearm reachable', [[1, 3, 2.5, 0.5, 'up']], [-95.7981, 125.6853]], ['positive y axis', [[2, 2, 0, 3, 'down']], [131.4096, -82.8192]], ['wrap past minus 180', [[1, 2, -2.2, -0.3, 'up']], [123.5259, 91.0027]], ['upper left down', [[3, 2, -1, 4, 'down']], [131.2512, -70.5288]], ['near full reach', [[5, 3, 7.9, 0.5, 'down']], [10.0523, -17.1893]]]]\nfor label, args, expected in fixtures[N-1]:\n    check(label, solve(*args), expected)\nprint(json.dumps({\"observations\": observations, \"passed\": all(x[\"passed\"] for x in observations)}, ensure_ascii=False))\nraise SystemExit(0 if all(x[\"passed\"] for x in observations) else 1)\n"},"broken":{"sha256":"40a843e85172a302459ee01e370bcc6fc0932cf5f22940abe9feb10d0d5260bc","source":"\"\"\"Failure Map reference implementation. Python standard library only.\"\"\"\nimport json\nimport math\nN = 1\nobservations = []\ndef solve(x):\n    l1,l2,px,py,elbow=x\n    r2=px*px+py*py\n    reach=l1+l2\n    if r2>reach*reach+1e-9: return 'unreachable'\n    if r2<(l1-l2)**2-1e-9: return 'unreachable'\n    c=(l1*l1+l2*l2-r2)/(2*l1*l2)\n    c=max(-1.0,min(1.0,c))\n    s=math.sqrt(1-c*c)\n    if elbow=='down': s=-s\n    q2=math.atan2(s,c)\n    q1=math.atan2(py,px)-math.atan2(l2*s,l1+l2*c)\n    d1=math.degrees(q1)\n    d1=(d1+180.0)%360.0-180.0\n    return [round(d1,4),round(math.degrees(q2),4)]\ndef check(label, actual, expected):\n    observations.append({\"check\": label, \"actual\": actual, \"expected\": expected, \"passed\": actual == expected})\nfixtures = [[['general elbow up', [[2, 1, 2, 1, 'up']], [0.0, 90.0]], ['general elbow down', [[2, 1, 2, 1, 'down']], [53.1301, -90.0]], ['fully extended on x axis', [[2, 1, 3, 0, 'up']], [0.0, 0.0]], ['fully extended diagonal', [[3, 4, 4.2, 5.6, 'up']], [53.1301, 0.0]], ['outside workspace', [[2, 1, 3, 1, 'up']], 'unreachable'], ['between reach and reach squared', [[1, 1, 1.9, 1.2, 'up']], 'unreachable'], ['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]]], [['fully extended diagonal', [[3, 4, 4.2, 5.6, 'up']], [53.1301, 0.0]], ['outside workspace', [[2, 1, 3, 1, 'up']], 'unreachable'], ['between reach and reach squared', [[1, 1, 1.9, 1.2, 'up']], 'unreachable'], ['inside inner hole', [[3, 1, 1, 0, 'up']], 'unreachable'], ['inner boundary folded', [[3, 1, 2, 0, 'down']], [0.0, -180.0]], ['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]], ['second quadrant target', [[2, 1.5, -2, 1, 'down']], [-165.5619, -102.0247]]], [['inside inner hole', [[3, 1, 1, 0, 'up']], 'unreachable'], ['inner boundary folded', [[3, 1, 2, 0, 'down']], [0.0, -180.0]], ['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]], ['second quadrant target', [[2, 1.5, -2, 1, 'down']], [-165.5619, -102.0247]], ['negative y axis', [[1.5, 1, 0, -2, 'up']], [-118.955, 75.5225]], ['behind base elbow down', [[2, 1, -2.5, -0.5, 'down']], [-147.3681, -67.9757]], ['equal links near base', [[1, 1, 0.5, 0.2, 'up']], [-52.5785, 148.7597]]], [['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]], ['negative y axis', [[1.5, 1, 0, -2, 'up']], [-118.955, 75.5225]], ['behind base elbow down', [[2, 1, -2.5, -0.5, 'down']], [-147.3681, -67.9757]], ['equal links near base', [[1, 1, 0.5, 0.2, 'up']], [-52.5785, 148.7597]], ['long forearm hole', [[1, 3, 0.5, 1, 'down']], 'unreachable'], ['long forearm reachable', [[1, 3, 2.5, 0.5, 'up']], [-95.7981, 125.6853]], ['positive y axis', [[2, 2, 0, 3, 'down']], [131.4096, -82.8192]]], [['second quadrant target', [[2, 1.5, -2, 1, 'down']], [-165.5619, -102.0247]], ['equal links near base', [[1, 1, 0.5, 0.2, 'up']], [-52.5785, 148.7597]], ['long forearm reachable', [[1, 3, 2.5, 0.5, 'up']], [-95.7981, 125.6853]], ['positive y axis', [[2, 2, 0, 3, 'down']], [131.4096, -82.8192]], ['wrap past minus 180', [[1, 2, -2.2, -0.3, 'up']], [123.5259, 91.0027]], ['upper left down', [[3, 2, -1, 4, 'down']], [131.2512, -70.5288]], ['near full reach', [[5, 3, 7.9, 0.5, 'down']], [10.0523, -17.1893]]]]\nfor label, args, expected in fixtures[N-1]:\n    check(label, solve(*args), expected)\nprint(json.dumps({\"observations\": observations, \"passed\": all(x[\"passed\"] for x in observations)}, ensure_ascii=False))\nraise SystemExit(0 if all(x[\"passed\"] for x in observations) else 1)\n"},"fixed":{"sha256":"8da3f8b65b59204295f36bc88baa62a23b22b78aed803793d595d51153f7a02d","source":"\"\"\"Failure Map reference implementation. Python standard library only.\"\"\"\nimport json\nimport math\nN = 1\nobservations = []\ndef solve(x):\n    l1,l2,px,py,elbow=x\n    r2=px*px+py*py\n    reach=l1+l2\n    if r2>reach*reach+1e-9: return 'unreachable'\n    if r2<(l1-l2)**2-1e-9: return 'unreachable'\n    c=(r2-l1*l1-l2*l2)/(2*l1*l2)\n    c=max(-1.0,min(1.0,c))\n    s=math.sqrt(1-c*c)\n    if elbow=='down': s=-s\n    q2=math.atan2(s,c)\n    q1=math.atan2(py,px)-math.atan2(l2*s,l1+l2*c)\n    d1=math.degrees(q1)\n    d1=(d1+180.0)%360.0-180.0\n    return [round(d1,4),round(math.degrees(q2),4)]\ndef check(label, actual, expected):\n    observations.append({\"check\": label, \"actual\": actual, \"expected\": expected, \"passed\": actual == expected})\nfixtures = [[['general elbow up', [[2, 1, 2, 1, 'up']], [0.0, 90.0]], ['general elbow down', [[2, 1, 2, 1, 'down']], [53.1301, -90.0]], ['fully extended on x axis', [[2, 1, 3, 0, 'up']], [0.0, 0.0]], ['fully extended diagonal', [[3, 4, 4.2, 5.6, 'up']], [53.1301, 0.0]], ['outside workspace', [[2, 1, 3, 1, 'up']], 'unreachable'], ['between reach and reach squared', [[1, 1, 1.9, 1.2, 'up']], 'unreachable'], ['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]]], [['fully extended diagonal', [[3, 4, 4.2, 5.6, 'up']], [53.1301, 0.0]], ['outside workspace', [[2, 1, 3, 1, 'up']], 'unreachable'], ['between reach and reach squared', [[1, 1, 1.9, 1.2, 'up']], 'unreachable'], ['inside inner hole', [[3, 1, 1, 0, 'up']], 'unreachable'], ['inner boundary folded', [[3, 1, 2, 0, 'down']], [0.0, -180.0]], ['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]], ['second quadrant target', [[2, 1.5, -2, 1, 'down']], [-165.5619, -102.0247]]], [['inside inner hole', [[3, 1, 1, 0, 'up']], 'unreachable'], ['inner boundary folded', [[3, 1, 2, 0, 'down']], [0.0, -180.0]], ['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]], ['second quadrant target', [[2, 1.5, -2, 1, 'down']], [-165.5619, -102.0247]], ['negative y axis', [[1.5, 1, 0, -2, 'up']], [-118.955, 75.5225]], ['behind base elbow down', [[2, 1, -2.5, -0.5, 'down']], [-147.3681, -67.9757]], ['equal links near base', [[1, 1, 0.5, 0.2, 'up']], [-52.5785, 148.7597]]], [['third quadrant target', [[2, 2, -2, -1, 'up']], [150.5529, 112.0243]], ['negative y axis', [[1.5, 1, 0, -2, 'up']], [-118.955, 75.5225]], ['behind base elbow down', [[2, 1, -2.5, -0.5, 'down']], [-147.3681, -67.9757]], ['equal links near base', [[1, 1, 0.5, 0.2, 'up']], [-52.5785, 148.7597]], ['long forearm hole', [[1, 3, 0.5, 1, 'down']], 'unreachable'], ['long forearm reachable', [[1, 3, 2.5, 0.5, 'up']], [-95.7981, 125.6853]], ['positive y axis', [[2, 2, 0, 3, 'down']], [131.4096, -82.8192]]], [['second quadrant target', [[2, 1.5, -2, 1, 'down']], [-165.5619, -102.0247]], ['equal links near base', [[1, 1, 0.5, 0.2, 'up']], [-52.5785, 148.7597]], ['long forearm reachable', [[1, 3, 2.5, 0.5, 'up']], [-95.7981, 125.6853]], ['positive y axis', [[2, 2, 0, 3, 'down']], [131.4096, -82.8192]], ['wrap past minus 180', [[1, 2, -2.2, -0.3, 'up']], [123.5259, 91.0027]], ['upper left down', [[3, 2, -1, 4, 'down']], [131.2512, -70.5288]], ['near full reach', [[5, 3, 7.9, 0.5, 'down']], [10.0523, -17.1893]]]]\nfor label, args, expected in fixtures[N-1]:\n    check(label, solve(*args), expected)\nprint(json.dumps({\"observations\": observations, \"passed\": all(x[\"passed\"] for x in observations)}, ensure_ascii=False))\nraise SystemExit(0 if all(x[\"passed\"] for x in observations) else 1)\n"}},"limitations":"Deterministic planar or low-dimensional teaching model with a stipulated convention; not a general robotics library. This reproducer isolates one failure mechanism. Results cover the supplied fixtures. Variants within a family share a test contract and should remain grouped when constructing evaluation splits. Related mechanisms with a shared evaluation_group must also remain together; these controlled models are not independent production incidents.","method":"Deterministic executable model with adversarial boundary fixtures.","provenance":{"created_by":"Failure Map","dependencies":"Python standard library","family":"w2-inverse_kinematics_solvers-two-link-analytic-elbow-law-of-cosines","generated_at":"2026-09-29T14:51:02.619935+00:00","license":"CC0-1.0","python":"3.12.14","seed":1,"split":"open-access"},"relevance":"Inverse kinematics code turns task-space goals into joint commands; a wrong branch, sign, limit or update order sends a real arm to the wrong pose.","repair":"Use cos q2 = (r^2-l1^2-l2^2)/(2 l1 l2).","root_cause":"The law of cosines is written as the angle between the links (l1^2+l2^2-r^2) rather than the relative joint rotation.","sha256":"4e6f6f627babb8a944f5d4284386f34530d1183debc30dbf8f44de9e76e7164a","title":"Elbow angle uses the interior triangle angle instead of the joint angle · case 01","variant":1,"variant_policy":"Five numbered records share a model and may reuse boundary fixtures.","verification":{"attempt":{"elapsed_ms":40.084,"exit_code":1,"observations":[{"actual":[0.0,90.0],"check":"general elbow up","expected":[0.0,90.0],"passed":true},{"actual":[53.1301,-90.0],"check":"general elbow down","expected":[53.1301,-90.0],"passed":true},{"actual":[0.0,0.0],"check":"fully extended on x axis","expected":[0.0,0.0],"passed":true},{"actual":[53.1301,0.0],"check":"fully extended diagonal","expected":[53.1301,0.0],"passed":true},{"actual":"unreachable","check":"outside workspace","expected":"unreachable","passed":true},{"actual":"unreachable","check":"between reach and reach squared","expected":"unreachable","passed":true},{"actual":[137.2699,138.5904],"check":"third quadrant target","expected":[150.5529,112.0243],"passed":false}],"passed":false,"stderr":"","stdout":"{\"observations\": [{\"check\": \"general elbow up\", \"actual\": [0.0, 90.0], \"expected\": [0.0, 90.0], \"passed\": true}, {\"check\": \"general elbow down\", \"actual\": [53.1301, -90.0], \"expected\": [53.1301, -90.0], \"passed\": true}, {\"check\": \"fully extended on x axis\", \"actual\": [0.0, 0.0], \"expected\": [0.0, 0.0], \"passed\": true}, {\"check\": \"fully extended diagonal\", \"actual\": [53.1301, 0.0], \"expected\": [53.1301, 0.0], \"passed\": true}, {\"check\": \"outside workspace\", \"actual\": \"unreachable\", \"expected\": \"unreachable\", \"passed\": true}, {\"check\": \"between reach and reach squared\", \"actual\": \"unreachable\", \"expected\": \"unreachable\", \"passed\": true}, {\"check\": \"third quadrant target\", \"actual\": [137.2699, 138.5904], \"expected\": [150.5529, 112.0243], \"passed\": false}], \"passed\": false}\n"},"broken":{"elapsed_ms":40.241,"exit_code":1,"observations":[{"actual":[0.0,90.0],"check":"general elbow up","expected":[0.0,90.0],"passed":true},{"actual":[53.1301,-90.0],"check":"general elbow down","expected":[53.1301,-90.0],"passed":true},{"actual":[0.0,180.0],"check":"fully extended on x axis","expected":[0.0,0.0],"passed":false},{"actual":[-126.8699,180.0],"check":"fully extended diagonal","expected":[53.1301,0.0],"passed":false},{"actual":"unreachable","check":"outside workspace","expected":"unreachable","passed":true},{"actual":"unreachable","check":"between reach and reach squared","expected":"unreachable","passed":true},{"actual":[172.5772,67.9757],"check":"third quadrant target","expected":[150.5529,112.0243],"passed":false}],"passed":false,"stderr":"","stdout":"{\"observations\": [{\"check\": \"general elbow up\", \"actual\": [0.0, 90.0], \"expected\": [0.0, 90.0], \"passed\": true}, {\"check\": \"general elbow down\", \"actual\": [53.1301, -90.0], \"expected\": [53.1301, -90.0], \"passed\": true}, {\"check\": \"fully extended on x axis\", \"actual\": [0.0, 180.0], \"expected\": [0.0, 0.0], \"passed\": false}, {\"check\": \"fully extended diagonal\", \"actual\": [-126.8699, 180.0], \"expected\": [53.1301, 0.0], \"passed\": false}, {\"check\": \"outside workspace\", \"actual\": \"unreachable\", \"expected\": \"unreachable\", \"passed\": true}, {\"check\": \"between reach and reach squared\", \"actual\": \"unreachable\", \"expected\": \"unreachable\", \"passed\": true}, {\"check\": \"third quadrant target\", \"actual\": [172.5772, 67.9757], \"expected\": [150.5529, 112.0243], \"passed\": false}], \"passed\": false}\n"},"fixed":{"elapsed_ms":39.907,"exit_code":0,"observations":[{"actual":[0.0,90.0],"check":"general elbow up","expected":[0.0,90.0],"passed":true},{"actual":[53.1301,-90.0],"check":"general elbow down","expected":[53.1301,-90.0],"passed":true},{"actual":[0.0,0.0],"check":"fully extended on x axis","expected":[0.0,0.0],"passed":true},{"actual":[53.1301,0.0],"check":"fully extended diagonal","expected":[53.1301,0.0],"passed":true},{"actual":"unreachable","check":"outside workspace","expected":"unreachable","passed":true},{"actual":"unreachable","check":"between reach and reach squared","expected":"unreachable","passed":true},{"actual":[150.5529,112.0243],"check":"third quadrant target","expected":[150.5529,112.0243],"passed":true}],"passed":true,"stderr":"","stdout":"{\"observations\": [{\"check\": \"general elbow up\", \"actual\": [0.0, 90.0], \"expected\": [0.0, 90.0], \"passed\": true}, {\"check\": \"general elbow down\", \"actual\": [53.1301, -90.0], \"expected\": [53.1301, -90.0], \"passed\": true}, {\"check\": \"fully extended on x axis\", \"actual\": [0.0, 0.0], \"expected\": [0.0, 0.0], \"passed\": true}, {\"check\": \"fully extended diagonal\", \"actual\": [53.1301, 0.0], \"expected\": [53.1301, 0.0], \"passed\": true}, {\"check\": \"outside workspace\", \"actual\": \"unreachable\", \"expected\": \"unreachable\", \"passed\": true}, {\"check\": \"between reach and reach squared\", \"actual\": \"unreachable\", \"expected\": \"unreachable\", \"passed\": true}, {\"check\": \"third quadrant target\", \"actual\": [150.5529, 112.0243], \"expected\": [150.5529, 112.0243], \"passed\": true}], \"passed\": true}\n"}},"verified":true,"visibility":"public"}