3DSEE?(3D SEmantic Engine)是基于 AI 技術(shù)的 3D 模型語(yǔ)義搜索引擎,可以自動(dòng)提取 3D 模型內(nèi)涵的語(yǔ)義信息并存儲(chǔ)入庫(kù),以幫助用戶使用自然語(yǔ)言或關(guān)鍵字高效地檢索 3D 模型。3DSEE 提供完善的二次開(kāi)發(fā) API,無(wú)論使用Java、Python、PHP、JavaScript還是C#,都可以在自己的應(yīng)用中集成 3D 模型的語(yǔ)義提取、入庫(kù)和自然語(yǔ)言檢索能力。
3DSEE官方下載地址:3D模型語(yǔ)義搜索引擎?。
3DSEE 的主要功能包括:
-
語(yǔ)義提取
:3DSEE 能夠自動(dòng)分析和理解 3D 模型內(nèi)涵的語(yǔ)義信息,這使得用戶無(wú)需手動(dòng)添加標(biāo)簽或元數(shù)據(jù),即可實(shí)現(xiàn)對(duì)模型內(nèi)涵的全面理解。 -
數(shù)據(jù)入庫(kù)
:3DSEE 將提取的語(yǔ)義信息和相關(guān)元數(shù)據(jù)統(tǒng)一存儲(chǔ)在數(shù)據(jù)庫(kù)中,以便快速、高效地進(jìn)行檢索。這為用戶提供了一個(gè)集中管理和組織 3D 模型的平臺(tái),簡(jiǎn)化了數(shù)據(jù)管理的復(fù)雜性。 -
自然語(yǔ)言檢索
:用戶可以通過(guò)自然語(yǔ)言或關(guān)鍵字對(duì) 3D 模型進(jìn)行檢索。3DSEE 利用先進(jìn)的自然語(yǔ)言處理技術(shù),使用戶能夠用簡(jiǎn)單的語(yǔ)言描述來(lái)獲取所需的 3D 模型,提高了檢索的便捷性。
1、文件和目錄組織
3DSEE 通過(guò)理解用戶輸入的語(yǔ)義信息,為其提供高效、準(zhǔn)確的模型檢索體驗(yàn)。當(dāng)前版本 V1.0,主要文件及目錄組織結(jié)構(gòu)如下:
開(kāi)發(fā)包文件 | 說(shuō)明 |
---|---|
src/ | 執(zhí)行文件目錄 |
src/models/ | AI模型目錄 |
src/attempt.pyc | 執(zhí)行方法文件 |
src/db.pyc | 數(shù)據(jù)管理文件 |
src/main.pyc | 引擎入口文件 |
src/modules.pyc | 模型調(diào)用文件 |
src/preview.pyc | 預(yù)覽圖生成文件 |
src/config.json | 配置文件 |
src/requirements.txt | 需要安裝的依賴 |
installation.md | pytorch3D 安裝指南 |
LICENSE.md | 開(kāi)發(fā)包許可協(xié)議文件 |
2、環(huán)境安裝和部署
首先參考 installation.md 安裝基本運(yùn)行環(huán)境。
2.1 安裝依賴包
在 src 目錄下打開(kāi) cmd,執(zhí)行以下命令安裝依賴包
pip install requirements.txt -r
2.2 修改配置文件
在 config.json 中修改配置
{
"port": 3005, //服務(wù)端口號(hào)
"host": "127.0.0.1", //服務(wù)地址
"dbconfig": {
"name": "default", //數(shù)據(jù)庫(kù)名
"host": "192.168.1.139", //數(shù)據(jù)庫(kù)地址
"port": 19530, //數(shù)據(jù)庫(kù)端口
"collection": "my_models", //集合名,首次啟動(dòng)會(huì)自動(dòng)創(chuàng)建集合
"load_timeout": 30 //加載集合時(shí)限
}
}
2.3 啟動(dòng)服務(wù)
在 src 目錄下打開(kāi) cmd,執(zhí)行以下命令運(yùn)行服務(wù)
python -m main
啟動(dòng)服務(wù)后,可以訪問(wèn)?http://127.0.0.1:3005/docs
查看 api 文檔(實(shí)際端口和 ip 請(qǐng)以配置文件為準(zhǔn))
3、示例程序使用方法
3DSEE 啟動(dòng)后,在example目錄下運(yùn)行以下命令啟動(dòng)示例程序:
npm install
npm run dev
示例程序提供了模型檢索和入庫(kù)功能。
3.1 關(guān)鍵字查詢
輸入關(guān)鍵字,點(diǎn)擊搜索按鈕開(kāi)始查詢,返回查詢結(jié)果。例如,輸入關(guān)鍵詞car
?查詢結(jié)果如下:
3.2 模型入庫(kù)
填寫(xiě)表單,點(diǎn)擊提交將模型添加到模型庫(kù)中。
4、API 使用說(shuō)明
當(dāng)前文檔版本號(hào)為 v1.0,更新日期為 2023/11/29。
服務(wù)包中提供 2 個(gè)訪問(wèn)接口,列表如下。
接口名稱 | 訪問(wèn) url | 請(qǐng)求 |
---|---|---|
查詢模型 | / | GET |
添加模型 | / | POST |
4.1 模型查詢 API
通用調(diào)用[查詢模型]接口,可以通過(guò)中文或英文關(guān)鍵詞,查詢到與其語(yǔ)義相關(guān)的模型。接口詳細(xì)描述如下:
訪問(wèn) URL:?GET /
請(qǐng)求參數(shù):查詢參數(shù)的主要字段說(shuō)明如下:
-
keyword
: ?必填,關(guān)鍵詞, 如:car -
page
: ?查詢頁(yè)數(shù),默認(rèn)值:1 -
limit
: ?每頁(yè)返回?cái)?shù)量,默認(rèn)值:10 -
radius
: ?最小相似度閾值,數(shù)值越大則語(yǔ)義相似度匹配范圍越大,默認(rèn)值:1,
請(qǐng)求示例如下(使用?curl
):
curl http://127.0.0.1:3005/?keyword=car&page=1&limit=10&radius=3
響應(yīng)結(jié)果:JSON 對(duì)象,主要字段說(shuō)明如下:
-
id
: ? 唯一 id -
distance
: ?確定最小相似度閾值,類型:number -
entity
: ?json 對(duì)象,主要字段如下: -
data
: ?3D模型自定義數(shù)據(jù),JSON字符串 -
preview
: ? 模型預(yù)覽圖url,字符串 -
path
: ?3D模型訪問(wèn)路徑,字符串
響應(yīng)結(jié)果示例如下:
[
{
id: 445859173072122400,
distance: 1.2356822490692139,
entity: {
data: '{"name": "r2"}',
path: "D:/preview/models/r2.off",
preview: "http://127.0.0.1:3005/preview/81ac5d31-c11e-45e2-aa94-c39eddf3f459.png",
},
},
{
id: 445946831156557600,
distance: 0.7618597269058228,
entity: {
data: '{"name": "car"}',
path: "http://127.0.0.1:3005/preview/67d8abcf-176c-441c-abb5-3712750bd33c.png",
},
},
];
4.2 模型添加 API
通用調(diào)用[添加模型]接口,可以向庫(kù)中添加模型。接口詳細(xì)描述如下:
訪問(wèn) URL:?POST /
請(qǐng)求參數(shù):JSON 對(duì)象,主要字段說(shuō)明如下:
-
data
: json 對(duì)象,自定義數(shù)據(jù) -
path
: 字符串,模型本地路徑,務(wù)必確??梢栽L問(wèn), -
modelType
: 字符串,要添加的模型類型,當(dāng)前支持:'obj', 'off', ply', 'glb'
請(qǐng)求示例如下(使用curl):
curl -X POST -D '{"data": {}, "path": "./model.obj", "modelType": "obj"}' http://127.0.0.1:3005/
響應(yīng)結(jié)果:返回字符串,表示操作結(jié)果信息,例如:文章來(lái)源:http://www.zghlxwxcb.cn/news/detail-779003.html
"保存成功"
原文鏈接:3D模型語(yǔ)義搜索引擎 - BimAnt文章來(lái)源地址http://www.zghlxwxcb.cn/news/detail-779003.html
到了這里,關(guān)于3DSEE:AI驅(qū)動(dòng)的3D模型語(yǔ)義搜索引擎的文章就介紹完了。如果您還想了解更多內(nèi)容,請(qǐng)?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持TOY模板網(wǎng)!