Between¶
-
AQPython.Query.
Between
(middle, left, right, dist=9223372036854775807, limit=0, negate=False)¶ Provide the ability to find annotations that are before one annotation and after another.
The input is 3 Dataframes of AQAnnotations. We will call them A, B and C. The purpose is to find those annotations in A that are before B and after C. What that means is the end offset for an annotation from A must be before (or equal to) the start offset from an annotation in B and the start offset for A be after (or equal to) the end offset from C. We ultimately return the A annotations that meet this criteria. A distance operator can also be optionally specified. This would require an A annotation (endOffset) to occur n characters (or less) before the B annotation (startOffset) and would require the A annotation (startOffset) to occur n characters (or less) after the C annotation (endOffset) . There is also the option of negating the query (think Not Between) so that we return only A where it is not before B nor after C.
- Parameters
middle – Dataframe of AQAnnotations, the ones we will return if they are between AQAnnotations from ‘left’ and AQAnnotations from ‘right.
left – Dataframe of AQAnnotations, the ones we are looking to see if they are before AQAnnotations from ‘middle’.
right – Dataframe of AQAnnotations, the ones we are looking to see if they are after AQAnnotations from ‘middle’.
dist – Number of characters where startOffset from ‘middle’ must occur after endOffset of ‘left’ or endOffset from ‘middle’ must occur before startOffset of ‘right’
limit – Number of AQAnnotations to return.
negate – Whether to negate the entire query (think NOT between). Default is false.
- Returns
Dataframe of AQAnnotations