শুরুর নির্দেশনা¶

স্থাপন (ইনস্টলেশন)¶

স্থানীয়ভাবে শুরু করা

Qiskit supports Python 3.7 or later. However, both Python and Qiskit are evolving ecosystems, and sometimes when new releases occur in one or the other, there can be problems with compatibility.

আমরা অ্যানাকোন্ডা, স্থাপন (ইন্সটল) করাকে উৎসাহিত করি যা বৈজ্ঞানিক গণনাকর্মের জন্য বিভিন্ন প্ল্যাটফর্মে ব্যবহৃত Python এর একটি ডিস্ট্রিবিউশন। Qiskit ব্যবহারের জন্য অ্যানাকোন্ডার অন্তর্ভুক্ত জুপিটার প্রস্তাব করা হয়ে থাকে।

উন্নত অভিজ্ঞতা অর্জনের লক্ষ্যে, Qiskit কে অন্যান্য কার্যক্রম থেকে বিচ্ছিন্ন করে রাখার জন্য আমরা Python এর কৃত্রিম কর্মপরিবেশ (ভার্চুয়াল এনভায়রনমেন্ট) ব্যবহারের পরামর্শ দেই।

কর্মপরিবেশগুলো (এনভায়রনমেন্ট) ব্যবহারের সবচেয়ে সহজ উপায় হচ্ছে Anaconda এর অন্তর্ভুক্ত conda নির্দেশনা ব্যবহার করা। কোন্ডার (conda) কর্মপরিবেশ (এনভায়রনমেন্ট) Python (পাইথন ) এর একটি নির্দিষ্ট সংস্করণ এবং এর অন্তর্ভুক্ত লাইব্রেরিগুলো ব্যবহারের অনুমতি দেয়। আপনি কাজ করতে চান এমন একটি ডিরেক্টরিতে টার্মিনাল উইন্ডো চালু করে সেখানে কাজ করতে পারেন।

It is preferred that you use the Anaconda prompt installed with Anaconda. All you have to do is create a virtual environment inside Anaconda and activate the environment. These commands can be run in the Anaconda prompt irrespective of Windows or Linux machine.

শুধুমাত্র Python স্থাপন (install) করে একটি ঊন (minimal) কর্মপরিবেশ (এনভায়রনমেন্ট) তৈরি করুন।

conda create -n ENV_NAME python=3

আপনার নতুন কর্মপরিবেশ (এনভায়রনমেন্ট) সক্রিয় করুন।

conda activate ENV_NAME

এর পরে, Qiskit প্যাকেজ ইনস্টল করুন।

pip install qiskit

যদি প্যাকেজগুলো সঠিকভাবে স্থাপন করা হয়ে থাকে তবে কৃত্রিম কর্মপরিবেশে (ভার্চুয়াল এনভায়রনমেন্টে) সক্রিয় প্যাকেজগুলো দেখার জন্য আপনি conda list নির্দেশনাটি চালাতে পারেন।

আপনি যদি ভিজুয়ালাইজেশন (দৃশ্যায়ন) ফাংশনালিটি অথবা জুপিটার নোটবুক ব্যবহার করতে চান তাহলে ভিজুয়ালাইজেশনের (দৃশ্যায়ন) যথোপযুক্ত শর্তগুলি (রিকোয়ারমেন্টস) সমেত qiskit স্থাপন করুন।

pip install qiskit[visualization]

মনে করিয়ে দেয়া প্রয়োজন, আপনি যদি zsh (ম্যাকওএস এর নতুনতর সংস্করণগুলোতে এটি পূর্বনির্ধারিত (ডিফল্ট) শেল) ব্যবহারকারী হয়ে থাকেন তাহলে আপনাকে উদ্ধৃতির মধ্যে qiskit[visualization] লিখতে হবে:

pip install 'qiskit[visualization]'

ক্লাউড এ শুরু করুন

নিম্নলিখিত ক্লাউড বিক্রেতাদের কর্মপরিবেশে (এনভায়রনমেন্ট) Qiskit আগেই ইনস্টল করা রয়েছেঃ

IBM Quantum Lab

Build quantum applications and experiments with Qiskit in a cloud programming environment.

Strangeworks

