Introduction

interval provides a dictionary-like class keyed by ranges of floating-point numbers. Each value of the dictionary applies for any key value within the numeric range. Later entries into the dictionary can partially or completely replace earlier values.

interval is a product of the PDS Ring-Moon Systems Node.

Note that this package is deprecated in favor of the portion module. Eventually this package may be removed entirely.

Installation

The interval module is available via the rms-interval package on PyPI and can be installed with:

pip install rms-interval

Getting Started

The interval module provides the Interval class, which behaves like a dictionary keyed by ranges of floating-point numbers. You can create an interval with a specific range, or use the default range from negative infinity to positive infinity.

Basic operation is as follows:

from interval import Interval

# Create an interval from 0 to 100
interval = Interval(0, 100)

# Set values for different ranges
interval[(11, 30)] = 1.5
interval[(31, 60)] = 2.5
interval[(61, 90)] = 3.5

# Access values at specific points
print(interval[15])  # Prints: 1.5
print(interval[50])  # Prints: 2.5
print(interval[75])  # Prints: 3.5

# Get all values within a range
print(interval[(0, 100)])  # Prints: [None, 1.5, 2.5, 3.5]

# Overlay a new value that partially replaces existing ones
interval[(15, 45)] = 4.5
print(interval[20])  # Prints: 4.5 (replaces 1.5 in this range)
print(interval[50])  # Prints: 2.5 (unchanged)

The interval class handles overlapping ranges by giving precedence to later entries. When you query a range, you get all unique values that were set within that range, ordered by their insertion sequence.

Details of the class are available in the module documentation.

Contributing

Information on contributing to this package can be found in the Contributing Guide.

Links

• Documentation
• Repository
• Issue tracker
• PyPi

Licensing

This code is licensed under the Apache License v2.0.