cockatoo module API¶
Submodules¶
cockatoo.environment module¶
Check if Rhino is running using rhinoinside. 

Will be 

Return the version of the used networkx module. 

The version string of the networkx module that is being used. 

cockatoo.environment.
is_rhino_inside
()[source]¶ Check if Rhino is running using rhinoinside.
 Returns
bool –
True
if Rhino is running using rhinoinside, otherwiseFalse
. Raises
RhinoNotPresentError – If import of Rhino fails.

cockatoo.environment.
RHINOINSIDE
= False¶ Will be
True
if Rhino is running using rhinoinside,False
otherwise. Type

cockatoo.environment.
networkx_version
()[source]¶ Return the version of the used networkx module.
 Returns
str – The version string of the used networkx module.
 Raises
NetworkXNotPresentError – If the networkx module cannot be found.
cockatoo.exception module¶
Base class for exceptions in Cockatoo. 

Base class for import errors in Cockatoo. 

Exception raised when import of Rhino fails. 

Exception raised when import of System fails. 

Exception raised when import of NetworkX fails. 

Exception raised when NetworkX version is not 1.5. 

Exception for a serious error in a KnitNetwork of Cockatoo. 

Exception raised when vital geometry operations fail. 

Exception raised by methods relying on a mapping network if no mapping network has been assigned to the current KnitNetwork instance yet. 

Exception raised by methods which rely on a certain topology of a network if that topology could not be verified. 

Exception raised by methods relying on ‘weft’ edges if there are no ‘weft’ edges in the network. 

Exception raised by methods relying on ‘warp’ edges if there are no ‘warp’ edges in the network. 

Exception raised by methods relying on ‘end’ nodes if there are no ‘end’ nodes in the network. 

exception
cockatoo.exception.
CockatooException
[source]¶ Bases:
Exception
Base class for exceptions in Cockatoo.

exception
cockatoo.exception.
CockatooImportException
[source]¶ Bases:
ImportError
Base class for import errors in Cockatoo.

exception
cockatoo.exception.
RhinoNotPresentError
[source]¶ Bases:
cockatoo.exception.CockatooImportException
Exception raised when import of Rhino fails.

exception
cockatoo.exception.
SystemNotPresentError
[source]¶ Bases:
cockatoo.exception.CockatooImportException
Exception raised when import of System fails.

exception
cockatoo.exception.
NetworkXNotPresentError
[source]¶ Bases:
cockatoo.exception.CockatooImportException
Exception raised when import of NetworkX fails.

exception
cockatoo.exception.
NetworkXVersionError
[source]¶ Bases:
cockatoo.exception.CockatooException
Exception raised when NetworkX version is not 1.5.

exception
cockatoo.exception.
KnitNetworkError
[source]¶ Bases:
cockatoo.exception.CockatooException
Exception for a serious error in a KnitNetwork of Cockatoo.

exception
cockatoo.exception.
KnitNetworkGeometryError
[source]¶ Bases:
cockatoo.exception.KnitNetworkError
Exception raised when vital geometry operations fail.

exception
cockatoo.exception.
MappingNetworkError
[source]¶ Bases:
cockatoo.exception.KnitNetworkError
Exception raised by methods relying on a mapping network if no mapping network has been assigned to the current KnitNetwork instance yet.

exception
cockatoo.exception.
KnitNetworkTopologyError
[source]¶ Bases:
cockatoo.exception.KnitNetworkError
Exception raised by methods which rely on a certain topology of a network if that topology could not be verified.

exception
cockatoo.exception.
NoWeftEdgesError
[source]¶ Bases:
cockatoo.exception.KnitNetworkError
Exception raised by methods relying on ‘weft’ edges if there are no ‘weft’ edges in the network.

exception
cockatoo.exception.
NoWarpEdgesError
[source]¶ Bases:
cockatoo.exception.KnitNetworkError
Exception raised by methods relying on ‘warp’ edges if there are no ‘warp’ edges in the network.

exception
cockatoo.exception.
NoEndNodesError
[source]¶ Bases:
cockatoo.exception.KnitNetworkError
Exception raised by methods relying on ‘end’ nodes if there are no ‘end’ nodes in the network.
cockatoo.utilities module¶
Blend between two colors using the square root of photon flux. 

Breaks a polyline at kinks based on a specified angle. 

Make a list of HSL colors where the values are mapped onto a targetMintargetMax hue domain. 

Tweens between two planes using quaternion rotation. 

Determine if c is on the left of ab when looking from a to b, and assuming that all points lie in the XY plane. 

Resolve topological order of a networkx DiGraph through backtracking of all nodes in the graph. 

cockatoo.utilities.
blend_colors
(col_a, col_b, t=0.5)[source]¶ Blend between two colors using the square root of photon flux. For more info see Algorithm for additive color mixing for RGB values 18.
 Parameters
 Returns
color (tuple) – 3tuple of (R, G, B) that defines the new color.
References
 18
Algorithm for additive color mixing for RGB values

cockatoo.utilities.
break_polyline
(polyline, break_angle, as_crv=False)[source]¶ Breaks a polyline at kinks based on a specified angle. Will move the seam of closed polylines to the first kink discovered.
 Parameters
 Returns
polyline_segments (list of
Rhino.Geometry.Polyline
) – A list of the broken segments as Polylines ifas_crv
isFalse
.polyline_segments (list of
Rhino.Geometry.PolylineCurve
) – A list of the broken segments as PolylineCurves ifas_crv
isTrue
.

