首页/文章/ 详情

CAD随机颗粒插件2D V3.0版本更新说明

32分钟前浏览1

AutoCAD 建模插件

CAD随机颗粒插件 2D

V3.0 版本更新说明

粒径口径调整 · 内层多边形边交叉修复 · 无交叉无小边约束

"

一次以几何正确性为核心的更新。

—— 渊鱼科技

V3.0 解决了两个长期存在的问题:一是"界面层"颗粒的粒径口径不直观——用户填的直径究竟是整颗颗粒还是内部骨料;二是启用内外两层且层间距较大时,多边形颗粒的内层轮廓会出现边与边交叉的错误图形。

5.png

同时本版为多边形(含长方形、正多边形)增加了一条硬性几何约束:任何一条轮廓边都不得短于粒径的 1/20。出现退化细边时会被自动合并,边数允许适当减少——优先保证图形正确,而不是死守边数。

CAD随机颗粒插件2D

CAD随机颗粒插件2D V2.0 新增功能说明

01

OVERVIEW

概述

本次更新共 5 项,涵盖口径变更、缺陷修复与统计优化:

◎

口径更直观

填的直径就是内层骨料尺寸

◎

图形更正确

无自交、无退化小边

序号更新内容性质
1粒径口径调整:表中直径 = 内层粒径,外层 = 粒径 + 2 × 两层间距变更
2修复内层多边形边交叉(自交)修复
3强制"无交叉、无小边"约束(小边阈值 = 粒径/20)新增
4碰撞口径统一为 粒径 + 2 × 层厚 + 最小间距优化
5颗数预估与填充率按外层口径统计优化

02

DIAMETER

粒径口径调整

2.1 改前与改后:表中"直径"的含义由整颗颗粒改为内层颗粒。

项目V2.0 及以前V3.0
表中"直径"的含义整颗颗粒(外层)尺寸内层颗粒粒径
内层如何得到外层逐边向内收缩一个层间距直接按粒径生成
外层如何得到即用户填写的尺寸内层各边向外平移一个层间距
外层尺寸粒径粒径 + 2 × 两层间距
碰撞判断外层 + 最小间距粒径 + 2 × 层厚 + 最小间距
粒径口径示意:外层由内层向外扩展一个层间距

图 1 粒径 = 内层尺寸;外层由内层向外均匀扩展一个层间距,因此外层对边尺寸 = 粒径 + 2t

2.2 各类形状的具体规则:

① 圆形:内层半径 = 粒径/2;外层半径 = 粒径/2 + 两层间距,严格同心。

② 长方形:内层 = 宽 × 长;外层 =(宽 + 2×间距)×(长 + 2×间距),朝向不变。

③ 多边形 / 正多边形:内层外接圆半径 = 粒径/2;外层由内层的每一条边整体向外平移一个层间距后求交得到,界面层处处等厚,对边尺寸 = 粒径 + 2×间距。

投放位置、碰撞、边界与统计一律以外层为准,因此"界面层"彼此不会侵入:两颗颗粒外层的净距不小于最小间距,等价于内层净距不小于 2×层厚 + 最小间距。

尺寸变化提示:同样参数下,开启两层后颗粒比 V2.0 大 2 × 两层间距,可投放颗数相应减少。若希望保持旧图纸的视觉尺寸,把表中直径填为"原直径 − 2 × 两层间距"即可。未启用两层时,V3.0 与 V2.0 的生成结果完全一致。


03

FIX

修复:内层多边形边交叉

3.1 现象:启用"启用内外两层(界面层)",且两层间距相对粒径较大时,随机多边形颗粒的内层多边形会出现边与边交叉,图形明显错误(如图 2 左侧)。

旧算法内层边交叉与新算法无交叉对比

图 2 旧算法在内缩过深时产生的自交轮廓与新算法的对比

3.2 原因:旧版把外层的每条边向内平移层间距,再逐顶点求"相邻两条偏移直线的交点"。当内缩较深时,某些边会被相邻边完全挤掉、不再构成约束边;但旧代码仍按原顺序求交点,交点就会落到多边形的另一侧,相邻边随即互相穿插,形成自交。