A platform that enables users and organizations to easily apply quantum computing to their most pressing problems and research.

উৎস থেকে স্থাপন

উৎস থেকে উপাদানগুলি ইনস্টল করলে Python Package Index (PyPI) রিপোজিটরির সংস্করণ ব্যবহার না করে Qiskit এর সর্বশেষ সংস্করণটি আপনি ব্যবহার করতে পারবেন। এটি আপনাকে Qiskit কোডের সর্বশেষ সংস্করণটি আরও নিখুঁত ভাবে পর্যবেক্ষণ এবং প্রসারিত করার দক্ষতা দেবে।

উৎস থেকে উপাদানগুলো ইন্সটল করার সময় stable সংস্করণের (যার কিনা pip প্যাকেজের সমতুল্য কোডবেজ আছে) বিপরীতে ডিফল্ট হিসেবে development সংস্করণ (master গিট শাখার) ব্যবহৃত হয়। development সংস্করণে নতুন ফিচার এবং পরিবর্তন অন্তর্ভুক্ত থাকায় সাধারণত অন্য সব উপাদানের জন্যও development সংস্করণ ব্যবহৃত হয়।

টেরা এবং এয়ার প্যাকেজ উভয়ই উৎস থেকে ইনস্টল করার আগে একটি কম্পাইলার প্রয়োজন। ইগনিস, অ্যাকোয়া, এবং আই বি এম কোয়ান্টাম প্রোভাইডার ব্যাকএন্ড এর জন্যে কম্পাইলার প্রয়োজন নেই।

যদি pip এর সংস্করণ উৎসের সংস্করণের চেয়ে পুরনো হয় তবে উপাদানগুলির নিম্নতর সংস্করণ ইনস্টল করা থেকে বিরত থাকার জন্য উৎস থেকে উপাদানগুলি ইনস্টল করার নিম্নলিখিত ক্রম অনুসরণ করা প্রয়োজনঃ

qiskit-terra
qiskit-aer
qiskit-ignis
qiskit-ibmq-provider (আপনি যদি আই বি এম কোয়ান্টামযন্ত্র বা অনলাইন সিমুলেটরের সাথে যুক্ত হতে চান)

একসাথে বেশ কয়েকটি উপাদানের সাথে কাজ করতে প্রতিটি উপাদানের জন্য নিম্নলিখিত পদক্ষেপগুলি ব্যবহার করুন।

নোট

Python এর নেমস্পেস প্যাকেজিংয়ের কারণে প্যাকেজ ইন্সটল (স্থাপন) করার সময় সতর্ক হতে হবে। উৎস থেকে ইন্সটল (স্থাপন) করার সময় qiskit মেটা প্যাকেজ ব্যবহার করবেন না। এই নির্দেশিকাটি অনুসরণ করুন এবং একটি পৃথক কৃত্রিম কর্মপরিবেশ তৈরি করুন। আপনি যদি ইন্সটল করা বিদ্যমান কোনো প্যাকেজ সংযুক্ত করতে চান তবে একসাথে কাজ করে এমন উপযুক্ত কম্বিনেশনের জন্য https://github.com/pypa/sample-namespace-packages/blob/master/table.md অনুসরণ করুন।

Set up the Virtual Development Environment

conda create -y -n QiskitDevenv python=3
conda activate QiskitDevenv

Installing Terra from Source

উৎস থেকে ইনস্টল করার জন্য আপনার সিস্টেমে আপনার C++ কম্পাইলার থাকা দরকার যা C++ 11 সমর্থন করে।

লিনাক্স এর কম্পাইলার

বেশিরভাগ লিনাক্স প্ল্যাটফর্মে, প্রয়োজনীয় জিসিসি কম্পাইলার ইতিমধ্যে ইনস্টল করা থাকে।

ম্যাক ও এস এর কম্পাইলার

আপনি যদি ম্যাক ওএস ব্যবহার করেন তাহলে Xcode ইনস্টল করে CLang ইনস্টল করতে পারেন। টার্মিনাল এর সাহায্যে দেখে নিন XCode এবং Clang ইনস্টল করা আছে কিনা।

clang --version

নিচের কমান্ড অনুসারে XCode এবং Clang ইনস্টল করুন।

