# nmf2-paper

**Repository Path**: yu_duo/nmf2-paper

## Basic Information

- **Project Name**: nmf2-paper
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: as-published
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-15
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NeuroMechFly v2 Manuscript Repository

This repository contains the scripts to generate the figures and videos for the NeuroMechFly v2 paper. It is for archival purposes and will not be maintained.

To use NeuroMechFly, see the [FlyGym repository](https://github.com/NeLy-EPFL/flygym) and visit [neuromechfly.org](https://neuromechfly.org/).

## Instructions
Install the [`resubmission-20240501`](https://github.com/NeLy-EPFL/flygym/releases/tag/resubmission-20240501) snapshot of FlyGym.

Clone this repository:
```sh
git clone git@github.com:NeLy-EPFL/nmf2-paper.git
cd nmf2-paper
git checkout as-published
```

Create the conda environment using the provided `environment.yml` file:
```sh
conda env create --file environment.yml
```

If you are working on a machine without a display (e.g., a server), you will need to switch the renderer to EGL:
```sh
conda activate nmf2-paper
conda env config vars set MUJOCO_GL=egl PYOPENGL_PLATFORM=egl
conda deactivate
```

Some tasks require time-consuming data collection and training. To save time, you can download the data and trained models:
```sh
./download_data.sh
```

Generate the figures and videos by running the following script:
```sh
conda activate nmf2-paper
./generate_figures.sh
```

Note that the results may vary slightly due to differences in system architecture.