Basilisk 설치

[Windows 11에 설치]

 

1. 필수 도구 설치

 

 1-1. Python 3.13.3 설치 (PATH 포함)
   https://www.python.org/downloads
   설치 시 “Add Python to PATH” 반드시 체크

   설치 후 확인:

python --version 
pip --version

 

 1-2. Git 설치
   https://git-scm.com/downloads

 1-3. Visual Studio 2022 설치

   https://visualstudio.microsoft.com/
   설치 시 반드시 “Desktop development with C++” 선택
   cl.exe 위치를 시스템 PATH에 추가 (시스템 환경 변수 편집 → Path 편집 → 위 경로를 추가)

 

 1-4. SWIG 설치

   정식 Windows 실행 파일 다운로드
   https://github.com/swig/swig/releases
   파일을 적절한 경로에 압축 해제 (예: C:\Tools\swigwin-4.3.1)

   시스템 환경 변수에 경로 추가 (시스템 환경 변수 편집" → Path 편집 → “C:\Tools\swigwin-4.3.1” 추가

2. Basilisk 소스코드 다운로드

git clone https://github.com/AVSLab/basilisk.git
cd basilisk

 

 3. Python 가상환경 만들기 (Anaconda 가상환경에서는 작동안함)

python -m venv venv 
.\venv\Scripts\activate

 

   확인: (venv) 표시가 나와야 성공

(venv) C:\Users\username\basilisk>

 

   오류가 나면 관리자 권한으로 PowerShell을 실행한 후 아래 명령을 입력 

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

 

4. Conan 설치

pip install conan

 

5.conanfile.py 편집

   경로: C:\Users\username\basilisk\conanfile.py

set_generator = "-G \"Visual Studio 16 2019\""

   를

set_generator = "-G \"Visual Studio 17 2022\""

 

   로 수정

 

6. Basilisk 설치

python conanfile.py

 

7. 예제 실행

python examples/scenarioBasicOrbit.py

8. 프로젝트 폴더 설정

   D:\bsk_projects

   프로젝트 폴더에 .vscode/settings.json 파일을 만들고 아래처럼 설정:

{ 
   "python.defaultInterpreterPath": "C:/Users/username/basilisk/venv/Scripts/python.exe" 
}

 

 

 

 

 

[맥 M 시리즈에 설치]

 

1. 필수 도구 설치

xcode-select --install
brew install cmake swig python git pcre2 automake bison
echo 'export PATH="/opt/homebrew/opt/bison/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

 

2. SWIG 설치

cd ~
curl -LO https://github.com/swig/swig/archive/refs/tags/v4.2.1.tar.gz
tar -xzf v4.2.1.tar.gz
cd swig-4.2.1
./autogen.sh
./configure --prefix=/opt/swig421
make -j$(sysctl -n hw.logicalcpu)
sudo make install

 

   이렇게 하면 SWIG가 /opt/swig421/bin/swig 에 설치됨

export PATH="/opt/swig421/bin:$PATH"
export SWIG_EXECUTABLE="/opt/swig421/bin/swig"

 

3. Basilisk 소스코드 다운로드

git clone >https://github.com/AVSLab/basilisk.git
cd basilisk

 

4. Python 가상환경 만들기 (Anaconda 가상환경에서는 작동안함)

python3 -m venv venv 
source venv/bin/activate

 

5. Conan 및 기타 패키지 설치

pip install --upgrade pip 
pip install conan packaging matplotlib numpy

 

6. Basilisk 설치

python conanfile.py

 

7. 프로젝트 폴더에 .vscode/settings.json 파일을 만들고 아래처럼 설정:

{ 
   "python.pythonPath": "/Users/username/basilisk/venv/bin/python" 
}