JMOT.craft

  1from JMOT import connect, extra
  2from typing import Literal
  3import numpy as np
  4
  5_CRAFT_INFO_SIGNAL = {
  6    'name' : 200,
  7    'target_craftname' : 201,
  8    'craftname_of_craftID' : 202,
  9    'part_count_of_craftID' : 203,
 10    'craftID_of_craftname' : 204,
 11    'planet_of_craft' : 205
 12}
 13
 14class info:
 15    def name()->str:
 16        '''Get the current vessel's name.'''
 17        rec = connect._send_message(f"true<<{_CRAFT_INFO_SIGNAL['name']}")
 18        return rec[0]
 19    def target_craftname()->str:
 20        '''Get the name of the current vessel's target.'''
 21        rec = connect._send_message(f"true<<{_CRAFT_INFO_SIGNAL['target_craftname']}")
 22        return rec[0]
 23    def craftname_of_craftID(craft_ID:int)->str:
 24        '''Get the name of a vessel by its craft ID.'''
 25        rec = connect._send_message(f"true<<{_CRAFT_INFO_SIGNAL['craftname_of_craftID']}<<{craft_ID}")
 26        return rec[0]
 27    def part_count_of_craftID(craft_ID:int)->int:
 28        '''Get the part count of a vessel by its craft ID.'''
 29        rec = connect._send_message(f"true<<{_CRAFT_INFO_SIGNAL['part_count_of_craftID']}<<{craft_ID}")
 30        return rec[0]
 31    def craftID_of_craftname(craft_name:str)->int:
 32        '''Get the craft ID of a vessel by its name.'''
 33        rec = connect._send_message(f"true<<{_CRAFT_INFO_SIGNAL['craftID_of_craftname']}<<{craft_name}")
 34        return rec[0]
 35    def planet_of_craft(craft_ID:int)->str:
 36        '''Get the name of the planet that a vessel is currently orbiting.'''
 37        rec = connect._send_message(f"true<<{_CRAFT_INFO_SIGNAL['planet_of_craft']}<<{craft_ID}")
 38        return rec[0]
 39
 40_CRAFT_FUEL_SIGNAL = {
 41    'battery' : 225,
 42    'stage_fuel' : 226,
 43    'mono_fuel' : 227,
 44    'all_stage_fuel' : 228
 45}
 46
 47class fuel:
 48    def battery()->float:
 49        '''Get the current total battery percentage of the vessel.'''
 50        rec = connect._send_message(f"true<<{_CRAFT_FUEL_SIGNAL['battery']}")
 51        return rec[0]
 52    def stage_fuel()->float:
 53        '''Get the current fuel mass percentage of the active stage.'''
 54        rec = connect._send_message(f"true<<{_CRAFT_FUEL_SIGNAL['stage_fuel']}")
 55        return rec[0]
 56    def mono_fuel()->float:
 57        '''Get the current monopropellant mass percentage of the vessel.'''
 58        rec = connect._send_message(f"true<<{_CRAFT_FUEL_SIGNAL['mono_fuel']}")
 59        return rec[0]
 60    def all_stage_fuel()->float:
 61        '''Get the current fuel mass percentage of all stages.'''
 62        rec = connect._send_message(f"true<<{_CRAFT_FUEL_SIGNAL['all_stage_fuel']}")
 63        return rec[0]
 64
 65_CRAFT_PERFORMANCE_SIGNAL = {
 66    'current_engine_thrust' : 230,
 67    'mass' : 231,
 68    'dry_mass' : 232,
 69    'fuel_mass' : 233,
 70    'max_engine_thrust' : 234,
 71    'TWR' : 235,
 72    'ISP' : 236,
 73    'stage_delta_v' : 237,
 74    'stage_burn_time' : 238,
 75    'solar_radition' : 239,
 76    'craft_mass' : 240
 77}
 78
 79class performance:
 80    def current_engine_thrust()->float:
 81        '''Get the current total thrust of all active engines in N.'''
 82        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['current_engine_thrust']}")
 83        return rec[0]
 84    def mass()->float:
 85        '''Get the current mass of the vessel in kg.'''
 86        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['mass']}")
 87        return rec[0]
 88    def dry_mass()->float:
 89        '''Get the current dry mass of the vessel in kg.'''
 90        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['dry_mass']}")
 91        return rec[0]
 92    def fuel_mass()->float:
 93        '''Get the current fuel mass of the vessel in kg.'''
 94        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['fuel_mass']}")
 95        return rec[0]
 96    def max_engine_thrust()->float:
 97        '''Get the maximum total thrust of all engines in N.'''
 98        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['max_engine_thrust']}")
 99        return rec[0]