xcode-select --install

উইন্ডোজ এর কম্পাইলার

উইন্ডোজে ভিজ্যুয়াল স্টুডিও ২০১৭ এর জন্য বিল্ড টুলস থেকে ভিজ্যুয়াল সি++(C++) ইনস্টল করা সহজতম। এছাড়াও আপনি সি++(C++) কম্পাইলার নির্বাচন করে ভিজ্যুয়াল স্টুডিওর ২০১৫ অথবা ২০১৭ সংস্করণ ইনস্টল করতে পারেন।

কম্পাইলার ইনস্টল হয়ে যাওয়ার পর আপনি Qiskit টেরা ইনস্টল করার জন্যে তৈরী।

টেরা রিপোজিটরিটির ক্লোন বা প্রতিলিপি করুন।
```
git clone https://github.com/Qiskit/qiskit-terra.git
```
রিপোজিটোরিটি ক্লোন করলে qiskit-terra নামক একটি স্থানীয় ফোল্ডার তৈরী হবে।
```
cd qiskit-terra
```
qiskit-terra ডিরেক্টরি থেকে Python এর যাবতীয় দরকারি লাইব্রেরি ইনস্টল করুন।
```
pip install cython
```
টেস্ট রান করানোর জন্য বা লিনটিং চেক করার জন্য, ডেভেলাপারের রিকোয়ারমেন্টগুলি ইনস্টল করুন।
```
pip install -r requirements-dev.txt
```
qiskit-terra ইনস্টল করুন।
```
pip install .
```

আপনি যদি এটিকে সম্পাদনযোগ্য মোডে ইনস্টল করতে চান, মানে এই প্রকল্পের কোড পরিবর্তনের জন্য প্রয়োগ করার জন্য পুনরায় ইনস্টল করা প্রয়োজন না, আপনি এটি করতে পারেনঃ

pip install -e .

টেরা ইনস্টল করার পরে আপনি কোডের উদাহরণগুলি চালাতে পারেন। আপনি নিম্নলিখিত কমান্ড দিয়ে উদাহরণ চালাতে পারেন।

python examples/python/using_qiskit_terra_level_0.py

নোট

আপনি যদি আর কোনো উপাদান ইনস্টল না করে থাকেন তবে qiskit-টেরা একটি RuntimeWarning সতর্কীকরণ দেবে যে qiskit-এয়ার এবং qiskit-আইবিএমকিউ-প্রোভাইডার কোনোটিই ইনস্টল করা নেই। এটি ঘটে থাকে কারণ সাধারণত ব্যবহারকারীরা অতিরিক্ত উপাদান ব্যবহার করতে চাইলেও উপলব্ধি করতে পারেননা যে হয় কোনোটিই ইনস্টল করা নেই অথবা এয়ার (Aer) বা আইবিএম কোয়ান্টাম প্রোভাইডার এর ইনস্টলেশন কোনোকারণে ব্যর্থ হয়েছে। আপনি যদি এইরূপ সতর্কীকরণ দমিত করতে চান, যুক্ত করুন:

import warnings
warnings.filterwarnings('ignore', category=RuntimeWarning,
                        module='qiskit')

আপনার কোডে কোনোরকম qiskit ইম্পোর্টের পূর্বে। এটি অনুপস্থিত qiskit-এয়ার এবং Qiskit-আইবিএমকিউ-প্রোভাইডার এর সতর্কীকরণ কে দমিত করলেও Qiskit বা অন্যান্য প্যাকেজ এর সতর্কীকরণ দেখাবে।

Installing Aer from Source

এয়ার রিপোজিটরিটির ক্লোন বা প্রতিলিপি করুন।
```
git clone https://github.com/Qiskit/qiskit-aer
```
বিল্ড করার শর্তগুলো (রিকোয়ারমেন্ট) ইন্সটল করুন।
```
pip install cmake scikit-build cython
```

