What is the meaning of the parameter "chain" in utils.facet module?

Asked by JINSUN LEE

I have found the parameter "chain" from the yade.utils module as follows;

https://yade-dem.org/doc/yade.utils.html?highlight=utils%20facet#yade.utils.facet

However, I cannot find the meaning of "chain" from the utils. sphere's document
Please tell me the meaning of the parameter "chain"

Regards,

----

yade.utils.facet(vertices, dynamic=None, fixed=True, wire=True, color=None, highlight=False, noBound=False, material=-1, mask=1, chain=-1)
Create a Facet-shaped body with given parameters. Body center is chosen as the center of the inscribed circle of the vertices triangle

Parameters:
vertices ([Vector3,Vector3,Vector3]) – coordinates of vertices in the global coordinate system.
wire (bool) – if True, facets are shown as skeleton; otherwise facets are filled
noBound (bool) – set Body.bounded
color (Vector3-or-None) – color of the facet; random color will be assigned if None.
See utils.sphere’s documentation for meaning of other parameters.

----

Question information

Language:
English Edit question
Status:
Solved
For:
Yade Edit question
Assignee:
No assignee Edit question
Solved by:
Jan Stránský
Solved:
Last query:
Last reply:
Revision history for this message
Best Jan Stránský (honzik) said :
#1

Hello,

according to the source code [1], the value of "chain" is never used.
It was left there after commit "Removing unused Body.chain" [2]. Line "b.chain=chain" was removed, but parameter "chain" was accidentally left.

So, currently it has no meaning.

Cheers
Jan

[1] https://gitlab.com/yade-dev/trunk/-/blob/master/py/utils.py#L258
[2] https://gitlab.com/yade-dev/trunk/-/commit/698e75125f027cc8899a5034cb7e92d694aa1e4d

Revision history for this message
Jérôme Duriez (jduriez) said :
#2

Cleaning in https://gitlab.com/yade-dev/trunk/-/merge_requests/825 seems to have been incomplete, sorry about that.. Thanks for feedback, I'm about to fix it

Revision history for this message
JINSUN LEE (ppk21) said :
#3

Thanks Jan Stránský, that solved my question.