circle_bundles.DreimacCCConfig

class circle_bundles.DreimacCCConfig(CircularCoords_cls, landmarks_per_patch=200, prime=41, update_frac=0.25, standard_range=False)

Bases: object

Configuration object for Dreimac-based circular coordinates.

This dataclass specifies how Dreimac’s circular coordinates algorithm should be applied within local trivialization routines such as compute_local_triv().

Parameters:

• CircularCoords_cls (Any)

• landmarks_per_patch (int)

• prime (int)

• update_frac (float)

• standard_range (bool)

CircularCoords_cls

The Dreimac circular coordinates class (e.g. dreimac.CircularCoords).

Type:

Any

landmarks_per_patch

Initial number of landmarks to use per patch. The algorithm may increase this value automatically if coverage is insufficient.

Type:

int, default=200

prime

Prime number used internally by Dreimac for coefficient computations.

Type:

int, default=41

update_frac

Fractional increase applied to the number of landmarks when a retry is required.

Type:

float, default=0.25

standard_range

Whether to return angles in Dreimac’s standard range instead of wrapping to [0, 2π).

Type:

bool, default=False

Notes

• This configuration is passed as the cc argument to compute_local_triv().

• If a total_metric is supplied to compute_local_triv(), distance matrices are passed to Dreimac with distance_matrix=True.

• The dataclass is frozen to emphasize its role as an immutable configuration object.

__init__(CircularCoords_cls, landmarks_per_patch=200, prime=41, update_frac=0.25, standard_range=False)

Parameters:

• CircularCoords_cls (Any)

• landmarks_per_patch (int)

• prime (int)

• update_frac (float)

• standard_range (bool)

Return type:

None

Methods

__init__(CircularCoords_cls[, ...])

Attributes

landmarks_per_patch
prime
standard_range
update_frac
CircularCoords_cls