3.3 修复思路:

① 内层直接按粒径生成(尺寸精确),不再由外层反向推导;

② 外层由内层向外偏移得到——凸多边形向外偏移必然仍是凸多边形,从几何上就不可能产生交叉;

③ 仍保留内缩能力(内部接口),但改为半平面裁剪实现:已被挤掉的边自动转为非约束边、不参与求交,结果必然凸、不会交叉;

④ 生成结果统一过一遍"整理":去重合点 → 剔除小边 → 凸性兜底(不凸则取凸包)→ 顶点数与面积校验。

实测对比:外接圆半径 6、层厚取 4.0~5.6(接近粒径)的 1200 个随机多边形样本,旧算法有 557 个出现边交叉;新算法 0 个。另外对 3/5/6/12/40/200 边、层厚从 0 到 12(超过粒径本身)的批量样本做了自交检测,全部通过。


04

EDGE

新增:无交叉无小边约束

4.1 判定规则:

① 一条边的长度小于粒径/20,即认定为小边(退化细边),必须消除;

② 出现小边时,删掉该边的一个端点,让它前后的两条邻边直接相连(两条边合并为一条);

③ 凸多边形删掉一个顶点后仍然凸,且合并后的新边不短于被合并的两条边,因此不会引入新的小边或交叉,处理必然收敛;

④ 边数允许减少:本版优先保证"无交叉、无小边",边数是可放松的次要指标。例如最小直径 10 时阈值为 0.5,若随机取样恰好产生 0.2 的细边,该处会被合并,五边形可能变成四边形。

小边处理:短边端点和两条邻边合并成一条边

图 3 小边处理:把短边的端点和它的两条邻边合并成一条边,边数由 5 变为 4

4.2 高边数的例外:边数很多时(等效边长本身就远小于粒径/20,约 n > 15),若仍按 1/20 判小边,40 边、100 边这类正常多边形会被一路削成三角形。因此阈值在这些情况下自动切换为等效边长的 1/4:既能剔除退化细边,又不会破坏高边数多边形。实测 64、256、1024 边的多边形均保持原有边数。

4.3 兜底校验:

① 处理完再检查一次凸性,若不凸则取凸包(凸包一定无交叉);

② 校验顶点数 ≥ 3 且面积 > 0,仍不满足则丢弃该次随机结果、重新生成一颗;

③ 若区域尺寸连一颗颗粒都放不下,直接跳过并继续尝试其它位置,直至该档超时。


05

COLLISION

碰撞与预估口径

5.1 碰撞判断:空间网格单元尺寸、边界内缩、干涉精判全部按外层轮廓计算。网格单元边长随层厚自动放大,避免开启两层后单元划分过细、查表变慢(1024 边、层厚 25 的极端组合,单颗形状生成约 2.6 ms)。

5.2 颗数预估与填充率:预估与外层口径统一。

形状外层占位面积
圆形π(R + t)²
长方形(宽 + 2t)(长 + 2t)
多边形 / 正多边形A + P·t + n·tan(π/n)·t²(精确外扩面积)

其中 A、P、n 分别为内层面积、内层周长与边数,t 为两层间距。实际填充率同样按外层面积统计,目标值与实际值口径一致,不会再出现"预估偏多、实际投不进去"的情况。


06

INTERFACE

界面与日志

「界面看得懂,日志说得清。」

① 标题栏与"关于"窗口的版本号更新为 V3.0;


②启用两层时,运行日志额外输出一行说明本次投放的层厚与外层尺寸。

...log

内外两层:表中直径为内层粒径,界面层单侧厚度 1.50,

     外层尺寸 = 粒径 + 3.00,按外层判碰


07

COMPATIBILITY

兼容性与注意事项

① 配置文件(JSON)结构未变,V2.0 的配置文件可直接加载,无需迁移;

② 但粒径含义已变:同一份配置在启用两层时,V3.0 生成的颗粒比 V2.0 大 2 × 两层间距,需要按第 2 节的方法换算;

