top of page
WhatsApp Image 2026-10-07 at 11.40.37 PM.jpeg

ASHRAE 표준 183 부하 계산

Helix Energy Partners가 제공하는 이 YouTube 튜토리얼 시리즈는 복잡한 맞춤형 Ruby/Python Measure(측정 스크립트) 작성, OpenStudio MCP와의 연동, 그리고 오픈소스 OpenStudio 소프트웨어에 대한 기여 등 OpenStudio의 고급 방법론을 다룹니다. 이 시리즈는 OpenStudio의 기초를 숙달하고 상세한 시스템 설계, 장비 특성 정의, 프로그래밍을 통한 모델 조작 등을 수행할 준비가 된 엔지니어를 대상으로 합니다. 또한, 'Building Component Library(BCL)'에 자동화 전략을 기여함으로써 대학 수준의 연구 프로젝트나 학위 논문 연구를 시작하는 계기로도 활용될 수 있습니다.

ASHRAE 표준 183 SketchUp/OpenStudio를 이용한 건물 하중 계산
2019년 10월 8일

저희를 알아보세요

이 YouTube 영상에서는 SketchUp과 OpenStudio 플러그인을 사용하여 건물 형상을 생성하는 데 필요한 단계를 설명합니다. 그런 다음 OpenStudio를 통해 미국 에너지부의 EnergyPlus 시뮬레이션 엔진을 사용하여 ASHRAE 표준 183에 따라 건물의 냉난방 부하를 계산합니다.
이러한 계산에 사용된 모든 소프트웨어(SketchUp, OpenStudio 및 EnergyPlus)는 오픈 소스이며 무료로 다운로드할 수 있습니다.

오픈 스튜디오 모델링 단계:

1. 마법사를 사용하여 새 오픈스튜디오 모델(OSM)을 생성합니다.

2. 창 → 환경설정 → 일반
   자동 저장 간격을 원하는 값으로 설정합니다.

3. 확장 기능 → 오픈스튜디오 → 환경설정
   단위 체계를 IP 단위계로 설정합니다.

4. 창 → 모델 정보 → 위치 정보
   프로젝트 위치를 추가합니다.

5. 창 → 환경설정 → 오픈지엘(OpenGL)
   “최대 텍스처 크기 사용”을 선택합니다.
   (모델 속도가 느려질 경우 나중에 선택을 해제할 수 있습니다.)

6. 확장 기능 → 오픈스튜디오 사용자 스크립트 → 템플릿 생성기 →
   공간 유형 및 구성 세트 마법사.
   - 필요에 따라 추가 공간 유형을 생성합니다.
   - “구성 세트 생성” 선택을 해제합니다.
   - “건물 기본값 설정” 선택을 해제합니다.

7. 건물의 정확한 실제 치수에 맞는 기준 축척 선을 그립니다.

8. 파일 → 가져오기
   프로젝트 대지 배치도 또는 평면도를 가져옵니다.
   모델에 배치한 후 기준 축척 선을 사용하여 크기를 조정합니다.
   아직 모델을 진북 방향으로 회전하지 마십시오.

9. 스케치업 그리기 도구를 사용하여 평면도 위에 건물 형상을 따라 그립니다.
   평면도 이미지를 선택 → 마우스 오른쪽 클릭 → 필요 시 숨기기/숨김 해제.
   (선택 사항: 창 → 환경설정 → 바로 가기에서 키보드 단축키를 사용자 지정할 수 있습니다.)

10. 평면도 따라 그리기가 완료되면 모든 선 요소를 선택한 후
    “도면에서 공간 생성” 버튼을 클릭합니다.

11. 개별 공간을 두 번 클릭하여:
    - 공간 높이 수정
    - 플레넘 또는 추가 요소 생성
    - 창문 및 문 삽입

12. 확장 기능 → 오픈스튜디오 사용자 스크립트 → 모델 요소 변경 또는 추가 →
    공간 형상 교차를 실행합니다.

