Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 38 additions & 22 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -96,14 +96,16 @@ You can submit your dataset in any of the following formats:
- CSV (.csv)
- TSV (.tsv)

Please ensure that the dataset has a column 'Node' containing node IDs. If you only provide the node IDs, you can
also include a column in your dataset 'NodeType' indicating the entity type for each node. You can also optionally add
the following columns to your dataset:
Please ensure that the dataset minimally has a column 'Node' containing node IDs. You can also optionally add the
following columns to your dataset:

- NodeType
- LogFC [*]_
- p-value

.. [*] log :sub:`2` fold change
.. [*] |Log| fold change

.. |Log| replace:: Log\ :sub:`2`

Input dataset examples
~~~~~~~~~~~~~~~~~~~~~~
Expand All @@ -112,8 +114,22 @@ DiffuPath accepts several input formats which can be codified in different ways.
`diffusion scores <https://github.com/multipaths/DiffuPy/blob/master/docs/source/diffusion.rst>`_ summary for more
details.

1. You can provide a dataset with a column 'Node' containing node IDs along with a column 'NodeType' indicating the
entity type.
1. You can provide a dataset with a column 'Node' containing node IDs.

+------------+
| Node |
+============+
| A |
+------------+
| B |
+------------+
| C |
+------------+
| D |
+------------+

2. You can also provide a dataset with a column 'Node' containing node IDs as well as a column 'NodeType', indicating
the entity type of the node to run diffusion by entity type.

+------------+--------------+
| Node | NodeType |
Expand All @@ -127,34 +143,34 @@ entity type.
| D | Gene |
+------------+--------------+

2. You can also choose to provide a dataset with a column 'Node' containing node IDs as well as a column 'logFC' with
their log :sub:`2` FC.
3. You can also choose to provide a dataset with a column 'Node' containing node IDs as well as a column 'logFC' with
their LogFC. You may also add a 'NodeType' column to run diffusion by entity type.

+--------------+------------+
| Node | LogFC |
+==============+============+
| Gene A | 4 |
| A | 4 |
+--------------+------------+
| Gene B | -1 |
| B | -1 |
+--------------+------------+
| Metabolite C | 1.5 |
| C | 1.5 |
+--------------+------------+
| Gene D | 3 |
| D | 3 |
+--------------+------------+

3. Finally, you can provide a dataset with a column 'Node' containing node IDs, a column 'logFC' with their log :sub:`2`
FC and a column 'p-value' with adjusted p-values.
4. Finally, you can provide a dataset with a column 'Node' containing node IDs, a column 'logFC' with their logFC
and a column 'p-value' with adjusted p-values. You may also add a 'NodeType' column to run diffusion by entity type.

+--------------+------------+---------+
| Node | LogFC | p-value |
+==============+============+=========+
| Gene A | 4 | 0.03 |
| A | 4 | 0.03 |
+--------------+------------+---------+
| Gene B | -1 | 0.05 |
| B | -1 | 0.05 |
+--------------+------------+---------+
| Metabolite C | 1.5 | 0.001 |
| C | 1.5 | 0.001 |
+--------------+------------+---------+
| Gene D | 3 | 0.07 |
| D | 3 | 0.07 |
+--------------+------------+---------+

You can also take a look at our `sample datasets <https://github.com/multipaths/DiffuPy/tree/master/examples/datasets>`_
Expand Down Expand Up @@ -284,13 +300,13 @@ Custom-network example
~~~~~~~~~~~~~~~~~~~~~~

+-----------+--------------+-------------+
| Source | Target | Relation |
| Source | Target | Relation |
+===========+==============+=============+
| Gene A | Gene B | Increase |
| A | B | Increase |
+-----------+--------------+-------------+
| Gene B | Metabolite C | Association |
| B | C | Association |
+-----------+--------------+-------------+
| Gene A | Pathology D | Association |
| A | D | Association |
+-----------+--------------+-------------+

You can also take a look at our `sample networks <https://github.com/multipaths/DiffuPy/tree/master/examples/networks>`_
Expand Down
10 changes: 5 additions & 5 deletions docs/source/database.rst
Original file line number Diff line number Diff line change
Expand Up @@ -122,15 +122,15 @@ Custom-network example
+-----------+--------------+-------------+
| Source | Target | Relation |
+===========+==============+=============+
| Gene A | Gene B | Increase |
| A | B | Increase |
+-----------+--------------+-------------+
| Gene B | Metabolite C | Association |
| B | C | Association |
+-----------+--------------+-------------+
| Gene A | Pathology D | Association |
| A | D | Association |
+-----------+--------------+-------------+

You can also take a look at our Resources page for some example networks.

You can also take a look at our `sample networks <https://github.com/multipaths/DiffuPy/tree/master/examples/networks>`_
folder for some examples networks.

References
----------
Expand Down
2 changes: 1 addition & 1 deletion src/diffupath/cli.py
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ def diffusion():
)
@click.option(
'-a', '--absolute_value',
help='Codify node labels by applying threshold to |logFC| in input. If absolute_value is set to False, node labels '
help='Codify node labels by applying threshold to | logFC | in input. If absolute_value is set to False, node labels '
'will be signed.',
type=bool,
default=True,
Expand Down