Python#

Míníonn Tagairt API Python VEX V5 cad a dhéanann gach ordú, modh agus feidhm, cad iad na hionchuir a úsáideann sé, cad a thugann sé ar ais, agus conas is féidir é a úsáid i dtionscadal.

Bain úsáid as an tagairt seo nuair is mian leat ordú a thuiscint sula gcuireann tú le tionscadal é, a sheiceáil cé na luachanna a ghlacann sé nó a thugann sé ar ais, nó orduithe gaolmhara i gcatagóir a chur i gcomparáid.

Úsáidtear orduithe Python i dtionscadail Python VEXcode V5. Úsáideann bloic agus tionscadail C++ na rannóga API eile ina ionad.

Conas Iontráil Modhanna a Léamh#

Tá na codanna seo a leanas i bhformhór na n-iontrálacha Python:

  • Ainm an ordaithe - Ainm oifigiúil an ordaithe, an mhodha, nó na feidhme.

  • Cur Síos - Míníonn sé cad a dhéanann an t-ordú agus cathain a bhíonn sé úsáideach.

  • Úsáid - Taispeánann sé an comhréir a úsáidtear chun an t-ordú a scríobh i gcód.

  • Paraiméadair - Liostaítear na hionchuir a nglacann an t-ordú leo agus mínítear cad a dhéanann gach ceann acu.

  • Luach fillte - Míníonn sé cad a thuairiscíonn an t-ordú ar ais, má thugann sé luach ar ais.

  • Cód samplach - Taispeánann sé bealach amháin ar féidir an t-ordú a úsáid i dtionscadal.

Eilimintí Coitianta API Python#

Eilimint

Cad is brí leis

Modh

Ordú a ghlaotar ar réad amhail drivetrain.drive(…).

Feidhm

Ordú a ghlaoitear go díreach, amhail wait(…) nó print(…).

Paraiméadar

Luach a chuirtear isteach i modh nó i bhfeidhm chun a bhfuil á dhéanamh aige a rialú.

Paraiméadar roghnach

Paraiméadar is féidir a fhágáil ar lár ionas go n-úsáidtear an t-iompar réamhshocraithe.

Luach fillte

Luach a thuairiscíonn ordú ar ais, amhail uimhir, téacs, nó luach Booleanach.

Stór Focal Bunúsach Python#

Téarma

Cad is brí leis

Athraitheach

Ainm a stórálann luach, amhail speed = 50.

Teaghrán

Téacs idir comharthaí athfhriotail, amhail “Hello”.

Slánuimhir

Uimhir dhearfach nó dhiúltach, amhail 90.

Snámh

Uimhir le deachúil, amhail 25.5.

Booléanach

Luach atá True nó False.

Argóint

Luach a chuirtear isteach i nglao modha nó feidhme, amhail 360.0 in drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS).

Iontráil Modh Samplach#

tiomáint#

Tiomántán drive ag bogadh an róbat ar aghaidh nó ar gcúl go deo. Leanfaidh an róbat ag bogadh go dtí go dtabharfar gníomh eile dó, amhail casadh nó stopadh. Maidir le RPM nó céimeanna in aghaidh an tsoicind, athraítear an teorainn de réir chóimheas giaranna an traein tiomána.

Usage:
drivetrain.drive(direction, velocity, units)

Paraiméadair

Cur síos

direction

An treo a mbogann an róbat: FORWARD nó REVERSE.

velocity

Roghnach. An luas le tiomáint leis ó 0% go 100% agus PERCENT, ó 0 go 600 rpm agus RPMá úsáid , nó ó 0 go 3600 céim in aghaidh an tsoicind agus VelocityUnits.DPSá úsáid . Is féidir leis seo a bheith ina shlánuimhir integer nó ina dheachúil (float). Mura soláthraítear aon luas, tiomáineann an róbat ag an luas tiomána reatha.

units

Roghnach. An t-aonad luais: RPM (rothlaithe in aghaidh an nóiméid, réamhshocraithe), PERCENT, nó VelocityUnits.DPS (céimeanna in aghaidh an tsoicind).

# Drive forward, then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)