13. 표면 일치 버튼 클릭 → 전체 모델 일치를 선택합니다.

14. 하나의 공간을 선택하고 “선택한 공간에 속성 설정”을 클릭합니다.
    모든 공간에 공간 유형을 지정합니다.
    필요 시 오픈스튜디오 검사기를 열어 공간 이름을 원하는 대로 변경합니다.

15. 확장 기능 → 오픈스튜디오 사용자 스크립트 → 모델 요소 변경 또는 추가 →
    열 구역이 없는 공간에 새 열 구역 추가를 실행합니다.

16. 각 공간을 하나씩 선택하여 프로젝트 평면도에 맞게 이름을 변경합니다.

17. 확장 기능 → 오픈스튜디오 사용자 스크립트 → 모델 요소 변경 또는 추가 →
    공간 이름을 기준으로 열 구역 이름 변경을 실행합니다.

18. 유형별로 공간을 그룹 선택합니다.
    “선택한 공간에 속성 설정”을 클릭하여 다음을 지정합니다:
    - 공간 유형
    - 온도 조절기 유형
    (이 단계에서 여러 공간을 하나의 열 구역으로 통합할 수도 있습니다.)

19. 확장 기능 → 오픈스튜디오 사용자 스크립트 → 모델 요소 변경 또는 추가 →
    사용되지 않는 열 구역 제거를 실행합니다.

20. 특정 창 선택 → 확장 기능 → 오픈스튜디오 사용자 스크립트 → 모델 요소 변경 또는 추가 →
    돌출 비율 기준 차양 추가를 실행합니다.

21. 수직 또는 사용자 지정 차양을 만들려면
    “새 차양 표면 그룹” 버튼을 클릭합니다.

22. 모델을 진북 방향에 맞게 회전합니다.

23. 위치 정보가 사라진 경우 기준 방향 유지를 위해 다시 입력합니다.

24. 인접 차양(건물, 나무 등) 생성:
    - “새 차양 표면 그룹” 클릭
    - 위치 정보 이미지를 참조
    - 필요 시 차양 표면 편집 전에 위치 정보 이미지를 먼저 따라 그리기

25. 창 → 기본 트레이 → 그림자
    그림자를 검토하고 시뮬레이션합니다.
    계산 시간을 줄이기 위해 불필요한 차양 표면을 삭제합니다.

26. 오픈스튜디오 검사기 열기 → 오픈스튜디오 리소스에서 사용되지 않는 객체 정리 실행.
    “OS:건물”을 선택하고 프로젝트 이름을 입력합니다.

27. “오픈스튜디오 실행” 버튼을 클릭합니다.

28. 환경설정 → 단위
    단위를 영어식(IP) 단위로 설정합니다.

29. 적절한 기상 파일과 설계일 파일을 선택합니다.

30. 일정 탭 → 일정
    배기 팬용 켜기/끄기 일정을 생성하고 할당합니다.

31. 열 구역 탭 → 공조 시스템
    모든 구역에 온도 조절기 일정이 적용되었는지 확인합니다.
    해당 구역에 배기 팬을 추가합니다.

32. 열 구역 탭 → 냉방 용량 산정 매개변수
    - 구역 냉방 공급 공기 온도를 55°F로 설정
    - 필요 시 공기 분배 효율 조정

33. 난방 용량 산정 매개변수에 대해서도 32단계를 반복합니다.

34. 조치 탭 → 보고
    “BCL 오픈스튜디오 결과” 조치를 보고 조치 영역으로 끌어옵니다.

35. 시뮬레이션을 실행합니다.

36. 모델 디렉터리로 이동합니다.
    생성된 HTML 결과 파일을 웹 브라우저에서 엽니다.
    기록 및 참고용으로 인쇄하거나 PDF로 저장합니다.

IP 단위 에너지플러스 결과

37. 조치 탭 → “BCL에서 조치 찾기” 클릭.

38. “IP 단위”를 검색합니다.

39. “출력 표를 IP 단위로 설정” 조치를 다운로드합니다.

