{"id":28165,"library":"samplomatic","title":"Samplomatic","description":"A Qiskit-based library for circuit sampling and noise characterization. It provides tools for building samplex circuits, transpilation passes (boxing, twirling, noise injection), and serialization. Current version: 0.18.0, requires Python >=3.10. Release cadence is approximately biweekly.","status":"active","version":"0.18.0","language":"python","source_language":"en","source_url":"https://github.com/Qiskit/samplomatic","tags":["circuit-sampling","noise","qiskit","quantum"],"install":[{"cmd":"pip install samplomatic","lang":"bash","label":"default"}],"dependencies":[{"reason":"Core dependency for quantum circuit operations","package":"qiskit","optional":false}],"imports":[{"wrong":"from samplomatic import Samplex","symbol":"Samplex","correct":"from samplomatic import samplex"}],"quickstart":{"code":"from samplomatic import Samplex, build\nfrom qiskit.circuit import QuantumCircuit, Parameter\n\nqc = QuantumCircuit(2)\ntheta = Parameter('theta')\nqc.rz(theta, 0)\nqc.cx(0, 1)\nqc.measure_all()\n\nsamplex = Samplex(qc, {theta: 0.5})\n\nwith build(samplex) as bld:\n    bld.add_gate(\"easy\", qc)\n    bld.add_gate(\"hard\", qc)\n\nresults = samplex.sample(shots=1000)\nprint(results)","lang":"python","description":"Basic example: define a quantum circuit, create a Samplex, build a template, and sample."},"warnings":[{"fix":"Update code that expects `parameter_values` to always be present in the output.","message":"In v0.13.0, `build` always returns `parameter_values` with shape (num_randomizations, 0) if no parameter values are generated. Previously it was omitted.","severity":"breaking","affected_versions":">=0.13.0"},{"fix":"Upgrade to Python >=3.10.","message":"Python 3.9 support removed in v0.14.0.","severity":"breaking","affected_versions":">=0.14.0"},{"fix":"Replace `GroupLiteral` with `GroupMode` and update imports accordingly.","message":"`TWIRLING_GROUPS` and `GroupLiteral` removed in v0.17.0. Use `GroupMode` instead.","severity":"deprecated","affected_versions":">=0.17.0"},{"fix":"Ensure serialized data is deserialized with the same SSV or compatible version.","message":"Serialization version (SSV) is decoupled from package version (since v0.12.0). Backward compatibility is not guaranteed across SSV changes.","severity":"gotcha","affected_versions":">=0.12.0"}],"env_vars":null,"search_vec":"'0.18.0':30 '3.10':33 'approxim':37 'base':5 'biweek':38 'box':22 'build':17 'cadenc':35 'character':12 'circuit':8,19,40 'circuit-sampl':39 'current':28 'inject':25 'librari':6 'nois':11,24,42 'pass':21 'provid':14 'python':32 'qiskit':4,43 'qiskit-bas':3 'quantum':44 'releas':34 'requir':31 'sampl':9,41 'samplex':18 'samplomat':1 'serial':27 'tool':15 'transpil':20 'twirl':23 'version':29","created_at":"2026-05-09T05:54:04.219197+00:00","updated_at":"2026-05-09T05:54:04.219197+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/Qiskit/samplomatic","docs":null,"changelog":null,"pypi":"https://pypi.org/project/samplomatic/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}