Skip to content

Commit

Permalink
Minor documentation updates
Browse files Browse the repository at this point in the history
  • Loading branch information
matthewreyna committed Apr 20, 2017
1 parent fc12876 commit 8777e64
Show file tree
Hide file tree
Showing 3 changed files with 8 additions and 4 deletions.
6 changes: 5 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,19 +40,23 @@ The C and Fortran extensions are not required, but will significantly speed up H

#### Recent update ####

We recently updated HotNet2 to simplify usage. This update requires some updates to your scripts and data. Consult [`the previous README`](https://github.com/raphael-group/hotnet2/master/paper/OLD-README.md) for comparison.
We recently updated HotNet2 to simplify usage. This update requires some updates to your scripts and data. Consult the [previous README](https://github.com/raphael-group/hotnet2/master/paper/OLD-README.md) for comparison.

#### Data preprocessing ####

* **Heat scores**. Use `makeHeatFile.py` to create a JSON file of gene heat scores (weights). These scores can be generated from mutation data or from several other formats. `HotNet2.py` requires a path to at least one heat file as input.
* **Interaction network**. Use `makeNetworkFiles.py` to generate the network files required for running HotNet2. These include the influence matrix of your input network, and permuted networks and their corresponding influence matrices. Each of these files are in HDF5 (`.h5`) format. `HotNet2.py` requires at least one network file and path to the permuted network files as input.

See [`paper/paper_commands.sh`](https://github.com/raphael-group/hotnet2/master/paper/paper_commands.sh) for examples of using the `makeHeatFile.py` and `makeNetworkFiles.py` scripts.

#### HotNet2 ####

After generating a heat file and the network files using the scripts above, use the `HotNet2.py` script to run HotNet2. The minimum arguments required for `HotNet2.py` are as follows:

python HotNet2.py -nf <network_file> -pnp <permuted_networks_path> -hf <heat_file> -o <output_directory>

See [`paper/paper_commands.sh`](https://github.com/raphael-group/hotnet2/master/paper/paper_commands.sh) for an example of using the `HotNet2.py` scripts with outputs of the `makeHeatFile.py` and `makeNetworkFiles.py` scripts.

The output of `HotNet2.py` consists of a directory containing the following:
* `{network_name}-{heat_name}/`: For each (network, heat score) pair, `HotNet2.py` outputs a directory of results. The directory contains subdirectories starting with "delta" for each delta parameter tested, each of which contain the subnetworks and statistical signifciance associated with that delta parameter.
* `consensus/`: The `consensus/` directory contains the consensus file across all networks and heat scores,
Expand Down
3 changes: 2 additions & 1 deletion paper/paper_commands.sh
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,9 @@

# These commands run HotNet2 on the processed network and mutation data used for our Nature Genetics paper.

# Set location of HotNet2, number of cores, number of network permutations, and number of heat permutations.
hotnet2=..
num_cores=8
num_cores=-1
num_network_permutations=100
num_heat_permutations=1000

Expand Down
3 changes: 1 addition & 2 deletions scripts/createInfluenceMatrix.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@
sys.path.append(os.path.normpath(os.path.dirname(os.path.realpath(__file__)) + '/../'))
from hotnet2 import *


# Parse arguments
def get_parser():
# Common arguments
Expand All @@ -23,7 +22,7 @@ def get_parser():
parser.add_argument('-v', '--verbose', required=False, default=0, type=int, choices=range(5),
help="Control verbosity of output.")

# Subparsers for the different
# Subparsers for the different diffusion types
subparser = parser.add_subparsers(dest='diffusion_type', help='Diffusion method')

hn2_parser = subparser.add_parser(HOTNET2)
Expand Down

0 comments on commit 8777e64

Please sign in to comment.