---
sd_hide_title: true
hide-toc: true
---

# はじめに

```{image} ../_static/amplify-logo.svg
:alt: Fixstars Amplify
:class: only-light amplify-logo
:align: center
:target: https://amplify.fixstars.com/
```
```{image} ../_static/amplify-logo-dark.svg
:alt: Fixstars Amplify
:class: only-dark amplify-logo
:align: center
:target: https://amplify.fixstars.com/
```

[![Fixstars Amplify](https://img.shields.io/badge/-Fixstars%20Amplify-333333.svg?logo=data:image/png;base64,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&style=popout-square)](https://amplify.fixstars.com/) [![PyPI](https://img.shields.io/pypi/v/amplify)](https://pypi.org/project/amplify/) [![Downloads](https://static.pepy.tech/personalized-badge/amplify?period=total&units=international_system&left_color=grey&right_color=orange&left_text=Downloads)](https://pepy.tech/project/amplify)

*Fixstars Amplify SDK* (以下 Amplify SDK) は、 組合せ最適化問題の定式化および外部の最適化ソルバーの実行を行うための Python ライブラリです。

Amplify SDK を用いることにより、組合せ最適化問題の定式化をシンプルかつ直感的に行うことができます。
また、定式化を行ったあとは、[量子アニーリングマシン](https://en.wikipedia.org/wiki/Quantum_annealing)、イジングマシン、量子コンピュータによる [QAOA](https://en.wikipedia.org/wiki/Quantum_optimization_algorithms) (Quantum Approximate Optimization Algorithm)、MIPソルバーを含むさまざまなハードウェア・ソフトウェアソルバーを共通のインターフェースを通じて簡単に実行することができるようになります。

---

```{rubric} Amplify SDK の特長
```

`````{grid} 1 2 2 2
:gutter: 5 5 5 5
````{grid-item-card}  🔰 直感的で使いやすい
:link: easy-to-use
:link-type: ref
Amplify SDK の使い方はとても簡単です。シンプルで直感的な手順で組合せ最適化問題の定式化とソルバーの実行が行えます。
インストール不要で利用出来るソルバー [Amplify Annealing Engine](https://amplify.fixstars.com/engine) も無償で提供されます。
+++
```{div} sd-text-right
[Learn more »](#easy-to-use)
```
````
````{grid-item-card}  🚅 高速な数式処理
:link: blazing-fast
:link-type: ref
Amplify SDK による定式化は非常に高速かつ省メモリで処理するように設計されています。
大規模な組合せ最適化問題を視野に入れたアプリケーションの開発が行えます。
+++
```{div} sd-text-right
[Learn more »](#blazing-fast)
```
````
````{grid-item-card} 🔱️ 複数のソルバーに対応
:link: multiple-solvers
:link-type: ref
Amplify SDK から利用出来るソルバーは、量子アニーリングマシン、イジングマシン、量子コンピュータ、MIP ソルバーなど多岐に渡ります。
ユースケースに合わせたソルバーの選択が可能です。
+++
```{div} sd-text-right
[Learn more »](#multiple-solvers)
```
````
````{grid-item-card}  🧑‍💻️ 幅広い対象ユーザ
:link: wide-range-users
:link-type: ref
Amplify は組合せ最適化に取り組む幅広いユーザに利用頂けます。アプリケーションソフトウェア開発から学術研究まで、様々なユーザ層を支援できるように設計されています。
+++
```{div} sd-text-right
[Learn more »](#wide-range-users)
```
````
`````

```{admonition} Changed in version 1.0.0
:class: seealso
*Fixstars Amplify SDK* はバージョン 1.0.0 で大きく生まれ変わり、これまで以上に直感的で使いやすく、対象のモデルを広げ、高い柔軟性と高速な動作の両立を実現しました。以前のバージョンからの移行ガイドは [](migration.md) を参照してください。また、移行がスムーズに行えるように旧バージョンとの互換レイヤも用意しています。  
以前のバージョンのドキュメントは <https://amplify.fixstars.com/ja/docs/amplify/v0/> で参照できます。
```

---

```{rubric} Amplify のはじめ方
```

`````{grid} 1 1 1 3
````{grid-item-card}  🆔 STEP 1
```{button-link} https://amplify.fixstars.com/register
:color: primary
:click-parent:
:expand:
**ユーザ登録**
```
ユーザ登録を行うと [Amplify Annealing Engine](https://amplify.fixstars.com/engine) の API トークンを無償で入手できます。
````
````{grid-item-card}  🛠️ STEP 2
```{button-ref} quickstart
:ref-type: doc
:color: success
:click-parent:
:expand:
**インストール**
```
Amplify SDK は Windows / Linux / MacOS 環境で pip コマンドを利用してインストールできます。
````
````{grid-item-card}  🔍 STEP 3
```{button-link} https://amplify.fixstars.com/demo
:color: info
:click-parent:
:expand:
**デモ&チュートリアル**
```
Amplify の使い方を学ぶためのデモやチュートリアルを用意しています。
````
`````

```{note}
*Fixstars Amplify SDK* はプロプライエタリソフトウェアです。  
非商用利用や学術利用では無償で利用することができます。詳細は [Fixstars Amplify 利用規約](https://amplify.fixstars.com/termsofuse)を参照してください。
```

```{toctree}
:caption: 🚀 Get Started
:hidden:
self
features.md
quickstart.md
```

```{toctree}
:caption: 🌱 Basic
:numbered:
:hidden:
overview.md
variables.md
objective.md
constraint.md
model.md
clients.md
solve.md
```

```{toctree}
:caption: 🌻 Advanced
:hidden:
conversion.md
evaluation.md
timing.md
solvers.md
serial.md
parallel.md
matrix.md
optimization.md
```

```{toctree}
:caption: 🧩 ️Examples
:hidden:
subset_sum.ipynb
tsp.ipynb
qap.ipynb
```

```{toctree}
:caption: 💡 Tips
:hidden:
type_hint.md
proxy.md
pprint.md
migration.md
benchmark.md
```

```{toctree}
:caption: 📖 Reference
:hidden:
changelog.md
reference/index.rst
genindex
```