Skip to content

jaxa/int-ball2_simulator

Repository files navigation

Int-Ball2 Simulator


Overview

Int-Ball2 (JEM Internal Ball Camera 2 System) is a free-flying camera robot deployed in the ISS Japan Experimental Module (JEM). It is remotely controlled from the ground to capture video images and support astronauts. Additionally, Int-Ball2 can run user-developed software as an extended functionality and can be used as a platform for demonstrating robotic technology in space.

This Repository provides a ROS + Gazebo-based simulator for Int-Ball2. It simulates Int-Ball2's behavior in the ISS/JEM environment with user-developed programs.

Key Features

  • ROS/Gazebo Simulator: Simulates Int-Ball2's behavior in the ISS/JEM environment. It includes a plugin simulating the airflow, sensor data acquisition, and actuator control interfaces for Int-Ball2 (SLAM is not simulated).
  • User Program Interface: Allows users to add new functionalities (e.g., navigation or control algorithms) within Docker containers.
  • User Program Ground Support Equipment (GSE): Simulates the GUI of the GSE for user program deployment in actual operations. Enables telemetry reception and command transmission for realistic operational workflows. User programs can be started or stopped from the GSE. (Note: This is not the GSE for nominal Int-Ball2 video-taking operations.)

Requirements

  • Operating System: Ubuntu 18.04 Bionic
  • ROS Version: ROS 1 Melody (Python3)
  • Gazebo Version: Gazebo 9

Additional libraries:

Name Version
NumPy 1.18.2
EmPy 3.3.4
NASM 2.15.05
FFmpeg 4.1.3
VLC 3.0.7.1
Qt 5.12.3

Installation

See INSTALL.md for installation instructions.
Additional information can be found in the Int-Ball2 Technology Demonstration Platform User's Manual.

Project Structure

.
├── Int-Ball2_platform_gse/        # Ground Support Equipment S/W
│   └── ...
├── Int-Ball2_platform_simulator/  # 3D Simulator
│   └── ...
├── docs/ 
│   ├── manual/ 
│   │   ├── Int-Ball2 Technology Demonstration Platform User's Manual.pdf  # Manual
│   │   └── Int-Ball2ユーザプラットフォームマニュアル.pdf                     # Manual(JP)
│   └── ...
├── README.md
└── README_JP.md

Troubleshooting

  • Common Issues
    • (TBD)
  • Further Assistance If you encounter other issues, please open an Issue on GitHub.

Contributing

We welcome and appreciate your contributions!

  • Pull Requests: Submit fixes or new features. Please open an Issue first if it’s a major change.

License

Copyright (c) 2023, Japan Aerospace Exploration Agency. All rights reserved.

The Int-Ball2 simulator and user programming platform is licensed under the Apache License, Version 2.0. Software is distributed on an "AS IS" basis, withouth warranties. See the license for details.

Referencess

About Int-Ball2

Others

Future Plans

Stay tuned for updates!