100    def TWR()->float:
101        '''Get the current TWR of the vessel.'''
102        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['TWR']}")
103        return rec[0]
104    def ISP()->float:
105        '''Get the current ISP of the vessel in seconds.'''
106        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['ISP']}")
107        return rec[0]
108    def stage_delta_v()->float:
109        '''Get the delta-v of the current stage in m/s.'''
110        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['stage_delta_v']}")
111        return rec[0]
112    def stage_burn_time()->float:
113        '''Get the burn time of the current stage in seconds.'''
114        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['stage_burn_time']}")
115        return rec[0]
116    def solar_radition()->float:
117        '''Get the solar radiation at the current vessel's location in W/m^2.'''
118        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['solar_radition']}")
119        return rec[0]
120    def craft_mass(craft_ID:int)->float:
121        '''Get the mass of a vessel by its craft ID in kg.'''
122        rec = connect._send_message(f"true<<{_CRAFT_PERFORMANCE_SIGNAL['craft_mass']}<<{craft_ID}")
123        return rec[0]
124
125
126_CRAFT_ATTITUDE_SIGNAL = {
127    'craft_heading' : 250,
128    'craft_pitching' : 251,
129    'craft_autopilot_heading' : 252,
130    'craft_autopilot_pitching' : 253,
131    'craft_bank_angle' : 254,
132    'craft_AOA' : 265,
133    'craft_side_slip': 256,
134    'craft_north_vector' : 257,
135    'craft_east_vector' : 258,
136    'craft_roll_axis' : 259,
137    'craft_pitch_axis' : 260,
138    'craft_yaw_axis' : 261
139}
140
141class attitude:
142    def craft_heading()->float:
143        '''
144        Get the current vessel's heading in degrees.\n
145        0 degrees means the vessel is heading towards the north
146        and the angle increases clockwise.
147        '''
148        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_heading']}")
149        return rec[0]
150    def craft_pitching()->float:
151        '''
152        Get the current vessel's pitching in degrees.\n
153        90 degrees means the vessel is flying vertically,
154        0 degrees means the vessel is flying horizontally.
155        '''
156        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_pitching']}")
157        return rec[0]
158    def craft_autopilot_heading()->float:
159        '''Get the current vessel's autopilot heading in degrees.'''
160        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_autopilot_heading']}")
161        return rec[0]
162    def craft_autopilot_pitching()->float:
163        '''Get the current vessel's autopilot pitching in degrees.'''
164        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_autopilot_pitching']}")
165        return rec[0]
166    def craft_bank_angle()->float:
167        '''Get the current vessel's bank angle in degrees.'''
168        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_bank_angle']}")
169        return rec[0]
170    def craft_AOA()->float:
171        '''Get the current vessel's angle of attack in degrees.'''
172        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_AOA']}")
173        return rec[0]
174    def craft_side_slip()->float:
175        '''Get the current vessel's side slip angle in degrees.'''
176        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_side_slip']}")
177        return rec[0]
178    def craft_north_vector()->np.ndarray:
179        '''Get the current vessel's north vector in ECI coordinates.'''
180        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_north_vector']}")
181        vec = extra.tuple2array(rec[0])
182        return vec
183    def craft_east_vector()->np.ndarray:
184        '''Get the current vessel's east vector in ECI coordinates.'''
185        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_east_vector']}")
186        vec = extra.tuple2array(rec[0])
187        return vec
188    def craft_roll_axis()->np.ndarray:
189        '''Get the current vessel's roll axis in ECI coordinates.'''
190        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_roll_axis']}")
191        vec = extra.tuple2array(rec[0])
192        return vec
193    def craft_pitch_axis()->np.ndarray:
194        '''Get the current vessel's pitch axis in ECI coordinates.'''
195        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_pitch_axis']}")
196        vec = extra.tuple2array(rec[0])
197        return vec
198    def craft_yaw_axis()->np.ndarray:
199        '''Get the current vessel's yaw axis in ECI coordinates.'''
200        rec = connect._send_message(f"true<<{_CRAFT_ATTITUDE_SIGNAL['craft_yaw_axis']}")
201        vec = extra.tuple2array(rec[0])
202        return vec
203
204_CRAFT_VELOCITY_SIGNAL = {
205    'surface_velocity' : 270,
206    'orbit_velocity' : 271,
207    'target_velocity' : 272,
208    'gravity' : 273,
209    'drag' : 274,
210    'acceleration' : 275,
211    'angular' : 276,
212    'lateral' : 277,
213    'vertical' : 278,
214    'mach_number' : 279,
215    'craft_velocity' : 280
216}
217
218class velocity:
219    def surface_velocity()->np.ndarray:
220        '''Get the current vessel's surface velocity in ECI coordinates.'''
221        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['surface_velocity']}")
222        vec = extra.tuple2array(rec[0])
223        return vec
224    def orbit_velocity()->np.ndarray:
225        '''Get the current vessel's orbit velocity in ECI coordinates.'''
226        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['orbit_velocity']}")
227        vec = extra.tuple2array(rec[0])
228        return vec
229    def target_velocity()->np.ndarray:
230        '''Get the current vessel's target velocity in ECI coordinates.'''
231        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['target_velocity']}")
232        vec = extra.tuple2array(rec[0])
233        return vec
234    def gravity()->np.ndarray:
235        '''Get the current vessel's gravity in ECI coordinates.'''
236        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['gravity']}")
237        vec = extra.tuple2array(rec[0])
238        return vec
239    def drag()->np.ndarray:
240        '''Get the current vessel's drag in ECI coordinates.'''
241        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['drag']}")
242        vec = extra.tuple2array(rec[0])
243        return vec
244    def acceleration()->np.ndarray:
245        '''Get the current vessel's acceleration in ECI coordinates.'''
246        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['acceleration']}")
247        vec = extra.tuple2array(rec[0])
248        return vec
249    def angular()->np.ndarray:
250        '''Get the current vessel's angular velocity in ECI coordinates.'''
251        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['angular']}")
252        vec = extra.tuple2array(rec[0])
253        return vec
254    def lateral()->float:
255        '''Get the current vessel's lateral velocity in m/s.'''
256        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['lateral']}")
257        return rec[0]
258    def vertical()->float:
259        '''Get the current vessel's vertical velocity in m/s.'''
260        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['vertical']}")
261        return rec[0]
262    def mach_number()->float:
263        '''Get the current vessel's Mach number.'''
264        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['mach_number']}")
265        return rec[0]
266    def craft_velocity(craft_ID:int)->np.ndarray:
267        '''Get the velocity of a vessel by its craft ID in ECI coordinates.'''
268        rec = connect._send_message(f"true<<{_CRAFT_VELOCITY_SIGNAL['craft_velocity']}")
269        vec = extra.tuple2array(rec[0])
270        return vec
271    
272_CRAFT_POSITION_SIGNAL = {
273    'AGL' : 290,
274    'ASL' : 291,
275    'ASF' : 292,
276    'craft_ASL' : 293,
277    'is_ground' : 294,
278    'craft_is_ground' : 295,
279    'ECI_position' : 296,
280    'target_ECI_position' : 297,
281    'craft_ECI_position' : 298
282}
283
284class position:
285    def AGL()->float:
286        '''Get the current vessel's altitude above ground level in meters.'''
287        rec = connect._send_message(f"true<<{_CRAFT_POSITION_SIGNAL['AGL']}")
288        return rec[0]
289    def ASL()->float:
290        '''Get the current vessel's altitude above sea level in meters.'''
291        rec = connect._send_message(f"true<<{_CRAFT_POSITION_SIGNAL['ASL']}")
292        return rec[0]
293    def ASF()->float:
294        '''Get the current vessel's altitude above seabed in meters.'''
295        rec = connect._send_message(f"true<<{_CRAFT_POSITION_SIGNAL['ASF']}")
296        return rec[0]
297    def craft_ASL(craft_ID:int)->float:
298        '''Get the altitude above sea level of a vessel in meters.'''
299        rec = connect._send_message(f"true<<{_CRAFT_POSITION_SIGNAL['craft_ASL']}<<{craft_ID}")
300        return rec[0]
301    def is_ground()->bool:
302        '''Get whether the current vessel is on the ground.\n
303        T means the vessel is on the ground, F means it's not.
304        '''
305        rec = connect._send_message(f"true<<{_CRAFT_POSITION_SIGNAL['is_ground']}")
306        return rec[0]
307    def craft_is_ground(craft_id:int)->bool:
308        '''Get whether a vessel is on the ground.\n
309        T means the vessel is on the ground, F means it's not.
310        '''
311        rec = connect._send_message(f"true<<{_CRAFT_POSITION_SIGNAL['craft_is_ground']}<<{craft_id}")
312        return rec[0]
313    def ECI_position()->np.ndarray:
314        '''Get the current vessel's position in ECI coordinates.'''
315        rec = connect._send_message(f"true<<{_CRAFT_POSITION_SIGNAL['ECI_position']}")
316        vec = extra.tuple2array(rec[0])
317        return vec
318    def target_ECI_position()->np.ndarray:
319        '''Get the target vessel's position in ECI coordinates.'''
320        rec = connect._send_message(f"true<<{_CRAFT_POSITION_SIGNAL['target_ECI_position']}")
321        vec = extra.tuple2array(rec[0])
322        return vec
323    def craft_ECI_position(craft_ID:int)->np.ndarray:
324        '''Get the position of a vessel by its craft ID in ECI coordinates.'''
325        rec = connect._send_message(f"true<<{_CRAFT_POSITION_SIGNAL['craft_ECI_position']}<<{craft_ID}")
326        vec = extra.tuple2array(rec[0])
327        return vec
328
329
330_CRAFT_ORBIT_SIGNAL = {
331    'apoapsis' : 305,
332    'periapsis' : 306,
333    'apoapsis_time' : 307,
334    'periapsis_time' : 308,
335    'eccentricity' : 309,
336    'inclination' : 310,
337    'period' : 311,
338    'craft_apoapsis_position' : 312,
339    'craft_periapsis_position' : 313,
340    'craft_period' : 314,
341    'craft_apoapsis_time' : 315,
342    'craft_periapsis_time' : 316,
343    'craft_inclination' : 317,
344    'craft_eccentricity' : 318,
345    'craft_mean_anomaly' : 319,
346    'craft_mean_motion' : 320,
347    'craft_periapsis_argument' : 321,
348    'craft_right_ascension' : 322,
349    'craft_true_anomaly' : 323,
350    'craft_SMA' : 324
351}
352
353class orbit:
354    def apoapsis()->float:
355        '''Get the current vessel's apoapsis altitude in meters.'''
356        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['apoapsis']}")
357        return rec[0]
358    def periapsis()->float:
359        '''Get the current vessel's periapsis altitude in meters.'''
360        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['periapsis']}")
361        return rec[0]
362    def apoapsis_time()->float:
363        '''Get the time to current vessel's apoapsis in seconds.'''
364        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['apoapsis_time']}")
365        return rec[0]
366    def periapsis_time()->float:
367        '''Get the time to current vessel's periapsis in seconds.'''
368        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['periapsis_time']}")
369        return rec[0]
370    def eccentricity()->float:
371        '''Get the eccentricity of the current vessel's orbit.'''
372        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['eccentricity']}")
373        return rec[0]
374    def inclination()->float:
375        '''Get the inclination of the current vessel's orbit in radians.'''
376        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['inclination']}")
377        return rec[0]
378    def period()->float:
379        '''Get the current vessel's orbital period in seconds.'''
380        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['period']}")
381        return rec[0]
382    def craft_apoapsis_position(craft_ID:int)->np.ndarray:
383        '''Get the apoapsis position of a vessel by its craft ID in ECI coordinates.'''
384        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_apoapsis_position']}<<{craft_ID}")
385        vec = extra.tuple2array(rec[0])
386        return vec
387    def craft_periapsis_position(craft_ID:int)->np.ndarray:
388        '''Get the periapsis position of a vessel by its craft ID in ECI coordinates.'''
389        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_periapsis_position']}<<{craft_ID}")
390        vec = extra.tuple2array(rec[0])
391        return vec
392    def craft_period(craft_ID:int)->float:
393        '''Get the orbital period of a vessel by its craft ID in seconds.'''
394        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_period']}<<{craft_ID}")
395        return rec[0]
396    def craft_apoapsis_time(craft_ID:int)->float:
397        '''Get the time to current vessel'''
398        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_apoapsis_time']}<<{craft_ID}")
399        return rec[0]
400    def craft_periapsis_time(craft_ID:int)->float:
401        '''Get the time to current vessel's periapsis in seconds.'''
402        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_periapsis_time']}<<{craft_ID}")
403        return rec[0]
404    def craft_inclination(craft_ID:int)->float:
405        '''Get the inclination of a vessel by its craft ID in radians.'''
406        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_inclination']}<<{craft_ID}")
407        return rec[0]
408    def craft_eccentricity(craft_ID:int)->float:
409        '''Get the eccentricity of a vessel by its craft ID.'''
410        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_eccentricity']}<<{craft_ID}")
411        return rec[0]
412    def craft_mean_anomaly(craft_ID:int)->float:
413        '''Get the mean anomaly of a vessel by its craft ID in radians.'''
414        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_mean_anomaly']}<<{craft_ID}")
415        return rec[0]
416    def craft_mean_motion(craft_ID:int)->float:
417        '''Get the mean motion of a vessel by its craft ID in radians/second.'''
418        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_mean_motion']}<<{craft_ID}")
419        return rec[0]
420    def craft_periapsis_argument(craft_ID:int)->float:
421        '''Get the argument of periapsis of a vessel by its craft ID in radians.'''
422        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_periapsis_argument']}<<{craft_ID}")
423        return rec[0]
424    def craft_right_ascension(craft_ID:int)->float:
425        '''Get the right ascension of a vessel by its craft ID in radians.'''
426        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_right_ascension']}<<{craft_ID}")
427        return rec[0]
428    def craft_true_anomaly(craft_ID:int)->float:
429        '''Get the true anomaly of a vessel by its craft ID in radians.'''
430        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_true_anomaly']}<<{craft_ID}")
431        return rec[0]
432    def craft_SMA(craft_ID:int)->float:
433        '''Get the semi-major axis of a vessel by its craft ID in meters.'''
434        rec = connect._send_message(f"true<<{_CRAFT_ORBIT_SIGNAL['craft_SMA']}<<{craft_ID}")
435        return rec[0]
436
437_CRAFT_INPUT_SIGNAL = {
438    'roll' : 330,
439    'pitch' : 331,
440    'yaw' : 332,
441    'throttle' : 333,
442    'brake' : 334,
443    'slider1' : 335,
444    'slider2' : 336,
445    'slider3' : 337,
446    'slider4' : 338,
447    'translate_foraward' : 339,
448    'translate_right' : 340,
449    'translate_up' : 341,
450    'translate_mode' : 342,
451    'pitch_pids' : 343,
452    'roll_pids' : 344
453}
454
455class input:
456    def roll()->float:
457        '''Get the current vessel's roll input value.'''
458        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['roll']}")
459        return rec[0]
460    def pitch()->float:
461        '''Get the current vessel's pitch input value.'''
462        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['pitch']}")
463        return rec[0]
464    def yaw()->float:
465        '''Get the current vessel's yaw input value.'''
466        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['yaw']}")
467        return rec[0]
468    def throttle()->float:
469        '''Get the current vessel's throttle input value.'''
470        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['throttle']}")
471        return rec[0]
472    def brake()->float:
473        '''Get the current vessel's brake input value.'''
474        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['brake']}")
475        return rec[0]
476    def slider1()->float:
477        '''Get the current vessel's slider1 input value.'''
478        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['slider1']}")
479        return rec[0]
480    def slider2()->float:
481        '''Get the current vessel's slider2 input value.'''
482        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['slider2']}")
483        return rec[0]
484    def slider3()->float:
485        '''Get the current vessel's slider3 input value.'''
486        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['slider3']}")
487        return rec[0]
488    def slider4()->float:
489        '''Get the current vessel's slider4 input value.'''
490        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['slider4']}")
491        return rec[0]
492    def translate_foraward()->float:
493        '''Get the current vessel's forward translation input value.'''
494        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['translate_foraward']}")
495        return rec[0]
496    def translate_right()->float:
497        '''Get the current vessel's right translation input value.'''
498        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['translate_right']}")
499        return rec[0]
500    def translate_up()->float:
501        '''Get the current vessel's up translation input value.'''
502        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['translate_up']}")
503        return rec[0]
504    def translate_mode()->float:
505        '''
506        Get the current vessel's translation mode input value.\n
507        0.0 is attitude mode, 1.0 is translate_mode.
508        '''
509        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['translate_mode']}")
510        return rec[0]
511    def pitch_pids()->np.ndarray:
512        '''Get the current vessel's pitch PID values as a numpy array.'''
513        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['pitch_pids']}")
514        vec = extra.tuple2array(rec[0])
515        return vec
516    def roll_pids()->np.ndarray:
517        '''Get the current vessel's roll PID values as a numpy array.'''
518        rec = connect._send_message(f"true<<{_CRAFT_INPUT_SIGNAL['roll_pids']}")
519        vec = extra.tuple2array(rec[0])
520        return vec
521    
522_CRAFT_STATUS_SIGNAL = {
523    'activing_stage' : 340,
524    'num_of_stage' : 341,
525    'ag_status' : 342,
526    'craft_is_destroyed' : 343,
527    'craft_is_player' : 344
528}
529
530class status:
531    def activing_stage()->int:
532        '''Get the current active stage number.'''
533        rec = connect._send_message(f"true<<{_CRAFT_STATUS_SIGNAL['activing_stage']}")
534        return rec[0]
535    def num_of_stage()->int:
536        '''Get the total number of stages.'''
537        rec = connect._send_message(f"true<<{_CRAFT_STATUS_SIGNAL['num_of_stage']}")
538        return rec[0]
539    def ag_status(ag:int)->bool:
540        '''Get the status of an action group.\n'''
541        rec = connect._send_message(f"true<<{_CRAFT_STATUS_SIGNAL['ag_status']}<<{ag}")
542        return rec[0]
543    def craft_is_destroyed(craft_ID:int)->bool:
544        '''Get the status of whether a vessel is destroyed.\n'''
545        rec = connect._send_message(f"true<<{_CRAFT_STATUS_SIGNAL['craft_is_destroyed']}<<{craft_ID}")
546        return rec[0]
547    def craft_is_player(craft_ID:int)->bool:
548        '''Get the status of whether a vessel is a player vessel.\n'''
549        rec = connect._send_message(f"true<<{_CRAFT_STATUS_SIGNAL['craft_is_player']}<<{craft_ID}")
550        return rec[0]