FPGATrackSimHelperFunctions Namespace Reference

Functions
def	convertRegionsExpressionToArray (expression, min_value=0, max_value=1279)
def	parse_range_or_wildcard (expr, min_value, max_value)

Variables
	test_cases
	result

Function Documentation

convertRegionsExpressionToArray()

def FPGATrackSimHelperFunctions.convertRegionsExpressionToArray	(		expression,
			min_value = 0,
			max_value = 1279
	)

Definition at line 6 of file FPGATrackSimHelperFunctions.py.

def convertRegionsExpressionToArray(expression, min_value=0, max_value=1279):
    # Check if the expression is a single integer
    if str(expression).isdigit():
        num = int(expression)
        if min_value <= num <= max_value:
            return [num]  # Return the single integer as a list
        else:
            raise ValueError(f"Invalid choise: {expression}. Number out of range [{min_value}-{max_value}].")
 
    # Start with all numbers within min_value to max_value
    numbers = set(range(min_value, max_value + 1))
 
    include_set = set()
    exclude_set = set()
 
    print(f"Initial expression: {str(expression)}")
    if isinstance(expression, tuple) or isinstance(expression, list):
        expression = ",".join(map(str, expression))
    
    parts = expression.split(",")  # Handle single-element expressions
    print(f"Parts after split: {parts}")  
    for part in parts:
        part = part.strip()
        
        # Exclude regions (e.g. "!5-30")
        if part.startswith("!"):
            exclude_set.update(parse_range_or_wildcard(part[1:], min_value, max_value))
        else:
            include_set.update(parse_range_or_wildcard(part, min_value, max_value))
 
    # Apply inclusion if non-empty; otherwise, use full range
    result = include_set if include_set else numbers
    result -= exclude_set  # Remove exclusions
 
    # Ensure final result stays within valid bounds
    result = {num for num in result if min_value <= num <= max_value}
    return list(sorted(result))  # Always return a sorted list
 

parse_range_or_wildcard()

def FPGATrackSimHelperFunctions.parse_range_or_wildcard	(		expr,
			min_value,
			max_value
	)

Definition at line 44 of file FPGATrackSimHelperFunctions.py.

def parse_range_or_wildcard(expr, min_value, max_value):  
    # Check for range (e.g., "5-30")
    if "-" in expr and "*" not in expr:
        start, end = map(int, expr.split("-"))
        start, end = max(min_value, start), min(max_value, end)  # Apply min/max limits
        return set(range(start, end + 1))
    
    # Check for explicit number
    if expr.isdigit():
        num = int(expr)
        return {num} if min_value <= num <= max_value else set()  # Ignore if out of range
 
    # Handle wildcards
    pattern = "^" + expr.replace("*", ".*") + "$"
    regex = re.compile(pattern)
 
    return {num for num in range(min_value, max_value + 1) if regex.match(str(num))}
 

Variable Documentation

result

FPGATrackSimHelperFunctions.result

Definition at line 79 of file FPGATrackSimHelperFunctions.py.

test_cases

FPGATrackSimHelperFunctions.test_cases

Definition at line 64 of file FPGATrackSimHelperFunctions.py.