পরের ধাপগুলো নির্ভর করে আপনি কোন অপারেটিং সিস্টেম ব্যবহার করছেন তার ওপর। যেহেতু এয়ার Python ইন্টারফেসযুক্ত সি++ এ কম্পাইল করা ফ্রেমওয়ার্ক, তাই এয়ার বাইনারি ফাইলগুলো গঠন করতে কিছু Python-নয় এমন ডিপেন্ডেন্সি বা শর্ত প্রয়োজন হয় যেগুলো সব অপারেটিং সিস্টেমে সার্বজনীনভাবে ইন্সটল করা যায় না।

Qiskit এয়ার কোয়ান্টাম বর্তনী (সার্কিট) কার্যকর করার একটি উচ্চ কর্মদক্ষতাসম্পন্ন সিমুলেটর ফ্রেমওয়ার্ক। এটি বিভিন্ন ধরনের অবস্থা অনুকরণের (সিমুলেশনের) জন্য কিছু ব্যাকএন্ড সরবরাহ করে।

conda install --update-deps -c conda-forge -y openblas cmake

qiskit-এয়ার সরাসরি গঠন (বিল্ড) এবং ইন্সটল করুন।

যদি আপনার পিপ (pip) <১৯.০.০ ইন্সটল করা থাকে এবং এনভায়রনমেন্টে কাস্টম বিল্ড প্রয়োজন না হয় তবে নিচের নির্দেশনাগুলো কার্যকর করুনঃ
```
cd qiskit-aer
pip install .
```
এর ফলে বাইনারি বিল্ডের সাথে এয়ারও ইন্সটল হবে।

অথবা আপনার যদি পিপ এর নতুন সংস্করণ ইন্সটল করা থাকে অথবা কিছু কাস্টম রিকোয়ারমেন্ট থেকে থাকে, তাহলে আপনি ম্যানুয়ালি একটি Python হুইল তৈরি (বিল্ড) করতে পারেন।
```
cd qiskit-aer
python ./setup.py bdist_wheel
```
হুইল বিল্ডের সময় কাস্টম অপশন নির্ধারণ করে থাকলে নিজের মতো বিকল্প হুইল বিল্ড এর সময় এ নির্দেশ করুন।

Python হুইল গঠন করার পর এটি এয়ার রিপোজিটরির dist/ ডিরেক্টরিতে সংরক্ষিত থাকবে। যথাযথ সংস্করণটির জন্য প্রয়োজন হবে
```
cd dist
pip install qiskit_aer-*.whl
```
আউটপুট হুইল ফাইলের নামটি নির্ভর করে ডেভেলাপমেন্ট বা অগ্রগতি চলতে থাকা এয়ারের বর্তমান সংস্করণের ওপর।

Custom options

এয়ার সম্পাদনার (কম্পাইলেশনের) জন্য পাইথন ইন্টারফেসের সাথে scikit-build ব্যবহার করে। এটি setuptools এর জন্য একটি ইন্টারফেস হিসেবে কাজ করে যাতে CMake কল হয় এবং স্থানীয় ব্যবস্থায় দ্বিমিকগুলো (বাইনারি) সম্পাদিত (কম্পাইল) হয়।

বাইনারিগুলি সম্পাদনা (কম্পাইল) জটিলতার কারণে আপনার বিল্ড প্রক্রিয়াটির একটি নির্দিষ্ট অংশে বিকল্পগুলি সরবরাহ করতে হতে পারে। ভ্যারিয়েবলগুলি সরবরাহ করার উপায়টি হলঃ

python setup.py bdist_wheel [skbuild_opts] [-- [cmake_opts] [-- build_tool_opts]]

যেখানে [] ৩য় বন্ধনী ভিতরের উপাদান (এলিমেন্টস) ঐচ্ছিক এবং skbuild_opts, cmake_opts, build_tool_opts কে আপনার পছন্দের চিহ্ন (ফ্ল্যাগ) দিয়ে পুনঃস্থাপন করতে পারবেন। CMake অপশনের একটি তালিকা এখানে পাওয়া যাবেঃ https://cmake.org/cmake/help/v3.6/manual/cmake.1.html#options। যেমন, আপনি যদি এমন কিছু কার্যকর করতে চানঃ

python setup.py bdist_wheel -- -- -j8

এটি গঠন ব্যবস্থায় -j8 চিহ্ন (ফ্ল্যাগ) (যেটি এক্ষেত্রে Automake) পাঠায় যাতে আপনি আটটি প্রসেস সমান্তরালে গঠন করেন।