cockatoo.utilities.
map_values_as_colors
(values, src_min, src_max, target_min=0.0, target_max=0.7)[source]¶ Make a list of HSL colors where the values are mapped onto a targetMintargetMax hue domain. Meaning that low values will be red, medium values green and large values blue if target_min is
0.0
and target_max is0.7
. Parameters
values (list) – List of values to map as colors.
src_min (float) – Lower bounds of the value domain.
src_max (float) – Upper bounds of the value domain.
target_min (float, optional) –
Lower bounds of the target (color) domain.
Defaults to
0
.target_max (float, optional) –
Upper bounds of the target (color) domain.
Defaults to
0.7
.
 Returns
colors (list) – List of RGB colors corresponding to the input values.
Notes
Based on code by Anders Holden Deleuran. Code was only changed in regards of defaults and names. For more info see mapValuesAsColors.py 10 .
References
 10
Deleuran, Anders Holden mapValuesAsColors.py

cockatoo.utilities.
tween_planes
(pa, pb, t)[source]¶ Tweens between two planes using quaternion rotation. Based on code by Chris Hanley. 19
 Parameters
pa (
Rhino.Geometry.Plane
) – The start plane for the tween.pb (
Rhino.Geometry.Plane
) – The end plane for the tween.t (float) – The parameter for the tweened plane. 0.5 will result in the average between the two input planes.
 Returns
tweened_plane (
Rhino.Geometry.Plane
) – The plane betweenpa
andpb
at parametert
. Raises
SystemNotPresentError – If the
System
module cannot be imported.
References
 19
Average between two planes

cockatoo.utilities.
is_ccw_xy
(a, b, c, colinear=False)[source]¶ Determine if c is on the left of ab when looking from a to b, and assuming that all points lie in the XY plane.
 Parameters
a (sequence of float) – XY(Z) coordinates of the base point.
b (sequence of float) – XY(Z) coordinates of the first end point.
c (sequence of float) – XY(Z) coordinates of the second end point.
colinear (bool, optional) – Allow points to be colinear. Default is
False
.
 Returns
bool –
True
if ccw.False
otherwise.
Notes
Based on an implementation inside the COMPAS framework. For more info, see 14 and 15.
References
 14
Van Mele, Tom et al. COMPAS: A framework for computational research in architecture and structures.
 15
Marsh, C. Computational Geometry in Python: From Theory to Application.
Examples
>>> print(is_ccw_xy([0,0,0], [0,1,0], [1, 0, 0])) True >>> print(is_ccw_xy([0,0,0], [0,1,0], [+1, 0, 0])) False >>> print(is_ccw_xy([0,0,0], [1,0,0], [2,0,0])) False >>> print(is_ccw_xy([0,0,0], [1,0,0], [2,0,0], True)) True

cockatoo.utilities.
resolve_order_by_backtracking
(G)[source]¶ Resolve topological order of a networkx DiGraph through backtracking of all nodes in the graph. Nodes are only inserted into the output list if all their dependencies (predecessor nodes) are already inside the output list, otherwise the algorithm will first resolve all open dependencies.
 Parameters
G (
networkx.Graph
) – The graph on which to perform topological sorting. Returns
ordered_nodes (list) – List of hashable node identifiers.
 Raises
ValueError – If the input graph is not directed.
Warning
For this to work, the input gaph must be a DAG (directed acyclic graph). For more info,see 11 and 12.
References
 11
Directed acyclic graph on Wikipedia.
 12
Topological sorting on Wikipedia.
See: Topological sorting

cockatoo.utilities.
pairwise
(iterable)[source]¶ Returns the data of iterable in pairs (2tuples).
 Parameters
iterable (iterable) – An iterable sequence of items.
 Yields
tuple – Two items per iteration, if there are at least two items in the iterable.
Examples
>>> print(pairwise(range(4))): ... [(0, 1), (1, 2), (2, 3)]
Notes
For more info see 16 .
References
Classes¶
Datastructure for representing constraints derived from a mesh. 

Abstract datastructure for representing a network (graph) consisting of nodes with special attributes aswell as ‘warp’ edges, ‘weft’ edges and contour edges which are neither ‘warp’ nor ‘weft’. 

Datastructure for representing a network (graph) consisting of nodes with special attributes aswell as ‘warp’ edges, ‘weft’ edges and contour edges which are neither ‘warp’ nor ‘weft’. 

Datastructure representing a directed graph of nodes aswell as ‘weft’ and ‘warp’ edges. 

Datastructure representing a mapping between connected chains of ‘weft’ edges in a KnitNetwork for final creation of ‘weft’ and ‘warp’ edges. 
cockatoo.KnitConstraint¶

class
cockatoo.
KnitConstraint
(start_course, end_course, left_boundary, right_boundary)[source]¶ Bases:
object
Datastructure for representing constraints derived from a mesh. Used for the automatic generation of knitting patterns.

ToString
()[source]¶ Return a textual description of the constraint.
 Returns
description (str) – A textual description of the constraint.
Notes
Used for overloading the Grasshopper display in data parameters.

property
end_course
¶ The end course of the KnitConstraint

property
left_boundary
¶ The left boundary of the KnitConstraint

property
right_boundary
¶ The right boundary of the KnitConstraint

property
start_course
¶ The start course of the KnitConstraint

cockatoo.KnitNetworkBase¶

class
cockatoo.
KnitNetworkBase
(data=None, **attr)[source]¶ Bases:
networkx.classes.graph.Graph
Abstract datastructure for representing a network (graph) consisting of nodes with special attributes aswell as ‘warp’ edges, ‘weft’ edges and contour edges which are neither ‘warp’ nor ‘weft’.
Used as a base class for sharing behaviour between the KnitNetwork, KnitMappingNetwork and KnitDiNetwork classes.
Inherits from
networkx.Graph
. For more info, see NetworkX 13.References
 13(1,2,3)