40. BCL 창을 닫습니다.

41. 다운로드한 조치를 에너지플러스 조치 섹션으로 끌어옵니다.

42. IP 단위 결과를 확인하기 위해 시뮬레이션을 다시 실행합니다.

2. Set up GitHub – Creates a GitHub account, configures Git identity and line endings, and installs the GitHub CLI (gh) so you can fork repos and open pull requests from the terminal.   3. Fork the OpenStudioApplication repository – Uses Claude Code and the gh CLI to fork openstudiocoalition/OpenStudioApplication and clone it locally, then creates a CLAUDE.md file so Claude has persistent project context (build command, clang-format version requirements, and known local test failures).   4. Build OpenStudio locally on Windows – Installs the native build toolchain (CMake, Visual Studio Build Tools, Python, Ruby, Conan, Qt), works around a known NREL Conan server SSL issue with a local Ruby package, configures with CMake, and compiles OpenStudioApp.exe. Also covers a Docker/WSL-based alternative build path for anyone who prefers a containerized environment. Timestamps: 0:00 Introduction 4:00 Part 1: Install Claude Code (AI CLI) 5:00 - Install Node.js 5:45 - Install Claude Code 6:40 - Add Claude Code to your PATH 8:10 - Install Git for Windows 9:50 - Authenticate 13:50 Part 2: Set Up GitHub 14:00 - Create a GitHub account 14:40 - Configure Git identity and line endings 20:50 - Install the GitHub CLI 23:30 Part 3: Fork the OpenStudioApplication Repository 23:45 - Fork with AI assistance 32:05 - Create a CLAUDE.md file 33:35 Part 4: Build OpenStudio Locally on Windows 34:11 - Install prerequisites 36:05 - Install Qt 36:30 - Set up Conan 38:05 - Create a local Ruby package for Conan 38:30 - Edit the project's conanfile.py 39:00 - Run Conan install 41:10 - Configure with CMake 43:00 - Build 44:45 - Launch and test

OpenStudio를 이용한 모델링 및 시뮬레이션 단계별 과정

이 섹션에서는 SketchUp과 OpenStudio를 사용하여 건물 하중 계산을 수행하는 전체 워크플로를 설명합니다.

