prolint.utils
=============

.. py:module:: prolint.utils

.. autoapi-nested-parse::

   Utility functions for ProLint.

   This module provides optimized utility functions for contact
   computation and data processing.



Submodules
----------

.. toctree::
   :maxdepth: 1

   /autoapi/prolint/utils/utils/index


Functions
---------

.. autoapisummary::

   prolint.utils.fast_contiguous_segment_lengths
   prolint.utils.fast_unique_comparison


Package Contents
----------------

.. py:function:: fast_contiguous_segment_lengths(arr, multiplier: float = 1.0) -> numpy.ndarray

   Compute lengths of contiguous segments in a sorted array.

   :param arr: Sorted array of frame indices.
   :type arr: array-like
   :param multiplier: Factor to multiply segment lengths by.
   :type multiplier: float, default=1.0

   :returns: Array of segment lengths (contact durations).
   :rtype: np.ndarray


.. py:function:: fast_unique_comparison(residue_ids, database_ids, database_names)

   Find unique residue-database pairs efficiently.

   Given parallel arrays of residue IDs, database IDs, and database names,
   returns the unique (residue_id, database_id) pairs with corresponding names.

   :param residue_ids: Array of residue IDs.
   :type residue_ids: np.ndarray
   :param database_ids: Array of database molecule IDs.
   :type database_ids: np.ndarray
   :param database_names: Array of database residue names.
   :type database_names: np.ndarray

   :returns: (unique_residue_ids, unique_database_ids, unique_database_names)
   :rtype: tuple of np.ndarray