이 매뉴얼은 MagLab을 실제 연구 작업에 쓰려는 자성/스핀트로닉스 연구자를 위해 작성되었습니다. 각 문서는 연구 병목에서 시작해서 바로 실행할 수 있는 명령으로 끝납니다.
| 영역 | 필요한 경우 |
|---|---|
| 빠른 시작과 실제 운용 | MagLab을 전역 CLI로 설치하고, 연구 폴더를 열고, LLM backend를 연결하고, 첫 재현 가능 workflow를 실행할 때. |
| 문헌 인텔리전스 | 논문 검색, 키워드 추출, evidence matrix 생성, 저자/저널/인용 그래프 확인이 필요할 때. |
| 물질과 물리 | 자성 물질 조회, 스택 구성, 물리 공식 계산, 단위 변환, plausibility check가 필요할 때. |
| 시뮬레이션 | micromagnetic, DFT, atomistic, multiscale simulation workflow를 준비할 때. |
| 분석과 피팅 | 데이터를 로드하고, 모델을 확인하고, 스핀트로닉스 효과를 피팅하고, consistency를 체크할 때. |
| 그림 | FigureSpec, journal-aware figure, multi-panel export, schematic primitive가 필요할 때. |
| 계측기 | PyVISA driver, SCPI validation, manual RAG, measurement script, safety check가 필요할 때. |
| 연구노트와 계획 | ELN 기록, note 조회, measurement plan, DOE, active-learning 제안이 필요할 때. |
| 리뷰와 이상 현상 설명 | manuscript review panel이나 anomalous result mechanism 후보가 필요할 때. |
| 논문 작성과 커뮤니케이션 | 논문, revision letter, cover letter, email, abstract, grant, slide, poster 초안이 필요할 때. |
| 오케스트레이션, agent, MCP, gateway | REPL, one-shot prompt, Ralph loop, subagent, skill, MCP, gateway bot, cost/config tooling을 쓸 때. |
- 빠른 시작과 실제 운용에서 전역 설치와 폴더 모델을 먼저 확인합니다.
- 물질과 물리에서 deterministic core를 이해합니다.
- 지금 당장 필요한 연구 작업에 해당하는 문서를 읽습니다.
- 여러 도구를 묶고 싶을 때 오케스트레이션을 읽습니다.
- 검증된 결과가 준비된 뒤 논문 작성과 커뮤니케이션을 사용합니다.
uv venv --python 3.12
source .venv/bin/activate
uv pip install -e .
uv pip install -e ".[research]"
maglab doctor
maglab setup all
maglab manual --lang ko실제 연구 장비에서는 전체 research bundle인 .[research]를 권장합니다.
maglab doctor는 현재 폴더, backend, extra package, 외부 tool, simulation stack의
first-run readiness를 보여줍니다. maglab setup all은 이미 준비된 기능, 추가
터미널 설정이 필요한 기능, 대응되는 REPL slash command를 한 번에 보여줍니다.
개별 기능은 maglab setup <feature>나 /setup-<feature>로 점검할 수 있습니다.
동일한 매뉴얼은 전역 설치된 CLI에도 포함됩니다. maglab manual --lang ko로
목록을 보고, maglab manual figures --lang ko처럼 특정 항목으로 바로 들어갈 수
있습니다.
OOMMF, MuMax3, magnum.np, VAMPIRE, VASP, Quantum ESPRESSO 같은 solver는 MagLab 외부에서 별도 설치가 필요할 수 있습니다.