Hagberg, Aric A.; Schult, Daniel A.; Swart, Pieter J. Exploring Network Structure, Dynamics, and Function using NetworkX In: Varoquaux, Vaught et al. (Hg.) 2008  Proceedings of the 7th Python in Science Conference pp. 1115
See: NetworkX 1.5

ToString
()[source]¶ Return a textual description of the network.
 Returns
description (str) – A textual description of the network.
Notes
Used for overloading the Grasshopper display in data parameters.

all_ends_by_position
(data=False)[source]¶ Gets all ‘end’ nodes ordered by their ‘position’ attribute.
 Parameters
data (bool, optional) –
If
True
, found nodes will be returned with their attribute data.Defaults to
False
. Returns
nodes (
list
oflist
) – All nodes for which the attribute ‘end’ is true, grouped by their ‘position’ attribute

all_leaves_by_position
(data=False)[source]¶ Gets all ‘leaf’ nodes ordered by their ‘position’ attribute.
 Parameters
data (bool, optional) –
If
True
, found nodes will be returned with their attribute data.Defaults to
False
. Returns
nodes (
list
oflist
) – All nodes for which the attribute ‘leaf’ is true, grouped by their ‘position’ attribute

all_nodes_by_position
(data=False)[source]¶ Gets all the nodes of the network, ordered by the values of their ‘position’ attribute.
 Parameters
data (bool, optional) –
If
True
, found nodes will be returned with their attribute data.Defaults to
False
. Returns
nodes (
list
oflist
) – All nodes grouped by their ‘position’ attribute

property
contour_edges
¶ The contour edges of the network marked neither ‘weft’ nor ‘warp’.

create_contour_edge
(from_node, to_node)[source]¶ Creates an edge neither ‘warp’ nor ‘weft’ between two nodes in the network.

create_segment_contour_edge
(from_node, to_node, segment_value, segment_geo)[source]¶ Creates a mapping edge between two ‘end’ nodes in the network. The geometry of this edge will be a polyline built from all the given former ‘weft’ edges. returns True if the edge has been successfully created.
 Parameters
from_node (
tuple
) – 2tuple of (node_identifier, node_data) that represents the edges’ source node.to_node (
tuple
) – 2tuple of (node_identifier, node_data) that represents the edges’ target node.segment_value (
tuple
ofint
) – 3tuple that will be used to set the ‘segment’ attribute of the ‘weft’ edge.segment_geo (
list
ofRhino.Geometry.Line
) – the geometry of all ‘weft’ edges that make this segment contour edge
 Returns
success (bool) –
True
if the edge has been successfully created,False
otherwise

create_warp_edge
(from_node, to_node)[source]¶ Creates a ‘warp’ edge between two nodes in the network.

create_weft_edge
(from_node, to_node, segment=None)[source]¶ Creates a ‘weft’ edge between two nodes in the network.
 Parameters
 Returns
success (bool) –
True
if the edge has been successfully created.False
otherwise.

edge_geometry_direction
(u, v)[source]¶ Returns a given edge in order with reference to the direction of the associated geometry (line).
 Parameters
u (hashable) – Hashable identifier of the edges source node.
v (hashable) – Hashable identifier of the edges target node.
 Returns
edge (2tuple) – 2tuple of (u, v) or (v, u) depending on the directions

end_node_segments_by_end
(node, data=False)[source]¶ Get all the edges with a ‘segment’ attribute marked neither ‘weft’ nor ‘warp’ and share a given ‘end’ node at the end, sorted by the values of their ‘segment’ attribute.
 Parameters
node (hashable) – Hashable identifier of the node to check for connected segments.
data (bool, optional) –
If
True
, the edges will be returned as 3tuples with their associated attribute data.Defaults to
False
.
 Returns
edges (list) – List of edges. Each item will be either a 2tuple of (u, v) identifiers or a 3tuple of (u, v, d) where d is the attribute data of the edge, depending on the data parameter.

end_node_segments_by_start
(node, data=False)[source]¶ Get all the edges with a ‘segment’ attribute marked neither ‘weft’ nor ‘warp’ and share a given ‘end’ node at the start, sorted by the values of their ‘segment’ attribute.
 Parameters
node (hashable) – Hashable identifier of the node to check for connected segments.
data (bool, optional) –
If
True
, the edges will be returned as 3tuples with their associated attribute data.Defaults to
False
.
 Returns
edges (
list
) – List of edges. Each item will be either a 2tuple of (u, v) identifiers or a 3tuple of (u, v, d) where d is the attribute data of the edge, depending on the data parameter.

property
end_nodes
¶ All ‘end’ nodes of the network

ends_on_position
(position, data=False)[source]¶ Gets all ‘end’ nodes which share the supplied value as their ‘position’ attribute.
 Parameters
position (hashable) – The index / identifier of the position
data (bool, optional) –
If
True
, found nodes will be returned with their attribute data.Defaults to
False
.
 Returns
nodes (
list
) – List of all nodes for which the attribute ‘end’ isTrue
and which share the supplied value as their ‘position’ attribute

geometry_at_position_contour
(position, as_crv=False)[source]¶ Gets the contour polyline at a given position by making a polyline from all nodes which share the specified ‘position’ attribute.
 Parameters
position (hashable) – The index / identifier of the position
as_crv (bool, optional) –
If
True
, will return a PolylineCurve instead of a Polyline.Defaults to
False
.
 Returns
contour (
Rhino.Geometry.Polyline
) – The contour as a Polyline ifas_crv
isFalse
.contour (
Rhino.Geometry.PolylineCurve
) – The contour as a PolylineCurve ifas_crv
isTrue
.

property
leaf_nodes
¶ All ‘leaf’ nodes of the network.

leaves_on_position
(position, data=False)[source]¶ Gets all ‘leaf’ nodes which share the supplied value as their ‘position’ attribute.
 Parameters