উদাহরণস্বরূপ, লিনাক্স মেশিনে C++ কম্পাইলারের নির্দিষ্ট সংস্করণ নির্দেশিত করা (সাধারণত যদি ডিফল্ট সংস্করণটি খুব পুরোনো হয়) এই নিশানগুলোর (ফ্ল্যাগ) একটি পরিচিত ব্যবহারক্ষেত্র।

python setup.py bdist_wheel -- -DCMAKE_CXX_COMPILER=g++-7

যেটি Aer কম্পাইল করার সময় সিমেক (CMake) কে চিরাচরিত g++ কমান্ডের পরিবর্তে g++-7 কম্যান্ড ব্যবহার করার নির্দেশ দিবে।

এটির আর একটি পরিচিত ব্যবহারিক ক্ষেত্র হলো আপনাকে নিজস্ব প্লাটফর্মের নাম নির্দিষ্ট করতে হবে এবং স্থায়ী (স্ট্যাটিক) লিঙ্কিং বন্ধ করে রাখতে হবে, আপনার কম্পিউটারের কর্মপরিবেশ (এনভায়রনমেন্ট) অনুযায়ী।

python setup.py bdist_wheel --plat-name macosx-10.9-x86_64 \
-- -DSTATIC_LINKING=False -- -j8

এখানে --plat-name ফ্ল্যাগটি একটি সেটআপ টুল যা প্যাকেজ মেটাডাটায় প্লাটফর্মের নাম ঠিক করতে ব্যবহৃত হয়, -DSTATIC_LINKING ফ্ল্যাগটি CMake ব্যবহার করে স্ট্যাটিক লিঙ্কিং বিচ্ছিন্ন করা এবং -j8 চিহ্ন (ফ্ল্যাগ) ব্যবহার করে Automake এর সাহায্যে আটটি প্রক্রিয়া (প্রসেস) কার্যকর করা হয়।

প্ল্যাটফর্মের উপর নির্ভর করে সাধারণ বিকল্পগুলির (অপশন) একটি তালিকাঃ

প্ল্যাটফর্ম	টুল বা যন্ত্র	বিকল্প বা অপশন	ব্যবহারের ক্ষেত্র
সমস্ত	Automake	-j	তারপর থাকবে একটি সংখ্যা, যা সংকলনের জন্য প্রক্রিয়ার (প্রসেস) সংখ্যা নির্ধারণ করে।
লিনাক্স	CMake	-DCMAKE_CXX_COMPILER	একটি নির্দিষ্ট C++ সম্পাদক (কম্পাইলার) নির্দিষ্ট করতে ব্যবহৃত হয়; আপনার ডিফল্ট g++ খুব বেশি পুরাতন হলে এটি প্রায়শই প্রয়োজন।
OSX	সেটআপটুলস	--plat-name	Python প্যাকেজ আউটপুটটিতে প্ল্যাটফর্মের নাম নির্দিষ্ট করতে ব্যবহৃত হয়।
OSX	CMake	-DSTATIC_LINKING	স্থির (স্ট্যাটিক) লিঙ্ক ব্যবহার করা উচিত কিনা তা নির্দিষ্ট করতে ব্যবহৃত হয়।

নোট

এর মধ্যে কয়েকটি বিকল্প প্ল্যাটফর্ম-নির্দিষ্ট নয়। এই নির্দিষ্ট প্ল্যাটফর্মগুলি তালিকাভুক্ত করা হয় কারণ এগুলি সাধারণত কর্মপরিবেশে (এনভায়রনমেন্ট) ব্যবহৃত হয়। আরও তথ্যের জন্য সরঞ্জাম (টুল) ডকুমেন্টেশন দেখুন।

Installing Ignis from Source