③ 未启用两层时(单层),尺寸与填充率结果与 V2.0 一致,唯一差别是多边形同样受"无小边"约束,极端细边会被合并;

④ 两层间距建议明显小于粒径(一般不超过粒径的 20%~30%)。层厚过大属合法输入,但外层会显著大于内层,可投放数量随之减少;

⑤ 图层命名规则未变:第 3 行多边形仍对应 polygon_003_OUTER 与 polygon_003_INNER;

⑥ 建议每次投放使用空白图纸,避免与既有图元叠加。


08

THE END

写在最后

V3.0 把"填多少"和"画出来是多少"统一到同一套口径,并让多边形轮廓在任何层厚下都保持正确。升级后建议先用一张空白图纸试投一次,确认尺寸符合预期再用于正式建模。

【注意】插件单机许可授权,不支持更换计算机使用。购买低版本的用户可凭借购买凭证免费升级到当前版本。

欢迎 点赞 · 在看 · 转发

作者|渊鱼科技 版本更新说明 · CAD随机颗粒插件2D V3.0


END

i

下面的内容为付费内容,购买后解锁。

内容简介:CAD随机颗粒插件2D V3.0

AutoCADUM碰撞
著作权归作者所有,欢迎分享,未经许可,不得转载
首次发布时间:2026-11-17
最近编辑:32分钟前
渊鱼
硕士 渊鱼科技
获赞 478粉丝 128文章 271课程 7
点赞
收藏
作者推荐

CAD随机颗粒插件2D