Today we are going to be talking about MCP servers, and specifically the MCP server that was created by the National Laboratory of the Rockies to be used with the OpenStudio application. We will search for it here. It is on GitHub and it is NREL's OpenStudio MCP. What is an MCP? It is a newer thing. It has to do with AI agents and it is a standardized way for AI agents to exchange information. For this specific purpose, it is for the AI agent to understand all of the commands and capabilities of OpenStudio, so that the agent itself can execute those commands and modify your models. If you are cloning an HVAC loop, or injecting a thermal zone, or any of those functions that you do in the OpenStudio application, the AI agent can execute those. In fact, the AI agent has even more capabilities because the OpenStudio application's graphical user interface has only exposed a limited set of the basic needs of the OpenStudio and EnergyPlus software. An AI agent would have the full capabilities of the OpenStudio software development kit. It would have a fuller understanding of how to modify your model. The National Laboratory of the Rockies has developed this MCP server to exchange information with AI agents and basically to teach AI agents how to use OpenStudio. With that, you can basically tell the AI agent in plain English, or whatever your language happens to be, in plain language what exactly you want the AI agent to do. The AI agent can ask you more questions, or if it is simple enough, the AI agent will understand and will query the MCP server to find out what kind of data can be manipulated or changed to modify your model. You could tell the agent: I want to change these windows on the north side of the building to an R-value of this, or a solar heat gain of this. The AI agent can understand that, it can execute the commands for the OpenStudio software development kit, and it can modify your OpenStudio model. With that said, we are going to go through a tutorial on how to get set up with the OpenStudio MCP today. I have created a tutorial. This is an MD file. I will put a link to that in the description below. The idea is that you can go through this yourself, or you can also have your AI go through this with you, and it would help install the OpenStudio MCP. This video presupposes that you have already installed an AI onto your computer. I do go through that in one of my previous videos. I will also put a link to that in the description. That video goes through the installation process for Claude CLI, also known as Claude Code. So that is what we are going to do. Let us go ahead and start Claude. We are going to open up a command prompt and we need to browse to our projects folder. This is a folder that we set up in my previous video. One note about my previous video: there is a lot of extra unrelated stuff, so I would just follow through the steps on that previous video for installing Claude Code. You do not have to continue to the additional steps. I will put a note in the description below. Let us open up that projects folder and let us instantiate Claude. I want to install and test out the OpenStudio MCP. Please guide me through this tutorial, and then we are just going to paste the path to this tutorial. All right. Claude wants to log in. Sometimes that happens. Okay. We are logged in. Claude wants to check if we have WSL, Docker, Git, or a repo or MCP installed. We will just accept. All right. Most of this stuff is not installed. You may have some of these installed, most likely not, but it is entirely possible. Some of this you will have to do by yourself. We need to open up a command prompt separate from Claude. Let us do that. We really need to open up a command prompt with administrator privileges. Let us right click on the Windows button and do Terminal Admin. Click yes. This is PowerShell, but that is okay. Let us copy this and paste it into our PowerShell. Hit enter. It is going to go through installing WSL. WSL stands for Windows Subsystem for Linux and it basically allows you to run Linux on a Windows computer. The reason we need this is because the OpenStudio MCP uses Linux. In order for our Windows machine to talk to the OpenStudio MCP, it uses WSL as an interpreter or a bridge to allow that to happen. Okay, so that is good. We are just going to paste this output back to Claude. Okay. It installed WSL, but Ubuntu was not set up. So first we need to reboot the machine. Let us go ahead and reboot it first. Okay. We are booted back up. Let us open up Claude again, and resume our session. It is going to be this one here. All right. It says: reboot the machine and after it comes up, open up another command prompt and run this right here. Let us copy, right click, Terminal Admin, yes, and paste. We will paste this back to Claude. It says that Ubuntu was not installed. Let us go ahead and copy this and install Ubuntu. Paste this back to Claude. This is one of the issues. We will have to turn off a VPN if we already have one running, as it is not able to resolve this. Let us go ahead and do that now. All right. Let us go ahead and try this again. All right. That works. It is downloading Ubuntu now. If it seems to get stuck, you can cancel and try again. Control-C to cancel. Then let us try to do it again. All right. It is installed successfully and it just wants us to create an account and a password. All right. We will say no for now. Excellent. Ubuntu is installed. All right. We will tell Claude that Ubuntu is installed. It just wants to verify. All right. We have WSL running. The next step is to install Docker Desktop. Docker Desktop is like a sandbox that allows you to run programming code, AI agents, and test programs inside a safe area that is only allowed certain access to certain files. It is contained within this sandbox, so it is not able to get out into your computer. That is what we are going to do here. We will install Docker. We need to go to the website and download Docker Desktop. For us, it is going to be Windows AMD64. Okay, it is downloaded. Let us go ahead and run it. The tutorial says to just go through the regular installation process, but we want to ensure that "Use WSL2 instead of HyperV" is checked. We will click this. Okay. All right. Now that we have installed this new software, we need to close and restart. We are back and we have restarted. It is just going through the service agreement and we are just going to hit Accept. We can skip this stuff for now. Let us open Claude back up. Okay. Docker is running. Claude is going to verify the version. Claude is just going through some setup notes that I have in the tutorial. Now Claude is going to clone the OpenStudio MCP repository. Click yes. This is getting all of the latest information from the MCP repository. Now it is going to build the Docker image. It is building the MCP inside the Docker that we just created. Click yes. Creating directories. Right now it is just building the MCP inside the Docker for us. It is basically building a mini computer in our sandbox that we can use to modify our OpenStudio models in that safe environment. Okay, there is a light power failure here. Let us do this. The next step is to restart Claude, because this session of Claude does not know about or is not connected to the MCP yet. Let us exit out of this and re-enter. Okay. We will type /mcp. It says the OpenStudio MCP is now connected. These are all the tools that the MCP has that Claude has access to. All right. We will hit Escape. Escape. Escape. Claude is asking for the version. Great. It is fully working and now we can jump in and start asking Claude to do something. What we are going to do is something simple. I have an example model here. We will just do something simple, like for instance, this gas heating coil here. This will maybe be easier doing it ourselves, but this is just a demonstration of Claude doing it for us. We have this coil heating gas here and I am just going to ask Claude to change this to an electric heating coil instead. We will copy the path. I have this model at this location. I want to change the coil heating gas one to an electric heating coil instead. What I am going to do here is just let Claude run free with it. Right now we are on manual mode with Claude and I am just going to do Shift-Tab until we get to automatic. That will turn Claude loose and it can just hammer away at it. Click yes. Shift-Tab. Auto. All right. Claude has successfully...well, we will see if it successfully did this, but it looks like it had to write a custom measure, a custom piece of code, to replace that coil for us. One of the things with the OpenStudio MCP is that it has a lot of connectors that allow you to do these things, but it does not actually have methods to do some of this stuff. That is not a problem, though, because AI is really good at creating custom programs. AI can figure out how to make those connections work. That is what Claude had to do here. I will talk about this in some of my future videos as far as adding a code base so that Claude has code snippets it can use. For now, let us go ahead and take a look at what Claude did and see how it turned out. I am going to have it overwrite this model for us. Let us go ahead and take a look at the model. We have got this gas heating coil here, and we asked it to replace it with an electric coil. Let us go to File, Revert to Saved. That should open up the new model that Claude just overwrote. Yes, here it is. It was successfully able to replace that gas coil with an electric heating coil. This was just a simple example. Claude can do a lot of this simple stuff, and more complicated stuff too. I go into some of my other videos about writing custom measures, and AI agents are really good at writing code. That is probably what you will end up using this for most of all: to write custom programs to modify your model, then inspect the energy use, loads, and simulating conditions. That is it in a nutshell for installing the OpenStudio MCP. I hope this tutorial was helpful for you. I look forward to seeing you in the future. Thank you. Please like and subscribe.

