rcsoccersim / manual Goto Github PK

View Code? Open in Web Editor NEW

23.0 23.0 54.0 1.13 MB

The RoboCup Soccer Simulator Users Manual

Home Page: https://rcsoccersim.readthedocs.io/

Makefile 1.43% Batchfile 12.85% Python 85.72%

manual's People

Contributors

Stargazers

Watchers

Forkers

lchaves001 suptree takashikataoka hirotransfer cstiano njqconquer bluefresher tgabel kn2c2d jonysalgado bcahlit spartronrobotica ranrad srarajaei mahdishemshadi cyrus2d raha1385 sebastianmarian undream mrnanfu maryam31shz gikari mattyoung101 maryamteimouri saniazzt fatemeh-akhondi thunderatz zhengxingqiji ehsan-asali mortezanoohpisheh jacob953 lzx-love-hww wuxie6424 d-seeker davimnz hidehisaakiyama csu-yunlu apollo2d tsa3 wangchers ndwtql socceraboy huvvy qianbai000 pauloguilhermepp sadra-khanjari iranad-team dlay-max rokniraha sonjk shahriarmalik naderzare npr0nn wduminy

manual's Issues

Time Referee

[12.1.3] server::extra_half_time
[13.0.0] change the length of overtime

Vision Sensor Model, Synchronous Mode

About synch_see command and server::sync_see_offset parameter.
See [12.0.0 pre-20080210] and [13.2.0] in NEWS.

Vision Sensor Model, Anonymous mode

About server::fixed_teamname_[lr]
See [16.0.0] in NEWS.

Touch Referee

[14.0.0] golden goal option, server::golden_goal

Tackle Model

[12.0.0 pre-20071217] tackle power restriction
[12.0.0 pre-20080210] server::max_back_tackle_power
[12.0.0 pre-20080210] new tackle model (ball position)
[13.0.0] forbid backward tackle
[14.0.0] increasing tackle noise using server::tackle_rand_factor

Catch Referee

[12.0.0 pre-20071217] change the rules of back pass and catch fault
[12.0.0 pre-20071217] change the rule of goalies' catch vioration
[12.1.1] fix the back pass rule

Catch Model

Improvement of the catch model
See [15.0.0] in NEWS

Dash Model, stamina recovery

No stamina recovery at halftime in the extra halves.
See [12.0.0 pre-20071217]

Body Sensor Model, descriptions about values

arm : [8.03] in NEWS
focus : [8.04] in NEWS
tackle : [8.04] in NEWS
collision : [12.0.0_pre-20071217] in NEWS
foul : [14.0.0] in NEWS

Configuration Files

[8.01] landmark reader
[13.0.0] RCSS_CONF_DIR

Document see message's one letter parameters

Currently the documentation about see message contains the following description:

(see Time ObjInfo+)
Time ::= simulation cycle of rcssserver
ObjInfo ::=
(ObjName Distance Diretion DistChange DirChange BodyFacingDir HeadFacingDir [PointDir] [t] [k]])
| (ObjName Distance Diretion DistChange DirChange [PointDir] [t] [k]])
| (ObjName Distance Diretion)
| (ObjName Diretion)
ObjName ::= (p [“TeamName” [UniformNumber [goalie]]])
| (b)
| (g {l|r})
| (f c)
| (f {l|c|r} {t|b})
| (f p {l|r} {t|c|b})
| (f g {l|r} {t|b})
| (f {l|r|t|b} 0)
| (f {t|b} {l|r} {10|20|30|40|50})
| (f {l|r} {t|b} {10|20|30})
| (l {l|r|t|b} 0)
| (P)
| (B)
| (G)
| (F)
Distance ::= positive real number
Direction ::= -180 ~ 180 degrees
DistChange ::= real number
DirChange ::= real number
BodyFacingDir ::= -180 ~ 180 degrees
HeadFacingDir ::= -180 ~ 180 degrees
PointDir ::= -180 ~ 180 degrees
TeamName ::= string
UniformNumber ::= 1 ~ 11

It's unclear what the [t] and [k] in the ObjInfo part mean, because the names are just letters. Less unclear, but still not clear enough, are the ObjName variations. I suppose (p ...) is for player and other letters are related to flags, lines and goals:

But what about capital letters at the end ((P) (B) (G) (F))? The (b)?

I think it would be better to describe these parameters in place, preferably with the above image so that the reader can better understand the context.