Skip to content

Official Repository for CoRL 2025 paper: "Learning Smooth State-Dependent Traversability from Dense Point Clouds".

Notifications You must be signed in to change notification settings

neu-autonomy/SPARTA

Repository files navigation

SPARTA: Learning Smooth State-Dependent Traversability from Dense Point CLouds

Zihao Dong1, Alan Papalia12, Leonard Jung1, Alenna Spiro1, Philip R. Osteen3, Christa S. Robison3, Michael Everett1

1Northeastern Univeristy, 2University of Michigan, Ann Arbor, 3 DEVCOM Army Research Laboratory (ARL)

Official Repository for CoRL 2025 paper: Learning Smooth State-Dependent Traversability from Dense Point Clouds.

Updates

  • Code: Our code for training pipeline, model checkpoints, and a simulated experiment with unicycle dynamics, has been released!

About

In our paper SPARTA, we propose a novel method to predict traversability conditioned on vehicle approach angle, and a dense point cloud representation of the terrain. Instead of directly encoding the approach angle as model input, our model takes in the point cloud and predicts an analytical function (represented using Fourier basis functions) that maps angle of approach to the target risk variable distribution. The function, once computed for a terrain patch, can be queried efficiently with minimal computation overhead for any angle of approach at any timestep when integrated with modern planners like MPPI. This repositiory contains the official training pipeline, model checkpoints, and a simulated experiment using unicycle dynamics.

CoRL_Spotlight_Video.mp4

Installation

  1. Clone this repository:
git clone [email protected]:neu-autonomy/SPARTA.git
  1. Dependencies:
  • Install dependencies using mamba (recommanded) or conda:
mamba env create -f sparta_environment.yml
python setup.py build_ext --inplace
pip install .
  • Important: A common failure when installing the pointpillars backbone is a CUDA version mismatch. To solve the problem, make sure your installed pytorch version uses the SAME cuda version as in your system level. For example, if your system level cuda is 11.8, make sure to install pytorch 2.x.x+cu118.

Dataset

Our dataset can be downloaded at: google drive. After downloading the dataset, unzip and place the folder under SPARTA/beamng_dataset.

Expected directory structure:

SPARTA \
- beamng_dataset\
- - tech_ground_deformation_distribution_raw\
- - - train\
- - - - ...
- - - test\
- - - - ...

Training

Start training by running:

# For angle-conditioned model: 
python3 train_terrain_traversability_with_angle.py --config config/tire_deformation_fouer_new.yaml

# For angle-free model:
pythoh3 train_terrain_traversability_angle_free.py --config config/tire_deformation_angle_free.yaml

The config files for the hyperparameters can be found under the folder SPARTA/config. Note re-running training with same config files will override checkpoints saved in SPARTA/checkpoints/{experiment_name}.

The training progress is logged via tensorboard, whose logdir is specified in the config files under train -> logdir. (Note: we improved the training pipeline for AngleInput and managed to achieve a ~0.015 lower test EMD2 loss as reported in the initial manuscript)


Evaluation on Unicycle

We have re-created the environment for our hardware experiment using a simplified unicycle dynamics model.

  • First download the dense point cloud of the obstacles. The google drive folder also contains the coefficient/elevation maps we generated with our trained checkpoints. The files should be placed under SPARTA/example.

  • To run the example:

# Precompute the Fourier coefficients and elevation map
python3 -m example.precompute_coefficients

# Running simulated experiments using MPPI + Unicycle
python3 -m example.mppi_unicycle
  • Expected output using our checkpoint (tire_deformation_fourier_new): While our model consistently identifies the safe path (left) in all 10 trials, the elevation baseline treats the passage ways as equally risky, and consistently choose the risky path then the goal is to its right.

 

Citation

@article{dong2025learning,
  title={Learning Smooth State-Dependent Traversability from Dense Point Clouds},
  author={Dong, Zihao and Papalia, Alan and Jung, Leonard and Spiro, Alenna and Osteen, Philip R and Robison, Christa S and Everett, Michael},
  journal={arXiv preprint arXiv:2506.04362},
  year={2025}
}

Acknowledgement

Our backbone is built from the pointpillars.

About

Official Repository for CoRL 2025 paper: "Learning Smooth State-Dependent Traversability from Dense Point Clouds".

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published