topologicpy 0.8.46__py3-none-any.whl → 0.8.47__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- topologicpy/ANN.py +19 -19
- topologicpy/BVH.py +5 -5
- topologicpy/CSG.py +17 -17
- topologicpy/Cell.py +295 -295
- topologicpy/CellComplex.py +67 -67
- topologicpy/Cluster.py +35 -35
- topologicpy/Color.py +8 -8
- topologicpy/DGL.py +52 -52
- topologicpy/Dictionary.py +22 -22
- topologicpy/Edge.py +77 -77
- topologicpy/EnergyModel.py +25 -25
- topologicpy/Face.py +270 -270
- topologicpy/Graph.py +1052 -675
- topologicpy/Grid.py +24 -24
- topologicpy/Helper.py +8 -8
- topologicpy/Honeybee.py +13 -13
- topologicpy/Matrix.py +11 -11
- topologicpy/Neo4j.py +21 -21
- topologicpy/Plotly.py +213 -213
- topologicpy/PyG.py +41 -41
- topologicpy/ShapeGrammar.py +7 -7
- topologicpy/Shell.py +104 -104
- topologicpy/Sun.py +46 -46
- topologicpy/Topology.py +392 -392
- topologicpy/Vector.py +25 -25
- topologicpy/Vertex.py +64 -64
- topologicpy/Wire.py +250 -250
- topologicpy/version.py +1 -1
- {topologicpy-0.8.46.dist-info → topologicpy-0.8.47.dist-info}/METADATA +1 -1
- topologicpy-0.8.47.dist-info/RECORD +38 -0
- topologicpy-0.8.46.dist-info/RECORD +0 -38
- {topologicpy-0.8.46.dist-info → topologicpy-0.8.47.dist-info}/WHEEL +0 -0
- {topologicpy-0.8.46.dist-info → topologicpy-0.8.47.dist-info}/licenses/LICENSE +0 -0
- {topologicpy-0.8.46.dist-info → topologicpy-0.8.47.dist-info}/top_level.txt +0 -0
topologicpy/CellComplex.py
CHANGED
@@ -59,25 +59,25 @@ class CellComplex():
|
|
59
59
|
Parameters
|
60
60
|
----------
|
61
61
|
origin : topologic_core.Vertex , optional
|
62
|
-
The origin location of the box.
|
62
|
+
The origin location of the box. Default is None which results in the box being placed at (0, 0, 0).
|
63
63
|
width : float , optional
|
64
|
-
The width of the box.
|
64
|
+
The width of the box. Default is 1.
|
65
65
|
length : float , optional
|
66
|
-
The length of the box.
|
66
|
+
The length of the box. Default is 1.
|
67
67
|
height : float , optional
|
68
68
|
The height of the box.
|
69
69
|
uSides : int , optional
|
70
|
-
The number of sides along the width.
|
70
|
+
The number of sides along the width. Default is 1.
|
71
71
|
vSides : int, optional
|
72
|
-
The number of sides along the length.
|
72
|
+
The number of sides along the length. Default is 1.
|
73
73
|
wSides : int , optional
|
74
|
-
The number of sides along the height.
|
74
|
+
The number of sides along the height. Default is 1.
|
75
75
|
direction : list , optional
|
76
|
-
The vector representing the up direction of the box.
|
76
|
+
The vector representing the up direction of the box. Default is [0, 0, 1].
|
77
77
|
placement : str , optional
|
78
|
-
The description of the placement of the origin of the box. This can be "bottom", "center", or "lowerleft". It is case insensitive.
|
78
|
+
The description of the placement of the origin of the box. This can be "bottom", "center", or "lowerleft". It is case insensitive. Default is "center".
|
79
79
|
tolerance : float , optional
|
80
|
-
The desired tolerance.
|
80
|
+
The desired tolerance. Default is 0.0001.
|
81
81
|
|
82
82
|
Returns
|
83
83
|
-------
|
@@ -100,11 +100,11 @@ class CellComplex():
|
|
100
100
|
cells : list
|
101
101
|
The list of input cells.
|
102
102
|
transferDictionaries : bool , optional
|
103
|
-
If set to True, any dictionaries in the cells are transferred to the CellComplex. Otherwise, they are not.
|
103
|
+
If set to True, any dictionaries in the cells are transferred to the CellComplex. Otherwise, they are not. Default is False.
|
104
104
|
tolerance : float , optional
|
105
|
-
The desired tolerance.
|
105
|
+
The desired tolerance. Default is 0.0001.
|
106
106
|
silent : bool , optional
|
107
|
-
If set to True, error and warning messages are suppressed.
|
107
|
+
If set to True, error and warning messages are suppressed. Default is False.
|
108
108
|
|
109
109
|
Returns
|
110
110
|
-------
|
@@ -176,7 +176,7 @@ class CellComplex():
|
|
176
176
|
cluster : topologic_core.Cluster
|
177
177
|
The input cluster of cells.
|
178
178
|
tolerance : float , optional
|
179
|
-
The desired tolerance.
|
179
|
+
The desired tolerance. Default is 0.0001.
|
180
180
|
|
181
181
|
Returns
|
182
182
|
-------
|
@@ -203,9 +203,9 @@ class CellComplex():
|
|
203
203
|
faces : list
|
204
204
|
The input faces.
|
205
205
|
tolerance : float , optional
|
206
|
-
The desired tolerance.
|
206
|
+
The desired tolerance. Default is 0.0001.
|
207
207
|
silent : bool , optional
|
208
|
-
If set to True, error and warning messages are suppressed.
|
208
|
+
If set to True, error and warning messages are suppressed. Default is False.
|
209
209
|
|
210
210
|
Returns
|
211
211
|
-------
|
@@ -270,7 +270,7 @@ class CellComplex():
|
|
270
270
|
cluster : topologic_core.Cluster
|
271
271
|
The input cluster of faces.
|
272
272
|
tolerance : float , optional
|
273
|
-
The desired tolerance.
|
273
|
+
The desired tolerance. Default is 0.0001.
|
274
274
|
|
275
275
|
Returns
|
276
276
|
-------
|
@@ -296,9 +296,9 @@ class CellComplex():
|
|
296
296
|
wires : list
|
297
297
|
The input list of wires. The list should contain a minimum of two wires. All wires must have the same number of edges.
|
298
298
|
triangulate : bool , optional
|
299
|
-
If set to True, the faces will be triangulated.
|
299
|
+
If set to True, the faces will be triangulated. Default is True.
|
300
300
|
tolerance : float , optional
|
301
|
-
The desired tolerance.
|
301
|
+
The desired tolerance. Default is 0.0001.
|
302
302
|
|
303
303
|
Returns
|
304
304
|
-------
|
@@ -407,9 +407,9 @@ class CellComplex():
|
|
407
407
|
cluster : topologic_core.Cluster
|
408
408
|
The input cluster of wires.
|
409
409
|
triangulate : bool , optional
|
410
|
-
If set to True, the faces will be triangulated.
|
410
|
+
If set to True, the faces will be triangulated. Default is True.
|
411
411
|
tolerance : float , optional
|
412
|
-
The desired tolerance.
|
412
|
+
The desired tolerance. Default is 0.0001.
|
413
413
|
|
414
414
|
Returns
|
415
415
|
-------
|
@@ -461,21 +461,21 @@ class CellComplex():
|
|
461
461
|
Parameters
|
462
462
|
----------
|
463
463
|
origin : topologic_core.Vertex , optional
|
464
|
-
The origin location of the cube.
|
464
|
+
The origin location of the cube. Default is None which results in the cube being placed at (0, 0, 0).
|
465
465
|
size : float , optional
|
466
|
-
The size of the cube.
|
466
|
+
The size of the cube. Default is 1.
|
467
467
|
uSides : int , optional
|
468
|
-
The number of sides along the width.
|
468
|
+
The number of sides along the width. Default is 1.
|
469
469
|
vSides : int, optional
|
470
|
-
The number of sides along the length.
|
470
|
+
The number of sides along the length. Default is 1.
|
471
471
|
wSides : int , optional
|
472
|
-
The number of sides along the height.
|
472
|
+
The number of sides along the height. Default is 1.
|
473
473
|
direction : list , optional
|
474
|
-
The vector representing the up direction of the cube.
|
474
|
+
The vector representing the up direction of the cube. Default is [0, 0, 1].
|
475
475
|
placement : str , optional
|
476
|
-
The description of the placement of the origin of the cube. This can be "bottom", "center", or "lowerleft". It is case insensitive.
|
476
|
+
The description of the placement of the origin of the cube. This can be "bottom", "center", or "lowerleft". It is case insensitive. Default is "center".
|
477
477
|
tolerance : float , optional
|
478
|
-
The desired tolerance.
|
478
|
+
The desired tolerance. Default is 0.0001.
|
479
479
|
|
480
480
|
Returns
|
481
481
|
-------
|
@@ -498,9 +498,9 @@ class CellComplex():
|
|
498
498
|
cellComplex : topologic_core.CellComplex
|
499
499
|
the input cellComplex.
|
500
500
|
tiltAngle : float , optional
|
501
|
-
The threshold tilt angle in degrees to determine if a face is vertical, horizontal, or tilted. The tilt angle is measured from the nearest cardinal direction.
|
501
|
+
The threshold tilt angle in degrees to determine if a face is vertical, horizontal, or tilted. The tilt angle is measured from the nearest cardinal direction. Default is 10.
|
502
502
|
tolerance : float , optional
|
503
|
-
The desired tolerance.
|
503
|
+
The desired tolerance. Default is 0.0001.
|
504
504
|
|
505
505
|
Returns
|
506
506
|
-------
|
@@ -643,7 +643,7 @@ class CellComplex():
|
|
643
643
|
The input list of vertices to use for delaunay triangulation. If set to None, the algorithm uses the vertices of the input cell parameter.
|
644
644
|
if both are set to none, a unit cube centered around the origin is used.
|
645
645
|
tolerance : float , optional
|
646
|
-
the desired tolerance.
|
646
|
+
the desired tolerance. Default is 0.0001.
|
647
647
|
|
648
648
|
Returns
|
649
649
|
-------
|
@@ -835,15 +835,15 @@ class CellComplex():
|
|
835
835
|
Parameters
|
836
836
|
----------
|
837
837
|
origin : topologic_core.Vertex , optional
|
838
|
-
The origin location of the octahedron.
|
838
|
+
The origin location of the octahedron. Default is None which results in the octahedron being placed at (0, 0, 0).
|
839
839
|
radius : float , optional
|
840
|
-
The radius of the octahedron's circumscribed sphere.
|
840
|
+
The radius of the octahedron's circumscribed sphere. Default is 0.5.
|
841
841
|
direction : list , optional
|
842
|
-
The vector representing the up direction of the octahedron.
|
842
|
+
The vector representing the up direction of the octahedron. Default is [0, 0, 1].
|
843
843
|
placement : str , optional
|
844
|
-
The description of the placement of the origin of the octahedron. This can be "bottom", "center", or "lowerleft". It is case insensitive.
|
844
|
+
The description of the placement of the origin of the octahedron. This can be "bottom", "center", or "lowerleft". It is case insensitive. Default is "center".
|
845
845
|
tolerance : float , optional
|
846
|
-
The desired tolerance.
|
846
|
+
The desired tolerance. Default is 0.0001.
|
847
847
|
|
848
848
|
Returns
|
849
849
|
-------
|
@@ -899,27 +899,27 @@ class CellComplex():
|
|
899
899
|
Parameters
|
900
900
|
----------
|
901
901
|
origin : topologic_core.Vertex , optional
|
902
|
-
The origin location of the prism.
|
902
|
+
The origin location of the prism. Default is None which results in the prism being placed at (0, 0, 0).
|
903
903
|
width : float , optional
|
904
|
-
The width of the prism.
|
904
|
+
The width of the prism. Default is 1.
|
905
905
|
length : float , optional
|
906
|
-
The length of the prism.
|
906
|
+
The length of the prism. Default is 1.
|
907
907
|
height : float , optional
|
908
908
|
The height of the prism.
|
909
909
|
uSides : int , optional
|
910
|
-
The number of sides along the width.
|
910
|
+
The number of sides along the width. Default is 1.
|
911
911
|
vSides : int , optional
|
912
|
-
The number of sides along the length.
|
912
|
+
The number of sides along the length. Default is 1.
|
913
913
|
wSides : int , optional
|
914
|
-
The number of sides along the height.
|
914
|
+
The number of sides along the height. Default is 1.
|
915
915
|
direction : list , optional
|
916
|
-
The vector representing the up direction of the prism.
|
916
|
+
The vector representing the up direction of the prism. Default is [0, 0, 1].
|
917
917
|
placement : str , optional
|
918
|
-
The description of the placement of the origin of the prism. This can be "bottom", "center", or "lowerleft". It is case insensitive.
|
918
|
+
The description of the placement of the origin of the prism. This can be "bottom", "center", or "lowerleft". It is case insensitive. Default is "center".
|
919
919
|
mantissa : int , optional
|
920
|
-
The
|
920
|
+
The number of decimal places to round the result to. Default is 6.
|
921
921
|
tolerance : float , optional
|
922
|
-
The desired tolerance.
|
922
|
+
The desired tolerance. Default is 0.0001.
|
923
923
|
|
924
924
|
Returns
|
925
925
|
-------
|
@@ -999,11 +999,11 @@ class CellComplex():
|
|
999
999
|
cellComplex : topologic_core.CellComplex
|
1000
1000
|
The input cellComplex.
|
1001
1001
|
angTolerance : float , optional
|
1002
|
-
The desired angular tolerance.
|
1002
|
+
The desired angular tolerance. Default is 0.1.
|
1003
1003
|
tolerance : float , optional
|
1004
|
-
The desired tolerance.
|
1004
|
+
The desired tolerance. Default is 0.0001.
|
1005
1005
|
silent : bool , optional
|
1006
|
-
If set to True, error and warning messages are suppressed.
|
1006
|
+
If set to True, error and warning messages are suppressed. Default is False.
|
1007
1007
|
|
1008
1008
|
Returns
|
1009
1009
|
-------
|
@@ -1087,21 +1087,21 @@ class CellComplex():
|
|
1087
1087
|
Parameters
|
1088
1088
|
----------
|
1089
1089
|
origin : topologic_core.Vertex , optional
|
1090
|
-
The origin location of the tetrahedron.
|
1090
|
+
The origin location of the tetrahedron. Default is None which results in the tetrahedron being placed at (0, 0, 0).
|
1091
1091
|
length : float , optional
|
1092
|
-
The length of the edge of the tetrahedron.
|
1092
|
+
The length of the edge of the tetrahedron. Default is 1.
|
1093
1093
|
depth : int , optional
|
1094
1094
|
The desired maximum number of recrusive subdivision levels.
|
1095
1095
|
direction : list , optional
|
1096
|
-
The vector representing the up direction of the tetrahedron.
|
1096
|
+
The vector representing the up direction of the tetrahedron. Default is [0, 0, 1].
|
1097
1097
|
placement : str , optional
|
1098
|
-
The description of the placement of the origin of the tetrahedron. This can be "bottom", "center", or "lowerleft". It is case insensitive.
|
1098
|
+
The description of the placement of the origin of the tetrahedron. This can be "bottom", "center", or "lowerleft". It is case insensitive. Default is "center".
|
1099
1099
|
mantissa : int , optional
|
1100
|
-
The
|
1100
|
+
The number of decimal places to round the result to. Default is 6.
|
1101
1101
|
tolerance : float , optional
|
1102
|
-
The desired tolerance.
|
1102
|
+
The desired tolerance. Default is 0.0001.
|
1103
1103
|
silent : bool , optional
|
1104
|
-
If set to True, error and warning messages are suppressed.
|
1104
|
+
If set to True, error and warning messages are suppressed. Default is False.
|
1105
1105
|
|
1106
1106
|
Returns
|
1107
1107
|
-------
|
@@ -1234,21 +1234,21 @@ class CellComplex():
|
|
1234
1234
|
Parameters
|
1235
1235
|
----------
|
1236
1236
|
origin : topologic_core.Vertex , optional
|
1237
|
-
The origin location of the torus.
|
1237
|
+
The origin location of the torus. Default is None which results in the torus being placed at (0, 0, 0).
|
1238
1238
|
majorRadius : float , optional
|
1239
|
-
The major radius of the torus.
|
1239
|
+
The major radius of the torus. Default is 0.5.
|
1240
1240
|
minorRadius : float , optional
|
1241
|
-
The minor radius of the torus.
|
1241
|
+
The minor radius of the torus. Default is 0.1.
|
1242
1242
|
uSides : int , optional
|
1243
|
-
The number of sides along the longitude of the torus.
|
1243
|
+
The number of sides along the longitude of the torus. Default is 16.
|
1244
1244
|
vSides : int , optional
|
1245
|
-
The number of sides along the latitude of the torus.
|
1245
|
+
The number of sides along the latitude of the torus. Default is 8.
|
1246
1246
|
direction : list , optional
|
1247
|
-
The vector representing the up direction of the torus.
|
1247
|
+
The vector representing the up direction of the torus. Default is [0, 0, 1].
|
1248
1248
|
placement : str , optional
|
1249
|
-
The description of the placement of the origin of the torus. This can be "bottom", "center", or "lowerleft". It is case insensitive.
|
1249
|
+
The description of the placement of the origin of the torus. This can be "bottom", "center", or "lowerleft". It is case insensitive. Default is "center".
|
1250
1250
|
tolerance : float , optional
|
1251
|
-
The desired tolerance.
|
1251
|
+
The desired tolerance. Default is 0.0001.
|
1252
1252
|
|
1253
1253
|
Returns
|
1254
1254
|
-------
|
@@ -1319,7 +1319,7 @@ class CellComplex():
|
|
1319
1319
|
cellComplex : topologic_core.CellComplex
|
1320
1320
|
The input cellComplex.
|
1321
1321
|
manitssa: int , optional
|
1322
|
-
The
|
1322
|
+
The number of decimal places to round the result to. Default is 6.
|
1323
1323
|
|
1324
1324
|
Returns
|
1325
1325
|
-------
|
@@ -1352,9 +1352,9 @@ class CellComplex():
|
|
1352
1352
|
The input list of vertices to use for voronoi partitioning. If set to None, the algorithm uses the vertices of the input cell parameter.
|
1353
1353
|
if both are set to none, a unit cube centered around the origin is used.
|
1354
1354
|
cell : topologic_core.Cell , optional
|
1355
|
-
The input bounding cell. If set to None, an axes-aligned bounding cell is created from the list of vertices.
|
1355
|
+
The input bounding cell. If set to None, an axes-aligned bounding cell is created from the list of vertices. Default is None.
|
1356
1356
|
tolerance : float , optional
|
1357
|
-
the desired tolerance.
|
1357
|
+
the desired tolerance. Default is 0.0001.
|
1358
1358
|
|
1359
1359
|
|
1360
1360
|
Returns
|
topologicpy/Cluster.py
CHANGED
@@ -76,9 +76,9 @@ class Cluster():
|
|
76
76
|
The method will attempt to evaluate Y based on the specified xRange.
|
77
77
|
xRange and yRange CANNOT be None or unspecified at the same time. One or the other must be specified.
|
78
78
|
xString : str , optional
|
79
|
-
The string used to represent the X independent variable.
|
79
|
+
The string used to represent the X independent variable. Default is 'X' (uppercase).
|
80
80
|
yString : str , optional
|
81
|
-
The string used to represent the Y independent variable.
|
81
|
+
The string used to represent the Y independent variable. Default is 'Y' (uppercase).
|
82
82
|
|
83
83
|
Returns:
|
84
84
|
topologic_core.Cluster
|
@@ -152,9 +152,9 @@ class Cluster():
|
|
152
152
|
*topologies : topologic_core.Topology
|
153
153
|
One or more instances of `topologic_core.Topology` to be processed.
|
154
154
|
transferDictionaries : bool , optional
|
155
|
-
If set to True, the dictionaries from the input topologies are merged and transferred to the cluster. Otherwise they are not.
|
155
|
+
If set to True, the dictionaries from the input topologies are merged and transferred to the cluster. Otherwise they are not. Default is False.
|
156
156
|
silent : bool , optional
|
157
|
-
If set to True, error and warning messages are suppressed.
|
157
|
+
If set to True, error and warning messages are suppressed. Default is False.
|
158
158
|
|
159
159
|
Returns
|
160
160
|
-------
|
@@ -287,14 +287,14 @@ class Cluster():
|
|
287
287
|
The input list of topologies to be clustered.
|
288
288
|
selectors : list , optional
|
289
289
|
If the list of topologies are not vertices then please provide a corresponding list of selectors (vertices) that represent the topologies for clustering. For example, these can be the centroids of the topologies.
|
290
|
-
If set to None, the list of topologies is expected to be a list of vertices.
|
290
|
+
If set to None, the list of topologies is expected to be a list of vertices. Default is None.
|
291
291
|
keys : list, optional
|
292
292
|
The keys in the embedded dictionaries in the topologies. If specified, the values at these keys will be added to the dimensions to be clustered. The values must be numeric. If you wish the x, y, z location to be included,
|
293
|
-
make sure the keys list includes "X", "Y", and/or "Z" (case insensitive).
|
293
|
+
make sure the keys list includes "X", "Y", and/or "Z" (case insensitive). Default is ["x", "y", "z"]
|
294
294
|
epsilon : float , optional
|
295
|
-
The maximum radius around a data point within which other points are considered to be part of the same sense region (cluster).
|
295
|
+
The maximum radius around a data point within which other points are considered to be part of the same sense region (cluster). Default is 0.5.
|
296
296
|
minSamples : int , optional
|
297
|
-
The minimum number of points required to form a dense region (cluster).
|
297
|
+
The minimum number of points required to form a dense region (cluster). Default is 2.
|
298
298
|
|
299
299
|
Returns
|
300
300
|
-------
|
@@ -517,7 +517,7 @@ class Cluster():
|
|
517
517
|
cluster : topologic_core.Cluster
|
518
518
|
The input cluster.
|
519
519
|
tolerance : float , optional
|
520
|
-
The desired tolerance.
|
520
|
+
The desired tolerance. Default is 0.0001.
|
521
521
|
|
522
522
|
Returns
|
523
523
|
-------
|
@@ -564,7 +564,7 @@ class Cluster():
|
|
564
564
|
cluster : topologic_core.Cluster
|
565
565
|
The input cluster.
|
566
566
|
tolerance : float, optional
|
567
|
-
The desired tolerance.
|
567
|
+
The desired tolerance. Default is 0.0001.
|
568
568
|
|
569
569
|
Returns
|
570
570
|
-------
|
@@ -610,7 +610,7 @@ class Cluster():
|
|
610
610
|
cluster : topologic_core.Cluster
|
611
611
|
The input cluster.
|
612
612
|
tolerance : float , optional
|
613
|
-
The desired tolerance.
|
613
|
+
The desired tolerance. Default is 0.0001.
|
614
614
|
|
615
615
|
Returns
|
616
616
|
-------
|
@@ -656,7 +656,7 @@ class Cluster():
|
|
656
656
|
cluster : topologic_core.Cluster
|
657
657
|
The input cluster.
|
658
658
|
tolerance : float , optional
|
659
|
-
The desired tolerance.
|
659
|
+
The desired tolerance. Default is 0.0001.
|
660
660
|
|
661
661
|
Returns
|
662
662
|
-------
|
@@ -702,7 +702,7 @@ class Cluster():
|
|
702
702
|
cluster : topologic_core.Cluster
|
703
703
|
The input cluster.
|
704
704
|
tolerance : float, optional
|
705
|
-
The desired tolerance.
|
705
|
+
The desired tolerance. Default is 0.0001.
|
706
706
|
|
707
707
|
Returns
|
708
708
|
-------
|
@@ -748,7 +748,7 @@ class Cluster():
|
|
748
748
|
cluster : topologic_core.Cluster
|
749
749
|
The input cluster.
|
750
750
|
tolerance : float , optional
|
751
|
-
The desired tolerance.
|
751
|
+
The desired tolerance. Default is 0.0001.
|
752
752
|
|
753
753
|
Returns
|
754
754
|
-------
|
@@ -794,7 +794,7 @@ class Cluster():
|
|
794
794
|
cluster : topologic_core.Cluster
|
795
795
|
The input cluster.
|
796
796
|
tolerance : float , optional
|
797
|
-
The desired tolerance.
|
797
|
+
The desired tolerance. Default is 0.0001.
|
798
798
|
|
799
799
|
Returns
|
800
800
|
-------
|
@@ -866,16 +866,16 @@ class Cluster():
|
|
866
866
|
The input list of topologies. If this is not a list of topologic vertices then please provide a list of selectors
|
867
867
|
selectors : list , optional
|
868
868
|
If the list of topologies are not vertices then please provide a corresponding list of selectors (vertices) that represent the topologies for clustering. For example, these can be the centroids of the topologies.
|
869
|
-
If set to None, the list of topologies is expected to be a list of vertices.
|
869
|
+
If set to None, the list of topologies is expected to be a list of vertices. Default is None.
|
870
870
|
keys : list, optional
|
871
871
|
The keys in the embedded dictionaries in the topologies. If specified, the values at these keys will be added to the dimensions to be clustered. The values must be numeric. If you wish the x, y, z location to be included,
|
872
|
-
make sure the keys list includes "X", "Y", and/or "Z" (case insensitive).
|
872
|
+
make sure the keys list includes "X", "Y", and/or "Z" (case insensitive). Default is ["x", "y", "z"]
|
873
873
|
k : int , optional
|
874
|
-
The desired number of clusters.
|
874
|
+
The desired number of clusters. Default is 4.
|
875
875
|
maxIterations : int , optional
|
876
876
|
The desired maximum number of iterations for the clustering algorithm
|
877
877
|
centroidKey : str , optional
|
878
|
-
The desired dictionary key under which to store the cluster's centroid (this is not to be confused with the actual geometric centroid of the cluster).
|
878
|
+
The desired dictionary key under which to store the cluster's centroid (this is not to be confused with the actual geometric centroid of the cluster). Default is "k_centroid"
|
879
879
|
|
880
880
|
Returns
|
881
881
|
-------
|
@@ -1046,7 +1046,7 @@ class Cluster():
|
|
1046
1046
|
cells : list
|
1047
1047
|
The input list of cells.
|
1048
1048
|
tolerance : float , optional
|
1049
|
-
The desired tolerance.
|
1049
|
+
The desired tolerance. Default is 0.0001.
|
1050
1050
|
|
1051
1051
|
Returns
|
1052
1052
|
-------
|
@@ -1114,21 +1114,21 @@ class Cluster():
|
|
1114
1114
|
wire : topologic_core.Wire , optional
|
1115
1115
|
The input Wire. if set to None, a circle with the input parameters is created. Otherwise, the input parameters are ignored.
|
1116
1116
|
origin : topologic_core.Vertex , optional
|
1117
|
-
The location of the origin of the circle.
|
1117
|
+
The location of the origin of the circle. Default is None which results in the circle being placed at (0, 0, 0).
|
1118
1118
|
radius : float , optional
|
1119
|
-
The radius of the mystic rose.
|
1119
|
+
The radius of the mystic rose. Default is 1.
|
1120
1120
|
sides : int , optional
|
1121
|
-
The number of sides of the mystic rose.
|
1121
|
+
The number of sides of the mystic rose. Default is 16.
|
1122
1122
|
perimeter : bool , optional
|
1123
|
-
If True, the perimeter edges are included in the output.
|
1123
|
+
If True, the perimeter edges are included in the output. Default is True.
|
1124
1124
|
direction : list , optional
|
1125
|
-
The vector representing the up direction of the mystic rose.
|
1125
|
+
The vector representing the up direction of the mystic rose. Default is [0, 0, 1].
|
1126
1126
|
placement : str , optional
|
1127
|
-
The description of the placement of the origin of the mystic rose. This can be "center", or "lowerleft". It is case insensitive.
|
1127
|
+
The description of the placement of the origin of the mystic rose. This can be "center", or "lowerleft". It is case insensitive. Default is "center".
|
1128
1128
|
tolerance : float , optional
|
1129
|
-
The desired tolerance.
|
1129
|
+
The desired tolerance. Default is 0.0001.
|
1130
1130
|
silent : bool , optional
|
1131
|
-
If set to True, error and warning messages are suppressed.
|
1131
|
+
If set to True, error and warning messages are suppressed. Default is False.
|
1132
1132
|
|
1133
1133
|
Returns
|
1134
1134
|
-------
|
@@ -1264,21 +1264,21 @@ class Cluster():
|
|
1264
1264
|
Parameters
|
1265
1265
|
----------
|
1266
1266
|
size : float , optional
|
1267
|
-
The desired size of the tripod.
|
1267
|
+
The desired size of the tripod. Default is 1.0.
|
1268
1268
|
radius : float , optional
|
1269
|
-
The desired radiues of the tripod.
|
1269
|
+
The desired radiues of the tripod. Default is 0.03
|
1270
1270
|
sides : int , optional
|
1271
|
-
The desired number of sides of the tripod.
|
1271
|
+
The desired number of sides of the tripod. Default is 4.
|
1272
1272
|
faceColorKey : str , optional
|
1273
1273
|
The dictionary key under which to store the colors of the axes.
|
1274
1274
|
xColor : str , optional
|
1275
|
-
The color to use for the X axis.
|
1275
|
+
The color to use for the X axis. Default is "red".
|
1276
1276
|
yColor : str , optional
|
1277
|
-
The color to use for the Y axis.
|
1277
|
+
The color to use for the Y axis. Default is "green".
|
1278
1278
|
zColor : str , optional
|
1279
|
-
The color to use for the Z axis.
|
1279
|
+
The color to use for the Z axis. Default is "blue".
|
1280
1280
|
matrix : list , optional
|
1281
|
-
The desired 4X4 transformation matrix to use for transforming the tripod.
|
1281
|
+
The desired 4X4 transformation matrix to use for transforming the tripod. Default is None which means the tripod will be placed at the origin and will be axis-aligned.
|
1282
1282
|
|
1283
1283
|
Returns
|
1284
1284
|
-------
|
topologicpy/Color.py
CHANGED
@@ -175,7 +175,7 @@ class Color:
|
|
175
175
|
color : str
|
176
176
|
A CSS named color.
|
177
177
|
alpha : float , optional
|
178
|
-
THe desired alpha (transparency value).
|
178
|
+
THe desired alpha (transparency value). Default is None which means no alpha value will be included in the returned list.
|
179
179
|
|
180
180
|
Returns
|
181
181
|
-------
|
@@ -224,7 +224,7 @@ class Color:
|
|
224
224
|
hex : str
|
225
225
|
A hexadecimal color string in the format '#RRGGBB'.
|
226
226
|
alpha : float , optional
|
227
|
-
The transparency value. 0.0 means the color is fully transparent, 1.0 means the color is fully opaque.
|
227
|
+
The transparency value. 0.0 means the color is fully transparent, 1.0 means the color is fully opaque. Default is None
|
228
228
|
which means no transparency value will be included in the returned color.
|
229
229
|
Returns
|
230
230
|
-------
|
@@ -259,17 +259,17 @@ class Color:
|
|
259
259
|
Parameters
|
260
260
|
----------
|
261
261
|
value : float , optional
|
262
|
-
The input value.
|
262
|
+
The input value. Default is 0.5.
|
263
263
|
minValue : float , optional
|
264
|
-
the input minimum value.
|
264
|
+
the input minimum value. Default is 0.0.
|
265
265
|
maxValue : float , optional
|
266
|
-
The input maximum value.
|
266
|
+
The input maximum value. Default is 1.0.
|
267
267
|
alpha : float , optional
|
268
|
-
The alpha (transparency) value. 0.0 means the color is fully transparent, 1.0 means the color is fully opaque.
|
268
|
+
The alpha (transparency) value. 0.0 means the color is fully transparent, 1.0 means the color is fully opaque. Default is 1.0.
|
269
269
|
useAlpha : bool , optional
|
270
270
|
If set to True, the returns list includes the alpha value as a fourth element in the list.
|
271
271
|
colorScale : str , optional
|
272
|
-
The desired type of plotly color scales to use (e.g. "Viridis", "Plasma").
|
272
|
+
The desired type of plotly color scales to use (e.g. "Viridis", "Plasma"). Default is "Viridis". For a full list of names, see https://plotly.com/python/builtin-colorscales/.
|
273
273
|
|
274
274
|
Returns
|
275
275
|
-------
|
@@ -548,7 +548,7 @@ class Color:
|
|
548
548
|
color : list
|
549
549
|
The input color list. This is assumed to be in the format [r, g, b] or [r, g, b, a] where the range is from 0 to 255.
|
550
550
|
alpha : float , optional
|
551
|
-
The transparency value. 0.0 means the color is fully transparent, 1.0 means the color is fully opaque.
|
551
|
+
The transparency value. 0.0 means the color is fully transparent, 1.0 means the color is fully opaque. Default is 1.0.
|
552
552
|
useAlpha : bool , optional
|
553
553
|
If set to True, the returns list includes the alpha value as a fourth element in the list.
|
554
554
|
|