position (hashable) – The index / identifier of the position
data (bool, optional) –
If
True
, found nodes will be returned with their attribute data.Defaults to
False
.
 Returns
nodes (
list
) – List of all nodes for which the attribute ‘leaf’ isTrue
and which share the supplied value as their ‘position’ attribute

longest_position_contour
()[source]¶ Gets the longest contour ‘position’, geometry andgeometric length.
 Returns
contour_data (
tuple
) – 3tuple of the ‘position’ identifier, the contour geometry and its length.

node_contour_edges
(node, data=False)[source]¶ Gets the edges marked neither ‘warp’ nor ‘weft’ connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for edges marked neither ‘warp’ nor ‘weft’.
data (bool, optional) –
If
True
, the edges will be returned as 3tuples with their associated attribute data.Defaults to
False
.
 Returns
edges (
list
) – List of edges marked neither ‘warp’ nor ‘weft’ connected to the given node. Each item in the list will be either a 2tuple of (u, v) identifiers or a 3tuple of (u, v, d) where d is the attribute data of the edge, depending on the data parameter.

node_coordinates
(node_index)[source]¶ Gets the node coordinates from the ‘x’, ‘y’ and ‘z’ attributes of the supplied node.

node_from_point3d
(node_index, pt, position=None, num=None, leaf=False, start=False, end=False, segment=None, increase=False, decrease=False, color=None)[source]¶ Creates a network node from a Rhino Point3d and attributes.
 Parameters
node_index (hashable) – The index of the node in the network. Usually an integer is used.
pt (
Rhino.Geometry.Point3d
) – A RhinoCommon Point3d object.position (hashable, optional) –
The ‘position’ attribute of the node identifying the underlying contour edge of the network.
Defaults to
None
.num (int, optional) –
The ‘num’ attribute of the node representing its index in the underlying contour edge of the network.
Defaults to
None
.leaf (bool, optional) –
The ‘leaf’ attribute of the node identifying it as a node on the first or last course of the knitting pattern.
Defaults to
False
.start (bool, optional) –
The ‘start’ attribute of the node identifying it as the start of a course.
Defaults to
False
.end (bool, optional) –
The ‘end’ attribute of the node identifying it as the end of a segment or course.
Defaults to
False
.segment (
tuple
ofint
, optional) –The ‘segment’ attribute of the node identifying its position between two ‘end’ nodes.
Defaults to
None
.increase (bool, optional) –
The ‘increase’ attribute identifying the node as an increase (needed for translation from dual to 2d knitting pattern).
Defaults to
False
.decrease (bool, optional) –
The ‘decrease’ attribute identifying the node as a decrease (needed for translation from dual to 2d knitting pattern).
Defaults to
False
.color (
System.Drawing.Color
, optional) –The ‘color’ attribute of the node, representing the color of the pixel when translating the network to a 2d knitting pattern.
Defaults to
None
.

node_geometry
(node_index)[source]¶ Gets the geometry from the ‘geo’ attribute of the supplied node.
 Parameters
node_index (hashable) – The unique identifier of the node, an int in most cases.
 Returns
geometry (data) – The data of the ‘geo’ attribute of the specified node or
None
if the node is not present or has no ‘geo’ attribute.

node_warp_edges
(node, data=False)[source]¶ Gets the ‘warp’ edges connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for ‘warp’ edges.
data (bool, optional) –
If
True
, the edges will be returned as 3tuples with their associated attribute data.Defaults to
False
.
 Returns
edges (
list
) – List of ‘warp’ edges connected to the given node. Each item in the list will be either a 2tuple of (u, v) identifiers or a 3tuple of (u, v, d) where d is the attribute data of the edge, depending on the data parameter.

node_weft_edges
(node, data=False)[source]¶ Gets the ‘weft’ edges connected to a given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for ‘weft’ edges.
data (bool, optional) –
If
True
, the edges will be returned as 3tuples with their associated attribute data.Defaults to
False
.
 Returns
edges (
list
) – List of ‘weft’ edges connected to the given node. Each item in the list will be either a 2tuple of (u, v) identifiers or a 3tuple of (u, v, d) where d is the attribute data of the edge, depending on the data parameter.

nodes_on_position
(position, data=False)[source]¶ Gets the nodes on a given position (i.e. contour) by returning all nodes which share the given value as their ‘position’ attribute.
 Parameters
position (hashable) – The index of the position.
data (bool, optional) –
If
True
, found nodes will be returned with their attribute data.Defaults to
False
.
 Returns
nodes (
list
) – The nodes sharing the supplied ‘position’ attribute.

nodes_on_segment
(segment, data=False)[source]¶ Gets all nodes on a given segment by finding all nodes which share the specified value as their ‘segment’ attribute, ordered by the value of their ‘num’ attribute.
 Parameters
segment (hashable) – The identifier of the segment to look for.
data (bool, optional) –
If
True
, found nodes will be returned with their attribute data.Defaults to
False
.
 Returns
nodes (
list
) – List of nodes sharing the supplied value as their ‘segment’ attribute, ordered by their ‘num’ attribute.

prepare_for_gephi
()[source]¶ Creates a new graph with attributes for visualising this network using Gephi.
Based on code by Anders Holden Deleuran

prepare_for_graphviz
()[source]¶ Creates a new graph with attributes for visualising this network using GraphViz.
Based on code by Anders Holden Deleuran

property
segment_contour_edges
¶ The edges of the network marked neither ‘warp’ nor ‘weft’ and which have a ‘segment’ attribute assigned to them.

property
total_positions
¶ The total number of positions (i.e. contours) inside the network

property
warp_edges
¶ The edges of the network marked ‘warp’.