ইগ্নিস রিপোজিটরিটির ক্লোন বা প্রতিলিপি করুন।
```
git clone https://github.com/Qiskit/qiskit-ignis.git
```
রিপোজিটিরিটি ক্লোন বা প্রতিলিপি করায় qiskit-ignis নামে একটি স্থানীয় ডিরেক্টরি তৈরি হবে।
```
cd qiskit-ignis
```
যদি আপনি পরীক্ষা চালাতে চান তাহলে ডেভেলাপার রিকোয়ারমেন্টস বা আবশ্যিক শর্তসমূহ ইন্সটল করবেন। উৎস থেকে qiskit-ignis প্যাকেজ ইন্সটল বা ব্যবহার করতে এর প্রয়োজন নেই।
```
pip install -r requirements-dev.txt
```
ইগ্নিস ইন্সটল করুন।
```
pip install .
```

যদি আপনি এটি সম্পাদনযোগ্য মোডে ইন্সটল করতে চান, অর্থাৎ প্রকল্পে কোড পরিবর্তন হলে যেন নতুন করে ইন্সটল করতে না হয়ঃ

pip install -e .

Installing IBM Quantum Provider from Source

qiskit-ibmq-provider রিপোজিটরিটির ক্লোন বা প্রতিলিপি করুন।
```
git clone https://github.com/Qiskit/qiskit-ibmq-provider.git
```
রিপোজিটিরিটি ক্লোন বা প্রতিলিপি করায় qiskit-ibmq-provider নামে একটি স্থানীয় ডিরেক্টরি তৈরি হবে।
```
cd qiskit-ibmq-provider
```
যদি আপনি পরীক্ষা চালাতে চান তাহলে ডেভেলাপার রিকোয়ারমেন্টস বা আবশ্যিক শর্তসমূহ ইন্সটল করবেন। উৎস থেকে qiskit-ibmq-provider ইন্সটল বা ব্যবহার করতে এর প্রয়োজন নেই।
```
pip install -r requirements-dev.txt
```
qiskit-ibmq-provider ইন্সটল করুন।
```
pip install .
```

যদি আপনি এটি সম্পাদনযোগ্য মোডে ইন্সটল করতে চান, অর্থাৎ প্রকল্পে কোড পরিবর্তন হলে যেন নতুন করে ইন্সটল করতে না হয়ঃ

pip install -e .

Platform Support¶

Qiskit strives to support as many platforms as possible, but due to limitations in available testing resources and platform availability, not all platforms can be supported. Platform support for Qiskit is broken into 3 tiers with different levels of support for each tier. For platforms outside these, Qiskit is probably still installable, but it's not tested and you will have to build Qiskit (and likely Qiskit's dependencies) from source.

Additionally, Qiskit only supports CPython. Running with other Python interpreters isn't currently supported.

Tier 1¶

Tier 1 supported platforms are fully tested upstream as part of the development processes to ensure any proposed change will function correctly. Pre-compiled binaries are built, tested, and published to PyPI as part of the release process. These platforms are expected to be installable with just a functioning Python environment as all dependencies are available on these platforms.

Tier 1 platforms are currently:

Linux x86_64 (distributions compatible with the manylinux 2014 packaging specification.

macOS x86_64 (10.9 or newer)

Windows 64 bit

Tier 2¶

Tier 2 platforms are not tested upstream as part of development process. However, pre-compiled binaries are built, tested, and published to PyPI as part of the release process and these packages can be expected to be installed with just a functioning Python environment.

Tier 2 platforms are currently:

Linux i686 (distributions compatible with the manylinux 2014 packaging specification) for Python < 3.10

Windows 32 bit for Python < 3.10

Linux aarch64 (distributions compatible with the manylinux 2014 packaging specification)

Tier 3¶

Tier 3 platforms are not tested upstream as part of the development process. Pre-compiled binaries are built and published to PyPI as part of the release process, with no testing at all. They may not be installable with just a functioning Python environment and may require a C/C++ compiler or additional programs to build dependencies from source as part of the installation process. Support for these platforms are best effort only.

Tier 3 platforms are currently:

Linux i686 (distributions compatible with the manylinux 2014 packaging specification) for Python >= 3.10

Windows 32 bit for Python >= 3.10

macOS arm64 (10.15 or newer)

আরো এগোতে প্রস্তুত?...¶

Qiskit from the ground up

Learn how to build, execute, and post-process quantum circuits with Qiskit.

Start learning Qiskit

Dive into the tutorials

Find out how to leverage Qiskit for everything from single-circuits to full quantum application development.

Qiskit tutorials