Q# programlarını ve Visual Studio Code kullanmaya başlama
Bu makalede, VS Code kullanarak Azure Quantum'a Q#, Jupyter Notebook veya Python kuantum bilişimi işleri oluşturmak ve göndermek için VC Code kullanma adımlarını bulacaksınız.
Q# işlerini Azure Quantum'a gönderme
Azure Quantum'a Q# programı çalıştırmak, hata ayıklamak ve göndermek için VS Code'u kullanmayı öğrenin.
Önkoşullar
Yükleme ayrıntıları için bkz . VS Code'da Modern QDK'yi yükleme.
- Azure aboneliğinizdeki bir Azure Quantum çalışma alanı. Çalışma alanı oluşturmak için bkz. Azure Quantum çalışma alanı oluşturma.
- Visual Studio Code'nin en son sürümü veya Web'de VS Code'u açın.
- Azure Quantum Geliştirme Seti uzantısının en son sürümü.
Q# örnek programı yükleme
VS Code'da Dosya > Yeni Metin Dosyası'nı seçin ve dosyayı RandomNum.qs olarak kaydedin.
RandomNum.qs dosyasını açın ve yazın
sample
, ardından seçenekler listesinden Rastgele Bit örneği'ni seçin ve dosyayı kaydedin.
Not
Kendi Q# dosyanızı da açabilirsiniz. Eski bir Q# programı çalıştırıyorsanız ve hatayla karşılaşırsanız bkz . Test etme ve hata ayıklama veya Programlarınızı Modern QDK'ye geçirme.
Q# programı çalıştırma
Programınızı yerleşik simülatörde yerel olarak çalıştırmak için aşağıdaki
@EntryPoint()
komut listesinde Çalıştır'a tıklayın veya Ctrl+F5 tuşlarına basın. Çıkışınız hata ayıklama konsolunda görünür.Programınızı Azure Quantum'a göndermeden önce hata ayıklamak için aşağıdaki
@EntryPoint()
komut listesinden Hata Ayıkla'ya tıklayın veya F5 tuşuna basın. Kodun üzerine, içine ve dışına geçmek için üstteki hata ayıklama denetimlerini kullanın. Q# programlarının hatalarını ayıklama hakkında daha fazla bilgi için bkz . Test etme ve hata ayıklama.
Sıklık histogramını çizme
Sıklık histogramı, bir kuantum programını birden çok kez veya "çekimler" çalıştırarak elde edilen sonuçların dağılımını temsil eder. Histogramdaki her çubuk olası bir sonuca karşılık gelir ve yüksekliği sonucun kaç kez gözlemlendiğini gösterir. Sıklık histogramı bu sonuçların olasılık dağılımını görselleştirmeye yardımcı olur.
Görünüm -> Komut Paleti'ni seçin ve Q#: Dosyayı çalıştır ve histogramı göster seçeneğini gösteren "histogram" yazın. Histogram'a aşağıdaki
@EntryPoint()
komut listesinden de tıklayabilirsiniz. Q# histogram penceresini açmak için bu seçeneği belirleyin.Programı yürütmek için 100 çekim gibi bir dizi çekim girin ve Enter tuşuna basın. Histogram Q# histogram penceresinde görüntülenir.
Seçenekleri görüntülemek için sol üst ayarlar simgesine tıklayın.
Bu sonucun yüzdesini görüntülemek için bir çıtaya tıklayın. Bu durumda 0 ve 1 olmak üzere iki olası sonuç vardır ve her sonucun yüzdesi %50'ye yakındır.
İpucu
Fare kaydırma tekerleğini veya izleme yüzeyi hareketini kullanarak histogramı yakınlaştırabilirsiniz. Yakınlaştırdığınızda, kaydırma sırasında 'Alt' tuşuna basarak grafiği kaydırabilirsiniz.
Azure Quantum'a bağlanma ve işinizi gönderme
İşleri doğrudan VS Code'dan bağlamak ve göndermek için yerleşik Quantum Çalışma Alanlarını kullanın. Bu örnekte Rigetti simülatörüne bir iş göndereceksiniz.
Gezgin bölmesinde Kuantum Çalışma Alanları'nı genişletin.
Var olan bir çalışma alanını ekle'yi seçin ve tercih ettiğiniz dizine, aboneliğe ve çalışma alanına bağlanmak için istemleri izleyin.
Bağlandıktan sonra çalışma alanınızı genişletin ve Rigetti sağlayıcısını genişletin.
rigetti.sim.qvm öğesini seçintarget.
Geçerli Q# programını göndermeye başlamak için adın target sağındaki oynat simgesini seçin. Açılır pencere alırsanız QIR target profilini değiştir'i seçin ve devam edin.
İşi tanımlamak için bir ad ekleyin.
Çekim sayısını veya programın kaç kez çalıştırıldığını ekleyin.
İşi göndermek için Enter tuşuna basın. İş durumu ekranın en altında görüntülenir.
İşler'i genişletin ve işinizin üzerine gelin. Bu, işinizin saatlerini ve durumunu görüntüler.
Sonuçları görüntülemek için iş adının yanındaki bulut simgesini seçerek çalışma alanı depolama alanınızdan sonuçları indirin ve VS Code'da görüntüleyin.
Jupyter Notebooks işlerini Azure Quantum'a gönderme
Azure Quantum'a Q# Jupyter Notebook çalıştırmak, hatalarını ayıklamak ve göndermek için VS Code'u kullanmayı öğrenin. Bu makaledeki adımlar yerel Jupyter sunucunuzdaki Jupyter Not Defterleri veya Azure Quantum portalındaki not defterleri için de geçerlidir.
Önkoşullar
Yükleme ayrıntıları için bkz . VS Code'da Modern QDK'yi yükleme.
- Azure aboneliğinizdeki bir Azure Quantum çalışma alanı. Çalışma alanı oluşturmak için bkz. Azure Quantum çalışma alanı oluşturma.
- Python ve Pip'in yüklü olduğu bir Python ortamı.
- Azure Quantum Geliştirme Seti, Python ve Jupyter uzantılarının yüklü olduğu VS Code.
- Azure Quantum
qsharp
veazure-quantum
paketleri ileipykernel
paketi.
Programınızı yerel simülatörde çalıştırma ve test etme
VS Code'da Komut paleti Görüntüle'yi > ve ardından Oluştur: Yeni Jupyter Notebook'yi seçin.
Sağ üst kısımda VS Code, not defteri için seçilen Python sürümünü ve sanal Python ortamını algılar ve görüntüler. Birden çok Python ortamınız varsa, sağ üstteki çekirdek seçiciyi kullanarak bir çekirdek seçmeniz gerekebilir. Ortam algılanmadıysa kurulum bilgileri için VS Code'da Jupyter Notebooks bölümüne bakın.
Not defterinin ilk hücresinde komutunu çalıştırın
import qsharp import azure.quantum
- Modül,
qsharp
Q# kodunu doğrudan bir hücreye girmenizi sağlayan sihirli komutu etkinleştirir%%qsharp
. - Modül,
azure-quantum
Azure Quantum çalışma alanınıza bağlantı sağlar.
Not
Jupyter Python çekirdeği
ipykernel
algılanmazsa VS Code sizden bunu yüklemenizi ister.- Modül,
Başka bir hücre ekleyin ve kullanıcı tarafından belirtilen rastgele bit sayısını döndüren bu Q# kodunu girin:
%%qsharp operation Random() : Result { use q = Qubit(); H(q); let result = M(q); Reset(q); return result } operation RandomNBits(N: Int): Result[] { mutable results = []; for i in 0 .. N - 1 { let r = Random(); set results += [r]; } return results }
İşleminizi test etmek için yöntemini kullanabilirsiniz
eval
. Bu yöntem, not defterinde daha önce tanımlanmış herhangi bir Q# işlemini çağırabilir:qsharp.eval("RandomNBits(4)")
[Zero, One, One, Zero]
Programınızı yerel simülatörde çalıştırmak için yöntemini kullanın
run
.shots
Programı çalıştırmak için , veya sayısını belirtin ve simülatör sonuçları Python listesi olarak döndürür.qsharp.run("RandomNBits(4)", shots=10)
[[One, One, One, One], [Zero, Zero, One, Zero], [One, Zero, Zero, One], [Zero, One, Zero, Zero], [One, Zero, One, One], [One, Zero, One, Zero], [One, One, One, Zero], [One, One, One, One], [Zero, Zero, Zero, One], [One, Zero, Zero, One]]
Temel profili kullanarak işinizi derleme
Programları yerel kuantum simülatöründe çalıştırdığınızda, herhangi bir Q# programı türünü gönderebilirsiniz. Ancak Azure Quantum donanımı targets henüz tüm Q# programlarını çalıştırmak için gereken tüm özellikleri desteklememektedir. Q# programlarını derlemek ve Azure Quantum'a göndermek için, profilinizi target Q# 'ye donanımınızın target hangi özellikleri desteklediğini söyleyecek şekilde ayarlamanız gerekir. Şu anda bu, Temel profildir. Daha fazla bilgi için bkz. Azure Quantum'da profil türleri.
Q# yorumlayıcısını yeniden başlatıp programınızı temel profille derlemek için:
init
Profili ayarlamak için yöntemini kullanın:qsharp.init(target_profile=qsharp.TargetProfile.Base)
Yorumlayıcıyı yeniden başlatmış olduğunuzdan kodunuzu yeni profille yeniden çalıştırmanız gerekir:
%%qsharp operation Random() : Result { use q = Qubit(); H(q); let result = M(q); Reset(q); return result } operation RandomNBits(N: Int): Result[] { mutable results = []; for i in 0 .. N - 1 { let r = Random(); set results += [r]; } return results }
Ardından, programınıza giriş noktası olan işlemi veya işlevi belirtmek için yöntemini kullanın
compile
. Bu, kodunuzu QIR biçiminde derler ve daha sonra herhangi bir kuantum donanımına gönderilebilir:MyProgram = qsharp.compile("RandomNBits(4)")
Azure Quantum'a bağlanma ve işinizi gönderme
Programınızı doğru biçimde derlediğinize göre, Azure Quantum'a bağlanmak için bir azure.quantum.Workspace
nesne oluşturun. Bağlanmak için Azure Quantum çalışma alanınızın Kaynak Kimliğini kullanacaksınız. Kaynak Kimliği ve konum, Azure portal çalışma alanınıza genel bakış sayfasından kopyalanabilir.
Yeni bir hücrede Azure Quantum çalışma alanınızdan kaynak kimliğinizi ve konumunuzu doldurun:
MyWorkspace = azure.quantum.Workspace( resource_id = "MyResourceID", location = "MyLocation" )
get_targets
Çalışma alanınızdaki kullanılabilir donanımı targets görmek için yöntemini kullanın:MyTargets = MyWorkspace.get_targets() print("This workspace's targets:") MyTargets
rigetti.sim.qvm
targetöğesini seçin:MyTarget = MyWorkspace.get_targets("rigetti.sim.qvm")
Son olarak, programınızı parametreleriyle göndermek ve sonuçları görüntülemek için yöntemini kullanın
submit
:job = MyTarget.submit(MyProgram, "MyQuantumJob", shots=100) job.get_results()
{'Histogram': ['[0, 0, 0, 0]', 0.3, '[1, 0, 0, 0]', 0.1, '[1, 1, 1, 1]', 0.3, '[0, 1, 1, 1]', 0.3]}
İşin tüm özelliklerine uygulamasından
job.details
erişilebilir, örneğin:print(job.details) print("\nJob name:", job.details.name) print("Job status:", job.details.status) print("Job ID:", job.details.id)
{'additional_properties': {'isCancelling': False}, 'id': '0150202e-9638-11ee-be2f-b16153380354', 'name': 'MyQuantumJob', 'provider_id': 'rigetti'...} Job name: MyQuantumJob Job status: Succeeded Job ID: 0150202e-9638-11ee-be2f-b16153380354
Q# işleriyle Python'ı Azure Quantum'a gönderme
Q# işlemlerini çağıran bir Python programı yazmak, Python komutlarını veya Azure CLI'yı kullanarak Azure'a bağlanmak ve işinizi göndermek için VS Code kullanmayı öğrenin.
Önkoşullar
Yükleme ayrıntıları için bkz . VS Code'da Modern QDK'yi yükleme.
- Azure aboneliğinizdeki bir Azure Quantum çalışma alanı. Çalışma alanı oluşturmak için bkz. Azure Quantum çalışma alanı oluşturma.
- Python ve Pip'in yüklü olduğu bir Python ortamı.
- Azure Quantum Geliştirme Seti ve Python uzantısının yüklü olduğu VS Code.
- Azure Quantum
qsharp
veazure-quantum
paketleri. - En son Azure Quantum uzantısının yüklü olduğu Azure CLI.
Q# işlemlerinizi oluşturma ve içeri aktarma
Paketi kullanarak qsharp
işlevlerinizi ve işlemlerinizi Q# dosyalarında depolayabilir ve Python kodunuzdan herhangi birine çağrıda bulunmanıza olanak sağlayan Q# projeleri oluşturabilirsiniz. Bu özellikle giriş parametrelerini alan bir program başlatmanız gerektiğinde yararlıdır.
Q# projesi oluşturmak için adımları izleyin.
Yeni bir metin dosyası açın, kullanıcı tarafından belirtilen sayıda rastgele bit döndüren aşağıdaki Q# kodunu ekleyin ve dosyayı projenize olarak
source.qs
kaydedin.Not
Bu Q# kodunun Q# programı gibi bir
@EntryPoint
işlevi olmadığını unutmayın (bkz. Azure Quantum'a Q# işleri gönderme), ancak Jupyter Notebook farklı olarak bir ad alanı gerektirir (bkz. Jupyter Notebook işleri Azure Quantum'a gönderme).namespace Sample { operation Random() : Result { use q = Qubit(); H(q); let result = M(q); Reset(q); return result } operation RandomNBits(N: Int): Result[] { mutable results = []; for i in 0 .. N - 1 { let r = Random(); set results += [r]; } return results } }
Aynı klasörde başka bir dosya açın ve olarak
randomNum.py
kaydedin.ve
azure.quantum
modüllerini içeri aktarmakqsharp
için aşağıdaki kodu ekleyin.import qsharp import azure.quantum
Ardından, Q# projesi kök klasörünü tanımlamak için kod ekleyin ve işlemi yerel simülatörde test target edin. İşlem ad alanı> tarafından< çağrılır.<operation_name( )> ve bu durumda, döndürülecek rastgele bit sayısını geçiriyorsunuz.
qsharp.init(project_root = '/MyProjectRootFolder') print(qsharp.eval("Sample.RandomNBits(4)"))
[Zero, One, One, Zero]
Ayrıca ek bir
shots
parametre geçiren ve sonuçları python listesinde döndüren yöntemiylerun
işlemi test edebilirsiniz. içinderandomNum.py
, önceki print deyimini aşağıdakilerle değiştirin:result = qsharp.run("Sample.RandomNBits(4)", shots=10) for x in result: print(x)
[[One, One, One, One], [Zero, Zero, One, Zero], [One, Zero, Zero, One], [Zero, One, Zero, Zero], [One, Zero, One, One], [One, Zero, One, Zero], [One, One, One, Zero], [One, One, One, One], [Zero, Zero, Zero, One], [One, Zero, Zero, One]]
Temel profili kullanarak işinizi derleme
Programları yerel kuantum simülatöründe çalıştırdığınızda, herhangi bir Q# programı türünü gönderebilirsiniz. Ancak Azure Quantum donanımı targets henüz tüm Q# programlarını çalıştırmak için gereken tüm özellikleri desteklememektedir. Q# programlarını derlemek ve Azure Quantum'a göndermek için, profilinizi Q# öğesine donanımınızın targettarget hangi özellikleri desteklediğini söyleyecek şekilde ayarlamanız gerekir. Şu anda bu, Temel profildir. Daha fazla bilgi için bkz. Azure Quantum'da profil türleri.
Not
Yalnızca VS Code'daki Q# programları için VS Code, Temel profili otomatik olarak ayarlar.
init
Profili ayarlamak için yöntemini kullanın:qsharp.init(target_profile=qsharp.TargetProfile.Base)
Ardından, programınızın giriş noktası olan işlemi veya işlevi belirtmek için yöntemini kullanın
compile
. Derlenen program daha sonra herhangi bir kuantum donanımına gönderilebilir:MyProgram = qsharp.compile("Sample.RandomNBits(4)")
Azure Quantum'a bağlanma ve işinizi gönderme
Azure Quantum'a bağlanıp Python tarafından oluşturulan Workspace
bir nesne kullanarak işinizi gönderebilir veya Azure CLI kullanarak bağlanıp işinizi gönderebilirsiniz. Azure CLI'yı kullanmak için derlenmiş programı bir metin dosyası olarak kaydetmeniz ve cli komutu kullanarak bu dosyayı göndermeniz gerekir.
Programınızı doğru biçimde derlediğinize göre, Azure Quantum'a bağlanmak için bir azure.quantum.Workspace
nesne oluşturun. Bağlanmak için Azure Quantum çalışma alanınızın Kaynak Kimliğini kullanacaksınız. Kaynak Kimliği ve konum, Azure portal çalışma alanınıza genel bakış sayfasından kopyalanabilir.
Azure Quantum çalışma alanınızdan kaynak kimliğinizi ve konumunuzu doldurarak öğesine aşağıdaki kodu
randomNum.py
ekleyin:workspace = azure.quantum.Workspace( resource_id = "MyResourceID", location = "MyLocation" )
get_targets
Çalışma alanınızda kullanılabilir donanımı targets görüntülemek için yöntemini kullanın:MyTargets = workspace.get_targets() print("This workspace's targets:") for x in MyTargets: print(x)
rigetti.sim.qvm
targetöğesini seçin:MyTarget = workspace.get_targets("rigetti.sim.qvm")
Son olarak, programınızı parametreleriyle göndermek için yöntemini kullanın
submit
. İş sonuçları Python sözlüğü olarak döndürülür.job = MyTarget.submit(MyProgram, "MyPythonJob", shots=100) results = job.get_results() print("\nResults: ", results)
Yalnızca değerleri ayıklamak ve görüntülemek için:
resultList = results.get("Histogram") for x in resultList: print(x)
[0, 0, 0, 0] 0.3 [1, 0, 0, 0] 0.1 [1, 1, 1, 1] 0.3 [0, 1, 1, 1] 0.3
İşin tüm özelliklerine uygulamasından
job.details
erişilebilir, örneğin:print(job.details) print("\nJob name:", job.details.name) print("Job status:", job.details.status) print("Job ID:", job.details.id)
{'additional_properties': {'isCancelling': False}, 'id': '0fc396d2-97dd-11ee-9958-6ca1004ff31f', 'name': 'MyPythonJob', 'provider_id': 'rigetti'...} Job name: MyPythonJob Job status: Succeeded Job ID: fc396d2-97dd-11ee-9958-6ca1004ff31f
Sonraki adımlar
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin