Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chuongmep/aps-toolkit
An Libray Unlock BIM Data With Autodesk Platform Services
https://github.com/chuongmep/aps-toolkit
acc ai aps aps-toolkit autodesk-docs autodesk-forge automation bim bim360 data data-analyst data-science database forge llm
Last synced: about 1 month ago
JSON representation
An Libray Unlock BIM Data With Autodesk Platform Services
- Host: GitHub
- URL: https://github.com/chuongmep/aps-toolkit
- Owner: chuongmep
- License: gpl-3.0
- Created: 2024-02-26T11:52:22.000Z (10 months ago)
- Default Branch: dev
- Last Pushed: 2024-05-19T15:36:17.000Z (7 months ago)
- Last Synced: 2024-05-19T16:45:41.640Z (7 months ago)
- Topics: acc, ai, aps, aps-toolkit, autodesk-docs, autodesk-forge, automation, bim, bim360, data, data-analyst, data-science, database, forge, llm
- Language: Jupyter Notebook
- Homepage:
- Size: 59.7 MB
- Stars: 39
- Watchers: 3
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: Readme.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
 [](https://opensource.org/licenses/MIT)
   
[](../../actions)
[](https://www.nuget.org/packages/APSToolkit)
[](https://www.nuget.org/packages/APSToolkit/)
## 🔩 APS Toolkit
APS Toolkit (Former is Forge) is powerful tool for developer,software enginner, AI engineer to explore `Autodesk Platform Services`(APS). It's built on top of [Autodesk.Forge](https://www.nuget.org/packages/Autodesk.Forge/) and [Newtonsoft.Json](https://www.nuget.org/packages/Newtonsoft.Json/). Forge Toolkit includes some features allow you to read, download and write data from `Autodesk Platform Services` and export to CSV, Excel, JSON, XML, etc.
## ⚡ Features
- [x] Read/Download SVF Model
- [x] Read/Query Properties Database SQLite
- [x] Read/Download Properties Without Viewer
- [x] Read Geometry Data
- [x] Read Metadata
- [x] Read Fragments
- [x] Read MeshPacks
- [x] Read Images
- [x] Export Data to CSV
- [x] Export Data to Excel
- [x] Export Data to Parquet
## ⚙ Installation
### .NET
Please follow latest update at [APSToolkit Nuget](https://www.nuget.org/packages/APSToolkit)
```bash
```
### Python
Please follow latest update at [APSToolkit Python](https://pypi.org/project/aps-toolkit/)
```bash
pip install aps-toolkit --upgrade
```
Before start you need setup your environment:
```bash
APS_CLIENT_ID =
APS_CLIENT_SECRET =
```
Advanced setup for APS Toolkit environment:
```bash
APS_REFRESH_TOKEN =
APS_ACCESS_TOKEN =
APS_CLIENT_PKCE_ID =
```
## ⭐ Getting Started
I want export Revit Data To Excel 👇
### .NET
```csharp
using APSToolkit;
using Autodesk.Forge;
using APSToolkit.Database;
using APSToolkit.Auth;
var token = Authentication.Get2LeggedToken().Result;
string urn = "";
var RevitPropDbReader = new PropDbReaderRevit(urn, token);
RevitPropDbReader.ExportAllDataToExcel("result.xlsx");
```
### Python
```python
from aps_toolkit import Auth
from aps_toolkit import PropDbReaderRevit
auth = Auth()
token = auth.auth2leg()
urn = ""
prop_reader = PropDbReaderRevit(urn, token)
df = prop_reader.get_data_by_category("Ducts")
df.save_to_excel("result.xlsx")
```
## 📚 Tutorials
### .NET
All Tutorials are available under Jupyter Notebook at [.NET Tutorials](./docs/Tutorials)
- [00. Jupyter Notebook And .NET Interactive](./docs/Tutorials/00.%20Jupyter%20Notebook%20And%20.NET%20Interactive.ipynb)
- [01. Setup And Authentication](./docs/Tutorials/01.%20Setup%20And%20Authentication.ipynb)
- [02. Explore Hubs - Projects - Items - URN](./docs/Tutorials/02.%20Explore%20Hubs%20-%20Projects%20-%20Items%20-%20URN.ipynb)
- [03. Explore Versions Item and Derivative Urn](./docs/Tutorials/03.%20Explore%20Versions%20Item%20and%20Derivative%20Urn.ipynb)
- [04. Explore General Metdadata With APSToolkit](./docs/Tutorials/04.%20Explore%20General%20Metdadata%20With%20APSToolkit.ipynb)
- [04.01. Explore Revit Data With APSToolkit](./docs/Tutorials/04.01.%20Explore%20Revit%20Data%20With%20APSToolkit.ipynb)
- [05. Explore Access APS Database And Execute Query](./docs/Tutorials/05.%20Explore%20Access%20Database%20And%20Query%20Items.ipynb)
- [06. Explore SVF Format - Export SVF Viewer](./docs/Tutorials/06.%20Explore%20SVF%20-%20Export%20SVF%20Viewer.ipynb)
- [07. Explore Update Revit Data Back To ACC](./docs/Tutorials/07.%20Explore%20Update%20Revit%20Data%20Back%20To%20ACC.ipynb)
- [08. Explore Pull Data From ACC BIM360 API](./docs/Tutorials/08.%20Explore%20Pull%20Data%20From%20ACC%20BIM360%20API.ipynb)
- [09. Explore Data Knowledge Use LLM Agent](./docs/Tutorials/09.%20Explore%20Data%20Knowledge%20Use%20LLM%20Agent.ipynb)
- [10. Build Pipeline Data Process with APSToolkit](./docs/Tutorials/10.%20Build%20Pipeline%20Data%20Process%20with%20APSToolkit.ipynb)
- [11. Visualization Data - Data Analyst](./docs/Tutorials/11.%20Visualization%20Data%20-%20Data%20Analyst.ipynb)
- [12. Custom Python In .NET Interactive](./docs/Tutorials/12.%20Custom%20Python%20In%20.NET%20Interactive.ipynb)
- [13. Custom Metadata Export](./docs/Tutorials/13.%20Custom%20Metadata%20Export.ipynb)
### Python
All Tutorials are available under Jupyter Notebook at [Python Tutorials](./APSToolkitPython/Tutorials)
- [00. Jupyter Notebook And Python](./APSToolkitPython/Tutorials/00.%20Jupyter%20Notebook%20And%20Python.ipynb)
- [00.01. Jupyter Notebook And Google Colab](./APSToolkitPython/Tutorials/00.01.%20Jupyter%20Notebook%20And%20Google%20Colab.ipynb)
- [01. Setup And Authentication](./APSToolkitPython/Tutorials/01.%20Setup%20And%20Authentication.ipynb)
- [02. Explore Hubs - Projects - Items - URN](./APSToolkitPython/Tutorials/02.%20Explore%20Hubs%20-%20Projects%20-%20Items%20-%20URN.ipynb)
- [03. Explore Versions Item and Derivative Urn](./APSToolkitPython/Tutorials/03.%20Explore%20Versions%20Item%20and%20Derivative%20Urn.ipynb)
- [04. Explore General Metdadata With APSToolkit](./APSToolkitPython/Tutorials/04.%20Explore%20General%20Metdadata%20With%20APSToolkit.ipynb)
- [04.01. Explore Revit Data With APSToolkit](./APSToolkitPython/Tutorials/04.01.%20Explore%20Revit%20Data%20With%20APSToolkit.ipynb)
- [04.02. Explore Compare Revit Data Versions](./APSToolkitPython/Tutorials/04.02.%20Explore%20Compare%20Revit%20Data%20Versions.ipynb)
- [04.03. Explore Acad Data With APSToolkit](./APSToolkitPython/Tutorials/04.03.%20Explore%20Acad%20Data%20With%20APSToolkit.ipynb)
- [04.04. Explore Navisworks Data With APSToolkit](./APSToolkitPython/Tutorials/04.04.%20Explore%20Navisworks%20Data%20With%20APSToolkit.ipynb)
- [05. Explore Access Database And Query Items](./APSToolkitPython/Tutorials/05.%20Explore%20Access%20Database%20And%20Query%20Items.ipynb)
- [06. Data Visualization - Analyst BIM Model](./APSToolkitPython/Tutorials/06.%20Data%20Visualization%20-%20Analyst%20BIM%20Model.ipynb)
- [07. Explore Big Data Format Storage](./APSToolkitPython/Tutorials/07.%20Explore%20Big%20Data%20Format%20Storage.ipynb)
- [08. Explore URL ACC Extract](./APSToolkitPython/Tutorials/08.%20Explore%20URL%20ACC%20Extract.ipynb)
- [09. Explore SVF - Export SVF Viewer](./APSToolkitPython/Tutorials/09.%20Explore%20SVF%20-%20Export%20SVF%20Viewer.ipynb)
## License
Many source codes here are collected from open-source authors under the MIT License. Without their sharing and contributions, I wouldn't be able to do this. I am deeply grateful to them, and therefore, I hope that if you are using this tool, please thank them before thanking me and follow their licenses.
This project is licensed under the terms of the [gnu-gpl-v3.0](License). Some part of the project base on the licese follow the original project :
- [forge-convert-utils](https://github.com/petrbroz/forge-convert-utils)
- [UnityForgeImporter](https://github.com/chuongmep/UnityForgeImporter)
- [forge-bucketsmanager-desktop](https://github.com/Autodesk-Forge/forge-bucketsmanager-desktop)
- [ChoETL](https://github.com/Cinchoo/ChoETL)
## Dependencies
- [Autodesk.Forge](https://www.nuget.org/packages/Autodesk.Forge/) - The .NET SDK for Autodesk Forge.
- [Newtonsoft.Json](https://www.nuget.org/packages/Newtonsoft.Json/) - Json.NET is a popular high-performance JSON framework for .NET.
- [CsvHelper](https://www.nuget.org/packages/CsvHelper/) - Library to help reading and writing CSV files.
- [EPPlus](https://www.nuget.org/packages/EPPlus/) - EPPlus is a .NET library that reads and writes Excel files using the Office Open XML format (xlsx).
- [ChoETL](https://github.com/Cinchoo/ChoETL) - Cinchoo ETL is a code-based ETL framework for extracting data from multiple sources, transforming, and loading into your very own data warehouse in .NET environment. You can have data in your data warehouse in no time.
- [SharpZipLib](https://github.com/icsharpcode/SharpZipLib) - SharpZipLib (#ziplib, formerly NZipLib) is a compression library for Zip, GZip, BZip2.
- [Pandas](https://pandas.pydata.org/) - Pandas is a fast, powerful, flexible and easy to use open source data analysis and data manipulation library built on top of the Python programming language.
- [Nuke](https://github.com/nuke-build/nuke) - Nuke is a cross-platform build automation system with C# DSL for tasks such as compiling code, copying files and folders, running unit tests, compressing files and building NuGet packages.
## 👨🏫 Contributing
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
## 🎁 Sponsors
Thanks [JetBrains](https://www.jetbrains.com/) for providing a free All product IDE for this project.
---
## Disclaimer
This is not an official Autodesk product to support for Autodesk Platform Services. Use it at your own risk.
I'm not responsible for any data loss or any other issues caused by using this library, some features need require cost for using. Please read carefully the [Autodesk Forge](https://forge.autodesk.com/) and [Autodesk Platform Services](https://aps.autodesk.com/) terms of use. I'm just doing, testing , maintaining in free time, so feel free to contribute and make it better.
Update : There is a new, official [Node.js/TypeScript SDK](https://github.com/autodesk-platform-services/aps-sdk-node) that's currently in beta but will be stabilized soon. That SDK will offer various benefits over forge-server-utils, for example, it will be easier to maintain and extend in the future as it's being auto-generated from OpenAPI specs. As soon as it's ready to use (which should be really soon), I would archive this project and point to the official SDK instead.