property
weft_edges
¶ The edges of the network marked ‘weft’.
cockatoo.KnitNetwork¶

class
cockatoo.
KnitNetwork
(data=None, **attr)[source]¶ Bases:
cockatoo._knitnetworkbase.KnitNetworkBase
Datastructure for representing a network (graph) consisting of nodes with special attributes aswell as ‘warp’ edges, ‘weft’ edges and contour edges which are neither ‘warp’ nor ‘weft’.
Used for the automatic generation of knitting patterns based on mesh or NURBS surface geometry.
Inherits from
KnitNetworkBase
.Notes
The implemented algorithms are strongly based on the paper Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.
The implementation was further influenced by concepts and ideas presented in the papers Automatic Machine Knitting of 3D Meshes 3, Visual Knitting Machine Programming 4 and A Compiler for 3D Machine Knitting 5.
References
 1(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15)
Popescu, Mariana et al. Automated Generation of Knit Patterns for Nondevelopable Surfaces
See: Automated Generation of Knit Patterns for Nondevelopable Surfaces
 2(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15)
Popescu, Mariana KnitCrete  Stayinplace knitted formworks for complex concrete structures
See: KnitCrete  Stayinplace knitted formworks for complex concrete structures
 3(1,2,3)
Narayanan, Vidya; Albaugh, Lea; Hodgins, Jessica; Coros, Stelian; McCann, James Automatic Machine Knitting of 3D Meshes
 4(1,2,3)
Narayanan, Vidya; Wu, Kui et al. Visual Knitting Machine Programming
 5(1,2,3)
McCann, James; Albaugh, Lea; Narayanan, Vidya; Grow, April; Matusik, Wojciech; Mankoff, Jen; Hodgins, Jessica A Compiler for 3D Machine Knitting

ToString
()[source]¶ Return a textual description of the network.
 Returns
description (str) – A textual description of the network.
Notes
Used for overloading the Grasshopper display in data parameters.

all_nodes_by_segment
(data=False, edges=False)[source]¶ Returns all nodes of the network ordered by ‘segment’ attribute. Note: ‘end’ nodes are not included!
 Parameters
data (bool, optional) –
If
True
, the nodes contained in the output will be represented as 2tuples in the form of (node_identifier, node_data).Defaults to
False
edges (bool, optional) –
If
True
, the returned output list will contain 3tuples in the form of (segment_value, segment_nodes, segment_edge).Defaults to
False
.
 Returns
nodes_by_segment (
list
oftuple
) – List of 2tuples in the form of (segment_value, segment_nodes) or 3tuples in the form of (segment_value, segment_nodes, segment_edge) depending on theedges
argument. Raises
MappingNetworkError – If the mapping network is not available for this instance.

assign_segment_attributes
()[source]¶ Get the segmentation for loop generation and assign ‘segment’ attributes to ‘weft’ edges and nodes.

attempt_warp_connection
(node, candidate, source_nodes, max_connections=4, verbose=False)[source]¶ Method for attempting a ‘warp’ connection to a candidate node based on certain parameters.
 Parameters
node (node) – The starting node for the possible ‘weft’ edge.
candidate (node) – The target node for the possible ‘weft’ edge.
source_nodes (
list
) – List of nodes on the position contour of node. Used to check if the candidate node already has a connection.max_connections (int, optional) –
The new ‘weft’ connection will only be made if the candidate nodes number of connected neighbors is below this.
Defaults to
4
.verbose (bool, optional) –
If
True
, this routine and all its subroutines will print messages about what is happening to the console.Defaults to
False
.
 Returns
result (bool) – True if the connection has been made, otherwise false.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

attempt_weft_connection
(node, candidate, source_nodes, max_connections=4, verbose=False)[source]¶ Method for attempting a ‘weft’ connection to a candidate node based on certain parameters.
 Parameters
node (
tuple
) – 2tuple representing the source node for the possible ‘weft’ edge.candidate (
tuple
) – tuple representing the target node for the possible ‘weft’ edge.source_nodes (
list
) – List of nodes on the position contour of node. Used to check if the candidate node already has a connection.max_connections (int, optional) –
The new ‘weft’ connection will only be made if the candidate nodes number of connected neighbors is below this.
Defaults to
4
.verbose (bool, optional) –
If
True
, this routine and all its subroutines will print messages about what is happening to the console.Defaults to
False
.
 Returns
bool –
True
if the connection has been made,False
otherwise.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

create_dual
(mode= 1, merge_adj_creases=False, mend_trailing_rows=False)[source]¶ Creates the dual of this KnitNetwork while translating current edge attributes to the edges of the dual network.
 Parameters
mode (int, optional) –
Determines how the neighbors of each node are sorted when finding cycles for the network.
1
equals to using the world XY plane.0
equals to using a plane normal to the origin nodes closest point on the reference geometry.1
equals to using a plane normal to the average of the origin and neighbor nodes’ closest points on the reference geometry.2
equals to using an average plane between a plane fit to the origin and its neighbor nodes and a plane normal to the origin nodes closest point on the reference geometry.Defaults to
1
.merge_adj_creases (bool, optional) –
If
True
, will merge adjacent ‘increase’ and ‘decrease’ nodes connected by a ‘weft’ edge into a single node. This effectively simplifies the pattern, as a decrease is unneccessary to perform if an increase is right beside it  both nodes can be replaced by a single regular node (stitch).Defaults to
False
.mend_trailing_rows (bool, optional) –
If
True
, will attempt to mend trailing rows by reconnecting nodes.Defaults to
False
.
 Returns
dual_network (
KnitDiNetwork
) – The dual network of this KnitNetwork.
Warning
Modes other than 1 (default) are only possible if this network has an underlying reference geometry in form of a Mesh or NurbsSurface. The reference geometry should be assigned when initializing the network by assigning the geometry to the ‘reference_geometry’ attribute of the network.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