1 插件能做什么CAD随机颗粒插件2D是一款运行在AutoCAD上的颗粒随机投放工具。你只需告诉它「多大区域、投放哪些粒径、各占多少比例、想要多密」,它就会在图纸上自动画出互不重叠、间距可控、分布随机的颗粒集,并按级配自动分层管理。三种颗粒形状圆形(Circle)、多边形(随机凸多边形)、正多边形(等边规则形状),可任意混合投放。级配式投放按「粒径区间+占比」逐条配置,程序按目标填充率自动反推每一档应投放的颗数。间距严格保证任意两颗粒之间、颗粒与区域边界之间,净距都不小于你设定的最小间距。内外两层可生成"颗粒本体+向内偏移的界面层"双轮廓,常用于界面过渡区(ITZ)建模。投放优化默认按大粒径优先投放,小颗粒自动填充剩余空隙,显著提高可达填充率。自动分层每一条级配独占一个CAD图层,自动命名与配色,可随时按图层单独显示、统计或删除。典型用途:混凝土/沥青细观骨料模型、土体与砂石颗粒模型、随机多孔介质、材料代表性体积单元(RVE)几何建模,以及任何需要"在矩形区域内随机摆满一堆互不重叠形状"的绘图场景。2 运行环境与文件清单项目要求操作系统Windows7/10/11(64位)CAD软件AutoCAD2020及以上版本,运行插件前请先启动AutoCAD并打开一张图纸免安装版无需额外环境,双击CAD随机颗粒插件2D.exe即可(打包版,约30MB)交付文件清单文件/目录说明CAD随机颗粒插件2D.exe插件主程序,客户直接双击运行AF_CadParticle2D.afreg许可证文件,与电脑绑定,必须与主程序放在同一目录assets/程序图标与logo资源,勿删除config_example.json配置示例,可直接「加载配置」试用注意:许可证文件AF_CadParticle2D.afreg与主程序必须位于同一个文件夹内,否则会被判定为未注册(测试模式)。3 安装与启动文件夹。把插件整个文件夹放置到本机任意位置(建议放在非系统盘,如D:\CAD插件\;路径请尽量使用英文,避免权限问题)。放好许可证。确认AF_CadParticle2D.afreg与CAD随机颗粒插件2D.exe在同一目录。先启动AutoCAD。打开AutoCAD2020及以上版本,新建或打开一张图纸(插件会画在当前活动图纸上)。启动插件。双击CAD随机颗粒插件2D.exe。确认标题栏。正常注册时标题为「CAD随机颗粒插件2DV1.0渊鱼科技」;若出现「(测试模式)」字样,请转到第4章完成注册。为什么要先开AutoCAD?插件通过接口与AutoCAD通信,AutoCAD必须处于运行状态才能连接。若AutoCAD正处于某个对话框(如"选项""打印"窗口)未关闭,连接也会失败,请先关闭这些对话框。4 注册与激活插件采用一机一码授权:许可证与电脑硬件绑定,换电脑需要重新购买。4.1 判断是否已注册已注册:窗口标题为「CAD随机颗粒插件2DV1.0渊鱼科技」,可自由使用全部参数。未注册(测试模式):标题带「(测试模式)」,点击运行时会弹出序列号窗口,且只能按内置默认参数试投放一小片区域,界面上的参数不会生效。4.2 新电脑如何获取许可证在插件菜单点击帮助→注册。弹出窗口中显示本机的序列号(形如@z53...),点击「复序列号」。把序列号发送给渊鱼。收到回传的许可证文件AF_CadParticle2D.afreg后,把它放进主程序所在文件夹,重启插件即可。小提示:插件在启动时和每次点击运行时都会自动复检许可证,放好文件后无需重装程序,重启即生效。更换电脑后硬件序列号发生变化,需要重新购买获取许可证。5 界面总览插件采用单页布局,所有参数在一个窗口内完成设置,无需切换标签页。1通用参数:区域尺寸、间距、填充率、投放优化2内外两层:双层轮廓开关与层间距3粒径比例表:已添加的级配条项列表4条项输入区:类型/粒径/边数/比例5配置与预估:保存、加载、计算预估6运行区:进度条、日志、运行按钮7菜单栏:文件(退出)、帮助(注册/联系/关于)6 全部参数详解6.1 通用参数(左栏上方)参数含义与填写要点区域宽度X投放区域的宽度(CAD图形单位)。区域左下角固定为原点(0,0),因此右上角即(宽度,高度)区域高度Y投放区域的高度。例如填500×500,则区域为(0,0)–(500,500)的矩形颗粒最小间距任意两个颗粒(按外层轮廓)之间的最小净距,同时也是颗粒与区域边界的最小净距。填0表示允许相切的可能投放优化(大粒径优先)默认勾选。勾选后按各条项「最大直径」从大到小投放,大颗粒先占位、小颗粒填缝,填充率更高;取消勾选则严格按粒径表从上到下的顺序投放目标填充率(%)所有颗粒(外层)总面积÷区域面积的目标值。程序据此反推每一档要投放多少颗。单条最长时间(秒)每一条级配最多尝试多少秒。达到时限即结束该条、继续下一条,防止目标过高时无限重试。颗粒多、区域大时建议适当调大6.2 内外两层(左栏下方)参数含义与填写要点启用内外两层(界面层)勾选后每个颗粒生成两个同心轮廓:外层用于投放与碰撞检测,内层由外层向内偏移「两层间距」得到,常用于界面过渡区(ITZ)建模两层间距内层相对外层的偏移量(图形单位)。必须为正数;若大于颗粒半径,内层会出现绘图错误(建议该参数设置远小于颗粒粒径)说明:不启用两层时,每个颗粒只画外层一个轮廓,图层也只有*_OUTER。6.3 粒径比例表(右栏)右栏表格的每一行代表一档级配,也是CAD中的一个独立图层。列含义如下:列说明序号行号,删除行后自动重排类型圆形/多边形/正多边形最小直径/最大直径该档颗粒的粒径范围,程序在此区间内随机取值。须满足0<最小≤最大边数仅多边形与正多边形需要,范围3~1024(边数过多会导致计算速度下降);选圆形时输入框自动禁用比例%该档颗粒在总面积中的占比(不是颗数占比)。各档比例按相对值归一化,不必凑成1006.4 三种类型的区别类型形状特征适用场景图层前缀圆形标准圆,只需粒径简化骨料、圆形颗粒circle多边形顶点共外接圆,圆心角带约束随机取样,形状随机、保证凸性,接近真实碎石骨料混凝土/沥青骨料细观模型polygon正多边形顶点均匀分布、各边等长,仅整体旋转角随机,形状规整规则晶体、标准化颗粒regular7 快速上手:7步完成第一次投放下面用一套完整示例带你走一遍:在200×200的方形区域内,投放两档圆形+一档多边形+一档正五边形,目标填充率30%,启用内外两层。准备图纸。打开AutoCAD,新建一张空白图纸(插件会画在当前图纸上,建议用空图,避免与已有图元混在一起)。启动插件:双击CAD随机颗粒插件2D.exe,确认标题栏没有「(测试模式)」。填通用参数(左栏):区域宽度X=200,区域高度Y=200,颗粒最小间距=2,目标填充率=30,单条最长时间=30(秒),保持「投放优化」勾选。启用两层(左栏下方):勾选「启用内外两层(界面层)」,两层间距填1.5。添加粒径比例(右栏):在右上方输入区依次填写并点「<<添加」:①类型=圆形,最小5,最大10,比例10②类型=圆形,最小10,最大18,比例10③类型=多边形,边数6,最小8,最大15,比例20④类型=正多边形,边数5,最小10,最大18,比例20(可选)点「计算预估」,界面会显示「预估合计约N颗」。若提示「目标偏高可能超时」,说明填充率设得太高,可适当下调。点击右下角「运 行」:按钮变为「运行中...」,进度条与日志实时刷新;完成后弹出提示框显示颗数与实际填充率,AutoCAD自动缩放显示全部颗粒。请在AutoCAD中查看结果。快捷方式:直接点「加载配置」,选择交付包里的config_example.json,即可一次性载入一套示例参数(区域500×500、填充率40%),再按需修改。8 结果解读:日志、图层与填充率8.1 运行日志逐行说明========================================================开始投放:区域200×200(左下角0,0),投放优化:开(大粒径优先),目标填充率30%,最小间距2.00生成完成:312颗,实际填充率28.7%(目标30%)条项1(投放次序3):投放60/60颗,耗时0.8s条项2(投放次序1):投放45/45颗,耗时0.6s条项3(投放次序2):投放118/118颗,耗时3.2s正在连接AutoCAD并绘制...绘制完成:624个实体已写入当前文档(另含0图层区域外轮廓)条项N:粒径表中的第N行(图层编号按此顺序);投放次序M:实际投放的先后(开启优化时二者通常不同)。投放60/60颗:目标60颗、实际成功60颗。若前者大于后者并出现「(超时终止)」,说明该档在设定时间内没能放够——通常是填充率目标过高或粒径太大放不下,可降低目标填充率或增大「单条最长时间」。绘制完成:N个实体:启用两层时约为颗数的2倍(部分颗粒内层退化时略少),另加1条0图层区域外轮廓。8.2 图层命名规则每一档级配在CAD中独占一个图层,内外两层再各自分开,命名格式为:图层名含义circle_001_OUTER/circle_001_INNER第1档圆形的外层/内层circle_002_OUTER第2档圆形的外层polygon_003_OUTER第3档多边形的外层regular_004_OUTER第4档正多边形的外层0区域矩形外轮廓(每次投放都会画一条,便于核对范围)实用技巧:在AutoCAD图层管理器中,可以单独关闭/冻结某一档图层来做统计或分层出图;同一档的内外两层颜色相同,颜色按档位序号循环分配。8.3 实际填充率为什么低于目标?随机顺序投放存在天然的堆积极限:二维随机圆形/凸多边形的实际可达填充率通常在50%~55%左右。因此:目标≤45%:一般都能完成,实际值接近目标;目标45%~55%:部分档位可能超时终止,实际值略低于目标;目标>55%:大量重试,耗时长且难以达到,不建议。最终实际填充率会在日志和完成弹窗中如实显示,请以此为准。9 配置的保存与加载保存配置:设置好参数后点「保存配置」,存为.json文件,下次直接加载即可复现同一套级配。加载配置:点「加载配置」选择JSON文件,界面参数与粒径表会一次性回填。配置文件是纯文本,可用记事本编辑(注意保持JSON格式与英文标点)。{"region":{"xmin":0,"ymin":0,"xmax":500,"ymax":500},"min_gap":2.0,"optimize_order":true,"target_fill_ratio":0.40,"per_band_time_limit_sec":30,"two_layer":{"enabled":true,"layer_gap":1.5},"circle_bands":[{"dmin":5,"dmax":10,"ratio":10},{"dmin":10,"dmax":18,"ratio":10}],"polygon_bands":[{"sides":6,"dmin":8,"dmax":15,"ratio":20}],"regular_bands":[{"sides":5,"dmin":10,"dmax":18,"ratio":20}]}字段说明:region记录左下角与右上角坐标(界面只输入宽高,左下角固定0,0);target_fill_ratio为小数(0.40即40%);三种类型分别放在circle_bands、polygon_bands、regular_bands。10 参数经验值与调优技巧目标建议做法想要更高的填充率开启「投放优化」;增大小粒径档位的比例(小颗粒更容易填空隙);把目标控制在40%~45%以内颗粒之间太挤/太松调整「颗粒最小间距」。经验值:取最小粒径的10%~20%(如粒径5~10,间距取0.5~2)内层轮廓出现残缺说明「两层间距」相对颗粒太大导致内层退化。把层间距调小(建议<最小粒径的一半)投放太慢/老是超时降低目标填充率;把「单条最长时间」提高;减少总颗粒数(增大粒径或缩小区域)想要颗粒更大更稀疏提高粒径区间、降低目标填充率;或增大区域尺寸保持粒径不变结果要可复现保存配置文件即可复现参数;颗粒位置本身是随机的,每次运行结果不同关于耗时:颗粒是逐个通过AutoCAD接口绘制的,数百颗约需数十秒,数千颗可能需要几分钟,属正常现象。绘制期间请不要在AutoCAD中执行其他命令,否则可能出现"被呼叫方拒绝接收呼叫"的等待(也可能报错)。11 常见问题与解决办法现象原因与处理提示「无法连接AutoCAD」①AutoCAD未启动,请先打开;②正停留在某个对话框,关闭后重试;③版本低于2020或非AutoCAD平台(如纯CAD看图软件)标题显示「(测试模式)」未注册:许可证文件缺失或与本机不匹配。确认AF_CadParticle2D.afreg与CAD随机颗粒插件2D.exe同目录,若仍不行请按第4章重新获取点了运行没反应/报参数错误会弹出提示框说明原因,常见为:未添加任何粒径条项、粒径范围填反、边数不在3~1024、填充率超过95%、启用两层但层间距为0实际填充率远低于目标、日志出现「超时终止」目标填充率过高或粒径相对区域过大。降低目标填充率、增大「单条最长时间」,或增加小粒径档位只投放了很少的颗粒检查「粒径范围」是否大于区域尺寸;检查「最小间距」是否过大(间距越大越难放下)部分颗粒没有内层轮廓正常现象:内层内缩后退化(半径≤0或形状异常)会自动跳过,只画外层同一张图上重复运行后颗粒叠加程序不会自动清理已有图元。建议每次新建空白图纸再运行;如需清理,可删除对应图层找不到投放区域边界区域外轮廓画在0图层,请确认0图层未被关闭或冻结;完成绘制后程序会自动展示图形区域杀毒软件报毒/exe被隔离打包程序偶有误报,请将文件夹加入白名单后重试界面配色与手册截图不同界面主题会随环境略有差异,不影响功能与参数版权©2026-2076渊鱼科技AbyssFishTech | CAD随机颗粒插件2DV1.0使用手册本软件为商业授权软件,未经授权不得拷贝、分发或用于二次开发。

有附件
未登录
还没有评论
课程
培训
服务
行家
VIP会员 学习计划 福利任务
下载APP
联系我们
帮助与反馈