|Anonymous | Login||2014-11-27 08:13 MSK|
|My View | View Issues | Change Log | Roadmap|
|View Issue Details|
|ID||Project||Category||View Status||Date Submitted||Last Update|
|0023640||Community||[OCCT] OCCT:Documentation||public||2012-12-13 18:45||2014-11-18 11:30|
|Product Version||[OCCT] 6.5.4|
|Target Version||[OCCT] 7.1.0||Fixed in Version|
|Summary||0023640: Documentation for local sewing with BRepBuilderAPI_Sewing is missing|
|Description||In http://www.opencascade.org/org/forum/thread_24171/?forum=3 [^] it was asked how local sewing can be performed in OpenCascade.|
The answer was:
First you should Load() a context shape
and after use Add() for sub-shapes which should be locally sewed.
The forum supervisor wrote:
Unfortunately this feature still is not documented.
Therefore I suggest you to register the corresponding issue in Mantis Bug Tracker.
It would be helpful if a use case for local sewing is explained and how it can be used to get better performance than with global sewing.
Documentation about local sewing should be added to the Modeling Algorithms User's Guide as well as to the Doxygen Code documentation.
|Tags||No tags attached.|
|Test case number|
I found some information about Local Sewing on http://www.opencascade.org/occt/overview/compocc7/sewing/sewing10/ [^]
It might be useful to for the proposed documentation enhancement:
"In case when a shape still has some unsewed faces or edges after sewing, it is possible to use local sewing with a greater tolerance.
Local sewing is especially good for open shells.
Local sewing allows to sew a hole in one part of the shape and to keep a required hole smaller than the specified working tolerance for local sewing. Local sewing is much faster than sewing on the whole shape.
All pre-existing connections of the whole shape are kept after local sewing."
There are also some other pieces of information about sewing on the website, but some of it is not up-to-date, like mentioning BRepAlgo_Sewing on http://www.opencascade.org/occt/overview/compocc7/sewing/sewing2/ [^]
Dear Timo, actually, there is a section about sewing in the Technical Overview http://dev.opencascade.org/doc/overview/html/technical_overview.html#OCCT_TOVW_SECTION_4_9 [^]
As you can see, it is exactly based on the site contents.
Do you suggest somehow enhancing this?
I rather meant to describe local sewing also in the Modeling User's guide and API reference documentation. I mean, how to actually apply local sewing using the Load- and Add-method. Not much text would be needed but at least to mention this possibility and the benefits.
For me, it wasn't clear in case of local sewing:
Load(): Can the context shape also be a compound containing a shell and additional faces to be sewed or does it have to be a shell containing all faces?
Add(): Should I add here the faces to be sewed or specify certain edges of faces which should be sewed?
Additionally, some parts seem not up-to-date in the Technical overview, at least BRepAlgo_Sewing is mentionend, but it doesn't exist anymore.
OK. The section about sewing will be soon moved to the Modeling User's guide.
Dear Galina, could you do the following:
1) Review the description of Sewing to check if there is no outdated information.
2) Add a code example illustrating the usage of Local Sewing with proper comments. (And expand the section further if necessary).
Here is an example code for local sewing which I received in the frame of a support query and which could be used in the documentation:
"In order to use local sewing it is necessary to create a compound from two full sewed shapes then load full compound using method BRepBuilderAPI_Sewing::Load().
After that it is necessary to add local sub-shapes which should be sewed using method BRepBuilderAPI_Sewing::Add(). The result of sewing can be got using method BRepBuilderAPI_Sewing::SewedShape().
//initial sewed shapes
TopoDS_Shape aS1, aS2;
//sub shapes which should be locally sewed
TopoDS_Shape aRes = aSewing.SewedShape();
|2012-12-13 18:45||Timo||New Issue|
|2012-12-13 18:45||Timo||Assigned To||=> atp|
|2012-12-13 19:13||szy||Target Version||=> 6.6.0|
|2012-12-14 15:57||atp||Assigned To||atp => gka|
|2013-02-26 15:50||abv||Target Version||6.6.0 => 6.7.0|
|2013-12-16 16:20||gka||File Added: Surface_0.brep|
|2013-12-16 16:20||gka||File Added: Surface_1.brep|
|2013-12-16 16:29||gka||File Deleted: Surface_0.brep|
|2013-12-16 16:29||gka||File Deleted: Surface_1.brep|
|2013-12-21 10:13||abv||Target Version||6.7.0 => 6.7.1|
|2014-04-04 18:27||abv||Target Version||6.7.1 => 6.8.0|
|2014-07-25 14:42||Timo||Note Added: 0030424|
|2014-10-29 13:57||abv||Assigned To||gka => ysn|
|2014-10-29 13:57||abv||Status||new => assigned|
|2014-10-29 14:31||ysn||Note Added: 0033825|
|2014-10-29 15:05||ysn||Assigned To||ysn => Timo|
|2014-10-29 15:05||ysn||Status||assigned => feedback|
|2014-10-29 15:21||Timo||Note Added: 0033834|
|2014-10-29 15:22||Timo||Assigned To||Timo => ysn|
|2014-10-29 15:22||Timo||Status||feedback => assigned|
|2014-10-29 15:39||ysn||Assigned To||ysn => gka|
|2014-10-29 15:39||ysn||Note Added: 0033837|
|2014-11-06 06:37||abv||Target Version||6.8.0 => 7.1.0|
|2014-11-18 10:58||Timo||Note Added: 0034468|
|2014-11-18 11:30||gka||Assigned To||gka => ysn|
|Copyright © 2000 - 2014 MantisBT Team|