Page tree
Skip to end of metadata
Go to start of metadata


User Configuration

Distruct is installed on the HPCC and can be accessed using:


module load distruct


It is important to note that in order to use distruct, a parameter file needs to be read which defaults to the name "drawparams".  The distruct application assumes by default, that this file is located in the current directory.  Therefore, you can address this in a couple of different ways:

By Program Flag

Use the "-d" program flag to specify the location and name of the parameter file you wish to use.  For example:


module load distruct
distruct -d ~/myparams


By Copying

You can retrieve a copy of the default parameter file and place it in your working directory.  Make whatever modifications you'd like to this file, and then run distruct.  You can find a copy here:


cp /mnt/research/common-data/Bio/distruct/drawparams .
module load distruct


Bulk Copy

You can synch the entire installation directory to your home, research or scratch space:


rsync -av /opt/software/distruct .
cd distruct
cd 1.1


Q-Matrix Files

The location and names of Q-Matrix files are specified in the distruct configuration file.  If you use the default "drawparams" file, note that distruct will look for the Q-Matrix files "casia.popq" and "casia.indivq" in the current directory.  Once again, you can address this issue by either:

  1. Changing the configuration file to point to the correct location of these files
  2. Copying these files to your working directory from /mnt/research/common-data/Bio/distruct
  3. Synching the entire installation directory to your working directory.
  4. Passing the locations of these files into distruct via the command line

An example of #4 above would be the following:


module load distruct
distruct -d ~/drawparams -p /opt/software/distruct/1.1/casia.popq -i /opt/software/distruct/1.1/casia.indivq


In this example, we use a copy of the configuration file in our home directory, and point to the installation directory for the Q-Matrix files.  Several of the parameters contained in the distruct configuration file can be overridden on the command line.

More Information

For more information, see the distruct user documentation.