README.md

Unified Local-Cloud Decision-Making via Reinforcement Learning

Embodied vision-based real-world systems, such as mobile robots, require careful balancing between energy consumption, compute latency, and safety constraints to optimize operation across dynamic tasks and contexts. As local computation tends to be restricted, offloading the computation, i.e., to a remote server, can save local resources while providing access to high-quality predictions from powerful and large models. Yet, the resulting communication and latency overhead has led to limited usability of cloud models in dynamic, safety-critical, real-time settings. Towards effectively addressing this trade-off, in this work, we introduce UniLCD, a novel hybrid inference framework for enabling flexible local-cloud collaboration. By efficiently optimizing a flexible routing module via reinforcement learning and a suitable multi-task objective, UniLCD is specifically designed to support multiple constraints of safety-critical end-to-end mobile systems. We validate the proposed approach using a challenging crowded navigation task requiring frequent and timely switching between local and cloud operations. UniLCD demonstrates both improved overall performance and efficiency, by over 23% compared to state-of-the-art baselines based on various split computing strategies.

News

Directory Structure for Imitation Learning

The dataset has been collected while navigating through eight predefined routes in the Carla simulation. It includes images captured from the perspective of our ego walker, as well as detailed information about their actions and locations throughout the routes. Below is a brief overview of its contents and structure:

Images: The Images folder contains a series of visuals captured from the perspective of the ego walker. Each image provides a first-person view of the walker’s journey, offering a detailed depiction of the surrounding environment and context.

Info: The Info folder consists of numpy arrays with 7 columns:

• The first 2 columns correspond to the actions taken by the expert.
• The 3rd column indicates the presence (1) or absence (0) of pedestrians in the visible range.
• The following 2 columns represent the current location of the expert.
• The last 2 columns indicate the closest next path points to the expert.

UniLCD/ 
└──  Images/ 
    ├── 1.jpg 
    ├── 2.jpg 
    ├── ...   
    ├── 10.jpg 
    └── ... 
└── Info/ 
    ├── 1.npy 
    ├── 2.npy 
    ├── ... 
    ├── 10.npy 
    └── ...

Requirements

1. Python 3.7/8
2. Docker >=27.0

Setup

3. Clone this repository:

   git clone https://github.com/DIASENGUPTA/UniLCD.git
   cd UniLCD
   

4. Create a virtual environment and install the required dependences:

   pip install -r requirements.txt
   

5. Pull the CARLA 0.9.13 image for Docker:

   docker pull carlasim/carla:0.9.13
   

6. Modify the files inside unilcd_env to use your imitation-learning trained models as directed. Additionally, place the weights for your models in a directory of your choosing.

7. Install unilcd:

   pip install unilcd_env
   

8. Create a config file based on the sample config file provided. You can check the environments available by checking the envs folder for *env.py files.

9. Train Local and Cloud Policies:

   python unilcd_env/unilcd_env/envs/il_models/cloud_train.py
   python unilcd_env/unilcd_env/envs/il_models/local_train.py
   

10. Before running training/evaluation, start the CARLA Docker container:

    chmod +x ./run_carla_docker.sh
    ./run_carla_docker.sh start
    

11. Now, start your gym environment and train UniLCD:

    # Starter code for training UniLCD
    import unilcd_env
    import gymnasium as gym
    import json
    from stable_baselines3 import PPO
    
    config = json.load(open('unilcd_emb_eval_config.json'))
    env = gym.make(**config)
    env.reset()
    # Select your favorite RL algorithm and train. We recommend Stable Baselines3 for its integration with Gymnasium
    model = PPO("MlpPolicy", env)
    model.learn(total_timesteps=100000)

12. Evaluate UniLCD:

    # Starter code for evaluating UniLCD
    import unilcd_env
    import gymnasium as gym
    import json
    from stable_baselines3 import PPO
    from stable_baselines3.common.evaluation import evaluate_policy
    
    config = json.load(open('unilcd_emb_eval_config.json'))
    env = gym.make(**config)
    load_path=os.path.join(config.log_dir, "tmp/best_model.zip")
    model=PPO.load(load_path, env=vec_env)
    mean_reward, std_reward = evaluate_policy(model, model.get_env(), n_eval_episodes=3)
    print(mean_reward,std_reward)

13. Stop the CARLA Docker container:

    ./run_carla_docker.sh stop
    

Citation