create_final_warp_connections
(max_connections=4, include_end_nodes=True, precise=False, verbose=False)[source]¶ Create the final ‘warp’ connections by building chains of segment contour edges and connecting them.
For each source chain, a target chain is found using an ‘educated guessing’ strategy. This means that the possible target chains are guessed by leveraging known topology facts about the network and its special ‘end’ nodes.
 Parameters
max_connections (int, optional) –
The number of maximum previous connections a candidate node for a ‘warp’ connection is allowed to have.
Defaults to
4
.include_end_nodes (bool, optional) –
If
True
, ‘end’ nodes between adjacent segment contours in a source chain will be included in the first pass of connecting ‘warp’ edges.Defaults to
True
.precise (bool) –
If
True
, the distance between nodes will be calculated using the Rhino.Geometry.Point3d.DistanceTo method, otherwise the much faster Rhino.Geometry.Point3d.DistanceToSquared method is used.Defaults to
False
.verbose (bool, optional) –
If
True
, this routine and all its subroutines will print messages about what is happening to the console. Great for debugging and analysis.Defaults to
False
.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

create_final_weft_connections
()[source]¶ Loop through all the segment contour edges and create all ‘weft’ connections for this network.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

classmethod
create_from_contours
(contours, course_height, reference_geometry=None)[source]¶ Create and initialize a KnitNetwork based on a set of contours, a given course height and an optional reference geometry. The reference geometry is a mesh or surface which should be described by the network. While it is optional, it is HIGHLY recommended to provide it!
 Parameters
contours (
list
ofRhino.Geometry.Polyline
) – orRhino.Geometry.Curve
Ordered contours (i.e. isocurves, isolines) to initialize the KnitNetwork with.course_height (float) – The course height for sampling the contours.
reference_geometry (
Rhino.Geometry.Mesh
) – orRhino.Geometry.Surface
Optional underlying geometry that this network is based on.
 Returns
KnitNetwork (KnitNetwork) – A new, initialized KnitNetwork instance.
Notes
This method will automatically call initialize_position_contour_edges() on the newly created network!
 Raises
KnitNetworkGeometryError – If a supplied contour is not a valid instance of
Rhino.Geometry.Polyline
orRhino.Geometry.Curve
.

create_mapping_network
()[source]¶ Creates the corresponding mapping network for the final loop generation from a KnitNetwork instance with fully assigned ‘segment’ attributes.
The created mapping network will be part of the KnitNetwork instance. It can be accessed using the mapping_network property.
Notes
All nodes without an ‘end’ attribute as well as all ‘weft’ edges are removed by this step. Final nodes as well as final ‘weft’ and ‘warp’ edges can only be created using the mapping network.
 Returns
success (bool) –
True
if the mapping network has been successfully created,False
otherwise.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

create_mesh
(mode= 1, max_valence=4)[source]¶ Constructs a mesh from this network by finding cycles and using them as mesh faces.
 Parameters
mode (int, optional) –
Determines how the neighbors of each node are sorted when finding cycles for the network.
1
equals to using the world XY plane.0
equals to using a plane normal to the origin nodes closest point on the reference geometry.1
equals to using a plane normal to the average of the origin and neighbor nodes’ closest points on the reference geometry.2
equals to using an average plane between a plane fit to the origin and its neighbor nodes and a plane normal to the origin nodes closest point on the reference geometry.Defaults to
1
.max_valence (int, optional) –
Sets the maximum edge valence of the faces. If this is set to > 4, ngon faces (more than 4 edges) are allowed. Otherwise, their cycles are treated as invalid and will be ignored.
Defaults to
4
.
Warning
Modes other than
1
are only possible if this network has an underlying reference geometry in form of a Mesh or NurbsSurface. The reference geometry should be assigned when initializing the network by assigning the geometry to the “reference_geometry” attribute of the network.

find_cycles
(mode= 1)[source]¶ Finds the cycles (faces) of this network by utilizing a wallfollower mechanism.
 Parameters
mode (int, optional) –
Determines how the neighbors of each node are sorted when finding cycles for the network.
1
equals to using the world XY plane.0
equals to using a plane normal to the origin nodes closest point on the reference geometry.1
equals to using a plane normal to the average of the origin and neighbor nodes’ closest points on the reference geometry.2
equals to using an average plane between a plane fit to the origin and its neighbor nodes and a plane normal to the origin nodes closest point on the reference geometry.Defaults to
1
.
Warning
Modes other than
1
are only possible if this network has an underlying reference geometry in form of a Mesh or NurbsSurface. The reference geometry should be assigned when initializing the network by assigning the geometry to the “reference_geometry” attribute of the network.Notes
Based on an implementation inside the COMPAS framework. For more info see 16.

initialize_leaf_connections
()[source]¶ Create all initial connections of the ‘leaf’ nodes by iterating over all position contours and creating ‘weft’ edges between the ‘leaf’ nodes of the position contours.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

initialize_position_contour_edges
()[source]¶ Creates all initial position contour edges as neither ‘warp’ nor ‘weft’ by iterating over all nodes in the network and grouping them based on their ‘position’ attribute.
Notes
This method is automatically called when creating a KnitNetwork using the create_from_contours method!
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

initialize_warp_edges
(contour_set=None, verbose=False)[source]¶ Method for initializing first ‘warp’ connections once all preliminary ‘weft’ connections are made.
 Parameters
contour_set (
list
, optional) –List of lists of nodes to initialize ‘warp’ edges. If none are supplied, all nodes ordered by thei ‘position’ attributes are used.
Defaults to
None
.verbose (bool, optional) –
If
True
, will print verbose output to the console.Defaults to
False
.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

