키스킷 설치하기

요구 사항

키스킷은 파이선 3.5나 이후 버전을 지원한다. 그러나 파이썬과 키스킷은 상호 진화하는 생태계를 이루기 때문에 때때로 어느 한쪽에서 새로운 버전이 출시되면, 호환성에 문제가 발생할 수도 있다.

만약 파이썬을 업데이트 하고 나서 키스킷을 사용하거나 설치하는데 문제가 발생한다면, 특정한 버전의 파이쎤이 지원되는지 확인을 위해 프로그래밍 언어 을 위한 Qiskit Package metadata <https://pypi.org/project/qiskit/> 을 참조하라.

과학 계산을 위해서 교차 사용이 가능한 파이썬 배포본인 `아나콘다 (Anaconda) <https://www.anaconda.com/download/>`를 설치하는 것을 추천한다. 아나콘다에 포함된 주피터(Jupyter) 패키지는 키스킷과 상호 작용하는 프로그래밍을 위해 사용되면 좋다.

키스킷은 다음의 64비트 시스템들에서 실행되고 지원되는지 확인하였다.

  • 우분투 16.04 혹은 최신 버전

  • 맥오에스 (macOS) 10.12.6 혹은 최신 버전

  • 윈도우 7 혹은 최신 버전

설치하기

키스킷을 다른 응용 프로그램과 분리해서 설치하고 사용자 경험을 증진시키기 위해서 파이썬을 가상 환경에 설치하는 것을 추천한다.

가상 환경을 사용하기 위한 가장 손쉬운 방법은 아나콘다(Anaconda) 에 포함되어 있는 conda 명령어를 사용하는 것이다. 콘다(Conda) 환경은 특정 버전의 파이썬이나 라이브러리 등을 선택할 수 있게 해준다. 작업하고자 하는 디렉토리에서 터미널 창을 연다.

아나콘다와 함께 설치된 아나콘다 프롬프트를 사용하기를 권장한다. 가상 환경을 아나콘다에 만들고 그 환경을 활성화 하기만 하면 된다. 이러한 명령어들은 윈도우나 리눅스에 상관없이 아나콘다 프롬프트에서 실행할 수 있다.

오직 파이썬만 설치한 최소한의 환경을 만드시오.

conda create -n name_of_my_env python=3

새로운 환경을 활성화하라.

conda activate name_of_my_env

참고

4.6 이전 버전의 conda를 사용하고 있다면 리눅스나 macOS 사용자는 source activate name_of_my_env 와 같이 윈도우 사용자는 activate name_of_my_env 와 같이 하라.

다음으로 테라, 아르, 이그니스, 아쿠아를 포함하고 있는 키스킷 패키지를 설치한다.

pip install qiskit

참고

키스킷 0.13.0 버전부터는 리눅스에서 미리 컴파일된 바이너리 파일로 키스킷-아르를 설치하기 위해서는 pip 19 혹은 최신의 버전이 필요하다. 만약 19 버전의 pip가 설치되어 있지 않다면 다음의 명령어 ``pip install -U pip``로 업그레이드 할 수 있다. pip 19 혹은 최신 버전이 없다면 이 명령어는 소스 배포본(sdist) 로부터 키스킷-아르를 설치하기 위해 현재 사용하는 컴퓨터에서 아르를 소스 컴파일하려고 할 것이다.

If the packages were installed correctly, you can run conda list to see the active packages in your virtual environment.

시각화 기능 또는 주피터 노트북을 사용하려면 시각화 추가 요구 사항과 함께 키스킷 설치를 권한다.

pip install qiskit[visualization]

It is worth pointing out that if you’re a zsh user (which is the default shell on newer versions of macOS), you’ll need to put qiskit[visualization] in quotes:

pip install 'qiskit[visualization]'

참고

사용하고자 하는 키스킷 패키지들을 다 설치하고 확인하였다면, 시작하기 위해서 파이썬 환경에 그것들을 임포트해야 한다.

