IntervalsCollection#

class geoassistant.drillholes.IntervalsCollection.IntervalsCollection(name=None)[source]#

Bases: DrillholeDataCollection[IntervalsCollection, Interval], IntervalsCollectionProperties

A collection of Interval objects with filtering and querying utilities.

Subsetter methods return new lists of Interval objects and never mutate the original collection.

addInterval(interval)[source]#
Return type:

None

addMetadataFromBlockModelField(block_model, field_id)[source]#
Return type:

None

assignDiscontinuities(discontinuities)[source]#
Return type:

None

assignDrillholes(drillholes)[source]#
Return type:

None

assignMajorStructures(major_structures)[source]#
Return type:

None

assignPLTTests(plt_tests)[source]#
Return type:

None

assignSystemsJointCondition(method)[source]#
Return type:

None

calculateJointFrequencyFromDiscontinuities(method, considered_types=('J', 'FJ'))[source]#

Assigns FF to intervals based on its registered LoggedDiscontinuitiesCollection.

Return type:

None

checkCalculations()[source]#
Return type:

None

createCorrelationPlot(x_parameter, y_parameter)[source]#
Return type:

None

createMetadataHistogram(key, frequency_type='meters')[source]#
Return type:

None

createParameterHistogram(parameter_id, frequency_type='meters', savepath=None)[source]#
Return type:

None

export(savepath, parameters=None, metadata_keys=None)[source]#
Return type:

None

filterByMajorStructures(limit_length_percentage)[source]#
Return type:

List[Interval]

findIntervalByCredentials(drillhole_name, _from, _to)[source]#
Return type:

Optional[Interval]

findIntervalByFromTo(_from, _to)[source]#
Return type:

Optional[Interval]

getLoggedDiscontinuities()[source]#
Return type:

LoggedDiscontinuitiesCollection

getMajorStructures()[source]#
Return type:

LoggedMajorStructuresCollection

getMaximumTo()[source]#
Return type:

float

getMinimumFrom()[source]#
Return type:

float

getPLTTests()[source]#
Return type:

PLTTestsCollection

getParameterRepresentativeValue(parameter_id, statistic='average')[source]#
Return type:

Optional[float]

getParameterRepresentativeValueByMetadataCategory(parameter_id, metadata_key, statistic='average')[source]#
Return type:

Dict[Any, Optional[float]]

getParameterStats(parameter_id, name=None)[source]#
Return type:

ParameterStatsObject

getSubsetByDrillholeName(drillhole_name)[source]#
Return type:

List[Interval]

getSubsetByParameterDefinition(parameter_id)[source]#
Return type:

List[Interval]

getSubsetFromMetadataValue(key, value)[source]#
Return type:

List[Interval]

getSubsetFromParameterRange(parameter_id, parameter_range, include_start=False, include_end=False)[source]#

Return intervals whose parameter value falls within a given range.

This method filters the collection by evaluating the value associated with parameter_id for each interval and selecting those that lie within the specified numeric bounds.

Open bounds can be expressed using None.

Parameters:
  • parameter_id (str) – Identifier of the parameter to evaluate.

  • parameter_range (List[Optional[float]]) – A two-element list [min, max] defining the range. Use None to indicate an open lower or upper bound.

  • include_start (bool) – Whether the lower bound is inclusive.

  • include_end (bool) – Whether the upper bound is inclusive.

Return type:

List[Interval]

Returns:

A list of matching Interval objects.

See also

getSubsetFromParameterValue getSubsetFromBounds

getSubsetFromParameterValue(parameter_id, value)[source]#

Returns a subset of intervals matching a specific parameter value.

This method filters the collection based on the value associated with the specified parameter identifier and returns the matching intervals.

Parameters:
  • parameter_id (str) – Identifier of the parameter used for filtering.

  • value (Any) – Value used as the filter criterion.

Returns:

List of intervals matching the specified parameter value.

Return type:

List[Interval]

getSubsetFromPlaneOffset(plane, offset)[source]#
Return type:

List[Interval]

getSubsetWithDiscontinuities()[source]#
Return type:

List[Interval]

getSubsetWithMajorStructures()[source]#
Return type:

List[Interval]

inheritMetadataToSubset(subset)[source]#

Internal hook to transfer metadata to subset. Subclasses may override.

Return type:

None

onElementChange(interval, **kwargs)[source]#
Return type:

None

plotParameterAlongAxis(parameter_id, axis, y_limits=None)[source]#
Return type:

None

classmethod readIntervalsCsvFile(source, from_key, to_key, id_key=None, hole_id=None, intervals_name=None, drillholes=None)[source]#
Return type:

IntervalsCollection

classmethod readIntervalsExcelSheet(source, sheetname, from_col, to_col, min_col='A', max_col=None, min_row=2, max_row=None, id_col=None, hole_id=None, intervals_name=None, drillholes=None)[source]#
Return type:

IntervalsCollection

setDrillhole(drillhole)[source]#
Return type:

None