RLDIF

Welcome to RLDIF! This README contains detailed instructions for configuring and running RLDIF both locally and in a Docker instance. Please read through carefully to ensure successful execution.

Config File Instructions

To begin, modify the config file located in the config directory. Only change the parameters listed below. Do not alter any other part of the config file.

Parameters

• name (str):
  The name of the result file when running in inference mode.

• inference (bool):
  Set to true for inference mode (implemented) or false for training mode (to be implemented).

• protein_mpnn (bool):
  Enable or disable running inference with ProteinMPNN.

• rldif (bool):
  Enable or disable running inference or finetuning with RLDIF.

• esmif (bool):
  Enable or disable running inference with ESMIF.

• dif_large (bool):
  Enable or disable running inference or finetuning with DIF_Large.

• temp (float):
  Set to false for no temperature sampling (applies to DIF_Large and RLDIF). For ProteinMPNN or ESMIF, provide a float between 0 and 1 to specify temperature sampling.

• docker (bool):
  Set to true if running in a Docker instance; otherwise, set to false.

• free_positions (bool):
  Specify if free positions should be considered.

• num_samples (int):
  Number of samples for inference or fine-tuning.

• custom_pdb_input:
  The name of the input CSV file. When running a regular inference script, provide the absolute path. Refer to Dockerfile instructions for running within a Docker file.

Running Inference

After updating the config file with the required parameters, execute the following command from the appropriate directory:

python -m run.run

Dockerfile Instructions

To build and run the Docker instance for inference, follow these steps:

1. Build the Docker Image:

   From the main directory containing the pre-build Docker, run:

   docker load -i inverse_folding.tar

2. Run the Docker Instance:

Directory Structure:
To run inference on a set of PDB files, create a directory and ensure it contains:

1. A config file: Copy from the configs directory and modify necessary parameters. Make sure to set the docker parameter to be true
2. An input CSV file: This should have two columns - the absolute path to the PDB file and the chain ID(s) desired.
3. The PDB files to be used for inference.

Use the command below to run the Docker instance for inference:

 docker run --rm -e PDB_BASE_PATH=/usr/src/app/input_files/ -v /home/input_file_directory/:/usr/src/app/input_files/ --gpus all inverse_folding

Ensure that you provide the absolute path in place of /home/input_file_directory/.