You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: prolif/fingerprint.py
+76-78Lines changed: 76 additions & 78 deletions
Original file line number
Diff line number
Diff line change
@@ -578,91 +578,91 @@ def run(
578
578
) ->"Fingerprint":
579
579
"""Generates the fingerprint on a trajectory for a ligand and a protein
580
580
581
-
Parameters
582
-
----------
583
-
traj : MDAnalysis.coordinates.base.ProtoReader or MDAnalysis.coordinates.base.FrameIteratorSliced or MDAnalysis.coordinates.base.FrameIteratorIndices or MDAnalysis.coordinates.timestep.Timestep
584
-
Iterate over this Universe trajectory or sliced trajectory object
585
-
to extract the frames used for the fingerprint extraction
586
-
lig : MDAnalysis.core.groups.AtomGroup
587
-
An MDAnalysis AtomGroup for the ligand
588
-
prot : MDAnalysis.core.groups.AtomGroup
589
-
An MDAnalysis AtomGroup for the protein (with multiple residues)
590
-
residues : list or "all" or None
591
-
A list of protein residues (:class:`str`, :class:`int` or
592
-
:class:`~prolif.residue.ResidueId`) to take into account for
593
-
the fingerprint extraction. If ``"all"``, all residues will be
594
-
used. If ``None``, at each frame the
595
-
:func:`~prolif.utils.get_residues_near_ligand` function is used to
596
-
automatically use protein residues that are distant of 6.0 Å or
597
-
less from each ligand residue.
598
-
converter_kwargs : tuple[dict, dict], optional
599
-
Tuple of kwargs passed to the underlying
600
-
:class:`~MDAnalysis.converters.RDKit.RDKitConverter` from MDAnalysis: the
601
-
first for the ligand, and the second for the protein
602
-
progress : bool
603
-
Display a :class:`~tqdm.std.tqdm` progressbar while running the calculation
604
-
n_jobs : int or None
605
-
Number of processes to run in parallel. If ``n_jobs=1``, the analysis
606
-
will run in serial. If ``n_jobs=None``, see
607
-
:func:`~prolif.parallel.get_n_jobs` for the default behavior.
608
-
parallel_strategy : {"chunk", "queue"}, optional
609
-
Strategy for parallel execution:
610
-
611
-
- ``"chunk"``: Split trajectory into chunks and distribute to workers.
612
-
Each worker pickles the full MDAnalysis objects once per chunk.
613
-
Scales better for small trajectories.
614
-
- ``"queue"``: Main thread converts frames to Molecules and enqueues
615
-
them for workers. Avoids repeated MDAnalysis pickling overhead.
616
-
Better when pickling is expensive, e.g. large trajectories with many
617
-
atoms.
618
-
- ``None``: See :func:`~prolif.parallel.get_mda_parallel_strategy` for
619
-
the default behavior.
620
-
621
-
Raises
622
-
------
623
-
ValueError
624
-
If ``n_jobs <= 0``
581
+
Parameters
582
+
----------
583
+
traj : MDAnalysis.coordinates.base.ProtoReader or MDAnalysis.coordinates.base.FrameIteratorSliced or MDAnalysis.coordinates.base.FrameIteratorIndices or MDAnalysis.coordinates.timestep.Timestep
584
+
Iterate over this Universe trajectory or sliced trajectory object
585
+
to extract the frames used for the fingerprint extraction
586
+
lig : MDAnalysis.core.groups.AtomGroup
587
+
An MDAnalysis AtomGroup for the ligand
588
+
prot : MDAnalysis.core.groups.AtomGroup
589
+
An MDAnalysis AtomGroup for the protein (with multiple residues)
590
+
residues : list or "all" or None
591
+
A list of protein residues (:class:`str`, :class:`int` or
592
+
:class:`~prolif.residue.ResidueId`) to take into account for
593
+
the fingerprint extraction. If ``"all"``, all residues will be
594
+
used. If ``None``, at each frame the
595
+
:func:`~prolif.utils.get_residues_near_ligand` function is used to
596
+
automatically use protein residues that are distant of 6.0 Å or
597
+
less from each ligand residue.
598
+
converter_kwargs : tuple[dict, dict], optional
599
+
Tuple of kwargs passed to the underlying
600
+
:class:`~MDAnalysis.converters.RDKit.RDKitConverter` from MDAnalysis: the
601
+
first for the ligand, and the second for the protein
602
+
progress : bool
603
+
Display a :class:`~tqdm.std.tqdm` progressbar while running the calculation
604
+
n_jobs : int or None
605
+
Number of processes to run in parallel. If ``n_jobs=1``, the analysis
606
+
will run in serial. If ``n_jobs=None``, see
607
+
:func:`~prolif.parallel.get_n_jobs` for the default behavior.
608
+
parallel_strategy : {"chunk", "queue"}, optional
609
+
Strategy for parallel execution:
610
+
611
+
- ``"chunk"``: Split trajectory into chunks and distribute to workers.
612
+
Each worker pickles the full MDAnalysis objects once per chunk.
613
+
Scales better for small trajectories.
614
+
- ``"queue"``: Main thread converts frames to Molecules and enqueues
615
+
them for workers. Avoids repeated MDAnalysis pickling overhead.
616
+
Better when pickling is expensive, e.g. large trajectories with many
617
+
atoms.
618
+
- ``None``: See :func:`~prolif.parallel.get_mda_parallel_strategy` for
619
+
the default behavior.
620
+
621
+
Raises
622
+
------
623
+
ValueError
624
+
If ``n_jobs <= 0``
625
625
626
-
Returns
627
-
-------
628
-
prolif.fingerprint.Fingerprint
629
-
The Fingerprint instance that generated the fingerprint
626
+
Returns
627
+
-------
628
+
prolif.fingerprint.Fingerprint
629
+
The Fingerprint instance that generated the fingerprint
0 commit comments