import qiskit

참고

만약 최신 버전의 키스킷 코드에 새로운 코드를 개발하여 키스킷 공동체에 기여를 하고 싶다면, 다음 소스 코드로부터 키스킷 설치하기 을 참조하시오.

IBM 양자 시스템에 접근하기

아이비엠 양자 시스템은 키스킷을 이용하여 아이비엠 양자 경험 소프트웨어를 통해 고성능의 고전적인 연산 시뮬레이터와 실제 양자 컴퓨터를 사용할 수 있는 기회를 제공한다. 아이비엠 양자 시스템에서 연산 작업을 실행하기 위해서는 다음의 과정을 통해 키스킷 환경을 설정하라.

참고

키스킷 0.11 버전부터는 만약 이전 버전의 IBM 양자 경험 증명서를 자신의 컴퓨터에 저장하였다면, 새로운 양자 경험 시스템 V2를 사용하기 위해서 IBM 양자 경험 증명서를 업데이트해야 한다. 다음을 참조하라. IBM 양자 경험 증명서 업데이트하기 <https://github.com/Qiskit/qiskit-ibmq-provider/#updating-your-ibm-q-experience-credentials>

계정을 설정하기 위해 응용 프로그램 인터페이스(API) 키를 포함하는 설정 파일을 생성해야 한다.

1. 무료 아이비엠 양자 경험 시스템 계정 만들기.

2. 계정 설정을 보기 위해서 My Account 항목을 열기.

Image of where to find the section 'My accounts'.

3. 다음 **Copy token**를 선택하여 토큰을 클립보드로 복사하라. 임시로 이 응용 프로그램 인터페이스 토큰을 자주 사용하는 문서 편집기에 저장해 놓고 나중에 계정 설정 파일을 만들때 사용하도록 하라.

Image of where to get an API token.

4. 다음 명령어를 실행하여서 API 토큰을 저장하고 나중에 qiskitrc 인 설정 파일에 사용하도록 하라. MY_API_TOKEN 을 문서 편집기에 저장해 놓았던 토큰값으로 교체하라.

from qiskit import IBMQ
IBMQ.save_account('MY_API_TOKEN')

여러개의 아이비엠 양자 시스템 계정 증명서를 관리하기 등과 같은 자세한 내용에 관해서는 사용 지침 프로그램 아이엠 양자 시스템 계정 을 참조하도록 하라.

어느 버전의 키스킷이 설치되어 있는지 확인하기

키스킷 패키지에는 유명한 여러 개의 구성 요소를 가지고 있기 때문에, 단순히 qiskit.__version__ 명령어가 출력하는 결과는 오해의 소지가 있다. 참고로 이 명령어는 키스킷-테라 (qiskit-terra) 의 버전만을 알려준다. 왜냐하면 파이썬에서 키스킷 명칭 공간 (namespace) 는 전체 키스킷 패키지에서 오지 않고 키스킷-테라 패키지에서 오기 때문이다.

import qiskit
qiskit.__version__
'0.16.0'

지금 환경에서의 모든 키스킷 구성 요소의 버전을 보기 위해서는 __qiskit_version__ 속성을 이용해야 한다. 예를 들어, 다음의 명령어를 실행하면 설치된 키스킷 패키지 각각의 버전을 담고 있는 딕셔너리 변수를 돌려준다.

qiskit.__qiskit_version__
{'qiskit-terra': '0.16.0',
 'qiskit-aer': '0.7.0',
 'qiskit-ignis': '0.5.0',
 'qiskit-ibmq-provider': '0.11.0',
 'qiskit-aqua': '0.8.0',
 'qiskit': '0.23.0'}

만약 특정한 이유로 설치된 키스킷 버전을 공유하거나 이슈를 항목별로 철하기 위해서는 __qiskit_version__ 속성을 이용하라.