OpenStudio를 이용한 모델링 및 시뮬레이션 단계별 과정

이 섹션에서는 SketchUp과 OpenStudio를 사용하여 건물 하중 계산을 수행하는 전체 워크플로를 설명합니다.

1. Create a branch and solve an issue with AI – Reads and understands a real GitHub issue (Issue #857), creates a new branch off develop, works with Claude Code to locate and fix the relevant code, rebuilds incrementally, tests the fix in the running app, commits the change (without staging machine-specific build workarounds), and pushes the branch to open a pull request. 2. Tips from real experience – Practical lessons for working with Claude Code day to day: treating it as a collaborator rather than a magic button, keeping CLAUDE.md updated, using "!" to run shell commands without leaving a session, fixing pre-commit hook failures, running Ruby scripts through OpenStudio's bundled interpreter, handling SSL errors safely, and asking better questions to get better results. Timestamps: 0:00 Introduction 1:15 - Understand the issue 9:30 Part 5: Create a Branch and Solve an Issue With AI 9:45 - Create a new branch 11:14 - Work with Claude to find and fix the code 12:45 - Rebuild incrementally 13:15 - Test your fix 21:30 - Commit your changes 23:11 - Discuss Push and create a pull request 23:48 - Work with Claude to solve the second part of the issue 37:15 - Rebuild incrementally 37:33 - Test your fix 40:45 - Commit the changes 42:15 - Try to Push with new Github account - Unsuccessful 43:30 - Create a whole new Repository with the fix 47:53 - Try to fork on github.com - Unsuccessful 49:08 - Summary

Helix Energy Partners 로고 BW

+1-541-379-0271

Copyright© 2016 by Helix Energy Partners LLC  헬릭스, 오리건 | 이용약관  | 개인 정보 정책

bottom of page