initialize_weft_edges
(start_index=None, propagate_from_center=False, force_continuous_start=False, force_continuous_end=False, angle_threshold=0.10471975511965978, max_connections=4, least_connected=False, precise=False, verbose=False)[source]¶ Attempts to create all the preliminary ‘weft’ connections for the network.
 Parameters
start_index (int, optional) –
This value defines at which index the list of contours is split. If no index is supplied, will split the list at the longest contour.
Defaults to
None
.propagate_from_center (bool, optional) –
If
True
, will propagate left and right set of contours from the center contour defined by start_index or the longest contour ( <  > ). Otherwise, the propagation of the contours left to the center will start at the left boundary ( >  > ).Defaults to
False
force_continuous_start (bool, optional) –
If
True
, forces the first row of stitches to be continuous.Defaults to
False
.force_continuous_end (bool, optional) –
If
True
, forces the last row of stitches to be continuous.Defaults to
False
.max_connections (int, optional) –
The maximum connections a node is allowed to have to be considered for an additional ‘weft’ connection.
Defaults to
4
.least_connected (bool, optional) –
If
True
, uses the least connected node from the found candidates.Defaults to
False
precise (bool, optional) –
If
True
, the distance between nodes will be calculated using the Rhino.Geometry.Point3d.DistanceTo method, otherwise the much faster Rhino.Geometry.Point3d.DistanceToSquared method is used.Defaults to
False
.verbose (bool, optional) –
If
True
, this routine and all its subroutines will print messages about what is happening to the console. Great for debugging and analysis.Defaults to
False
.
 Raises
KnitNetworkError – If the supplied splitting index is too high.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

property
mapping_network
¶ The associated mapping network of this KnitNetwork instance.

sample_segment_contours
(stitch_width)[source]¶ Samples the segment contours of the mapping network with the given stitch width. The resulting points are added to the network as nodes and a ‘segment’ attribute is assigned to them based on their origin segment contour edge.
 Parameters
stitch_width (float) – The width of a single stitch inside the knit.
 Raises
MappingNetworkError – If the mapping network is not available for this instance.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

to_KnitDiNetwork
()[source]¶ Constructs and returns a directed KnitDiNetwork based on this network by duplicating all edges so that [u > v] and [v > u] for every edge [u  v] in this undirected network.
 Returns
directed_network (
KnitDiNetwork
) – The directed representation of this network.
cockatoo.KnitDiNetwork¶

class
cockatoo.
KnitDiNetwork
(data=None, **attr)[source]¶ Bases:
networkx.classes.digraph.DiGraph
,cockatoo._knitnetworkbase.KnitNetworkBase
Datastructure representing a directed graph of nodes aswell as ‘weft’ and ‘warp’ edges. Used in the automatic generation of knitting patterns.
Inherits from
networkx.DiGraph
,KnitNetworkBase
. For more info, see NetworkX 13.Notes
The implemented algorithms are strongly based on the paper Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.
The implementation was further influenced by concepts and ideas presented in the papers Automatic Machine Knitting of 3D Meshes 3, Visual Knitting Machine Programming 4 and A Compiler for 3D Machine Knitting 5.

ToString
()[source]¶ Return a textual description of the network.
 Returns
description (str) – A textual description of the network.
Notes
Used for overloading the Grasshopper display in data parameters.

create_mesh
(mode= 1, max_valence=4)[source]¶ Constructs a mesh from this network by finding cycles and using them as mesh faces.
 Parameters
mode (int, optional) –
Determines how the neighbors of each node are sorted when finding cycles for the network.
1
equals to using the world XY plane.0
equals to using a plane normal to the origin nodes closest point on the reference geometry.1
equals to using a plane normal to the average of the origin and neighbor nodes’ closest points on the reference geometry.2
equals to using an average plane between a plane fit to the origin and its neighbor nodes and a plane normal to the origin nodes closest point on the reference geometry.Defaults to
1
.max_valence (int, optional) –
Sets the maximum edge valence of the faces. If this is set to > 4, ngon faces (more than 4 edges) are allowed. Otherwise, their cycles are treated as invalid and will be ignored.
Defaults to
4
.
Warning
Modes other than
1
are only possible if this network has an underlying reference geometry in form of a Mesh or NurbsSurface. The reference geometry should be assigned when initializing the network by assigning the geometry to the “reference_geometry” attribute of the network.

find_cycles
(mode= 1)[source]¶ Finds the cycles (faces) of this network by utilizing a wallfollower mechanism.
 Parameters
mode (int, optional) –
Determines how the neighbors of each node are sorted when finding cycles for the network.
1
equals to using the world XY plane.0
equals to using a plane normal to the origin nodes closest point on the reference geometry.1
equals to using a plane normal to the average of the origin and neighbor nodes’ closest points on the reference geometry.2
equals to using an average plane between a plane fit to the origin and its neighbor nodes and a plane normal to the origin nodes closest point on the reference geometry.Defaults to
1
.
Warning
Modes other than 1 (default) are only possible if this network has an underlying reference geometry in form of a Mesh or NurbsSurface. The reference geometry should be assigned when initializing the network by assigning the geometry to the “reference_geometry” attribute of the network.
Notes
Based on an implementation inside the COMPAS framework. For more info see 17.
References
 17
Van Mele, Tom et al. COMPAS: A framework for computational research in architecture and structures.

make_pattern_data
(consolidate=False)[source]¶ Topological sort this network to represent it as 2d knitting pattern consisting of rows and columns.
 Parameters
consolidate (bool) – If
True
, will consolidate the final pattern data. Defaulst toFalse
. Returns
pattern_data (
list
oflist
) – List (rows) of lists (column values) where every value represents a node. Raises
KnitNetworkTopologyError – if the network does not satisfy the topology constraints needed for this operation and the outcome would be unfeasible or unpredictable.
Notes
Closely resembles the implementation described in Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.

node_contour_edges
(node, data=False)[source]¶ Gets the incoming and outcoing edges marked neither ‘warp’ nor ‘weft’ connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for incoming and outgoing edges neither ‘weft’ nor ‘warp’.
data (bool, optional) –
If
True
, will also return the edges associated data attribute dictionary.Defaults to
False
.
 Returns
weft_edges (
list
) – List of incoming and outgoing edges neither ‘weft’ nor ‘warp’.

node_contour_edges_in
(node, data=False)[source]¶ Gets the incoming edges marked neither ‘warp’ nor ‘weft’ connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for incoming edges neither ‘weft’ nor ‘warp’.
data (bool, optional) –
If
True
, will also return the edges associated data attribute dictionary.Defaults to
False
.
 Returns
weft_edges (
list
) – List of incoming edges neither ‘weft’ nor ‘warp’.

node_contour_edges_out
(node, data=False)[source]¶ Gets the outgoing edges marked neither ‘warp’ nor ‘weft’ connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for outgoing edges neither ‘weft’ nor ‘warp’.
data (bool, optional) –
If
True
, will also return the edges associated data attribute dictionary.Defaults to
False
.
 Returns
weft_edges (
list
) – List of outgoing edges neither ‘weft’ nor ‘warp’.

node_warp_edges
(node, data=False)[source]¶ Gets the incoming and outgoing ‘warp’ edges connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for incoming and outgoing ‘warp’ edges.
data (bool, optional) –
If
True
, will also return the edges associated data attribute dictionary.Defaults to
False
.
 Returns
weft_edges (
list
) – List of incoming and outgoing ‘warp’ edges.

node_warp_edges_in
(node, data=False)[source]¶ Gets the incoming ‘warp’ edges connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for incoming ‘warp’ edges.
data (bool, optional) –
If
True
, will also return the edges associated data attribute dictionary.Defaults to
False
.
 Returns
weft_edges (
list
) – List of incoming ‘warp’ edges.

node_warp_edges_out
(node, data=False)[source]¶ Gets the outgoing ‘warp’ edges connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for outgoing ‘warp’ edges.
data (bool, optional) –
If
True
, will also return the edges associated data attribute dictionary.Defaults to
False
.
 Returns
weft_edges (
list
) – List of outgoing ‘warp’ edges.

node_weft_edges
(node, data=False)[source]¶ Gets incoming and outgoing ‘weft’ edges connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for incoming and outgoing ‘weft’ edges.
data (bool, optional) –
If
True
, will also return the edges associated data attribute dictionary.Defaults to
False
.
 Returns
weft_edges (
list
) – List of incoming and outgoing ‘weft’ edges.

node_weft_edges_in
(node, data=False)[source]¶ Gets the incoming ‘weft’ edges connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for incoming ‘weft’ edges.
data (bool, optional) –
If
True
, will also return the edges associated data attribute dictionary.Defaults to
False
.
 Returns
weft_edges (
list
) – List of incoming ‘weft’ edges.

node_weft_edges_out
(node, data=False)[source]¶ Gets the outgoing ‘weft’ edges connected to the given node.
 Parameters
node (hashable) – Hashable identifier of the node to check for outgoing ‘weft’ edges.
data (bool, optional) –
If
True
, will also return the edges associated data attribute dictionary.Defaults to
False
.
 Returns
weft_edges (
list
) – List of outgoing ‘weft’ edges.

cockatoo.KnitMappingNetwork¶

class
cockatoo.
KnitMappingNetwork
(data=None, **attr)[source]¶ Bases:
networkx.classes.multigraph.MultiGraph
,cockatoo._knitnetworkbase.KnitNetworkBase
Datastructure representing a mapping between connected chains of ‘weft’ edges in a KnitNetwork for final creation of ‘weft’ and ‘warp’ edges.
Inherits from
networkx.MultiGraph
,KnitNetworkBase
For more info, see NetworkX 13.Notes
Not intended to be instantiated separately. Should only be instantiated by the KnitNetwork.create_mapping_network method!
The implemented algorithms are strongly based on the paper Automated Generation of Knit Patterns for Nondevelopable Surfaces 1. Also see KnitCrete  Stayinplace knitted formworks for complex concrete structures 2.
The implementation was further influenced by concepts and ideas presented in the papers Automatic Machine Knitting of 3D Meshes 3, Visual Knitting Machine Programming 4 and A Compiler for 3D Machine Knitting 5.

ToString
()[source]¶ Return a textual description of the network.
 Returns
description (str) – A textual description of the network.
Notes
Used for overloading the Grasshopper display in data parameters.

build_chains
(source_as_dict=False, target_as_dict=False)[source]¶ Method for building source and target chains from segment contour edges.
 Parameters
 Returns
chains (
tuple
oflist
) – 2tuple in the form of (source_chains, target_chains).

traverse_segments_until_warp
(way_segments, down=False, by_end=False)[source]¶ Method for traversing a path of ‘segment’ edges until a ‘warp’ edge is discovered which points to the previous or the next segment. Returns the ids of the segment array.
 Parameters
way_segments (
list
) – List of segments that is filled during method execution. The list should contain the start segment when calling this method!down (bool, optional) –
If
True
, will traverse until a downwards ‘warp’ edge is discovered, otherwise will traverse antil an upwards ‘warp’ edge is discovered.Defaults to
False
by_end (bool, optional) –
If
True
, will traverse the ‘segment’ edges in the opposite direction.Defaults to
False
.
 Returns
segments (
list
) – List of segments representing a chain. Raises
ValueError: – If
way_segments
is empty at call.
