{"id":48072881,"url":"https://github.com/joselado/quantum-lattice","last_synced_at":"2026-04-04T14:46:32.410Z","repository":{"id":131582525,"uuid":"390243861","full_name":"joselado/quantum-lattice","owner":"joselado","description":"User-friendly open-source software to design and solve tight-binding models, addressing electronic properties, topology, interactions, non-collinear magnetism, and unconventional superconductivity, among others.","archived":false,"fork":false,"pushed_at":"2026-03-23T07:38:36.000Z","size":15124,"stargazers_count":69,"open_issues_count":0,"forks_count":12,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-03-24T04:54:51.895Z","etag":null,"topics":["interactions","mean-field-theory","spin-orbit-coupling","superconductivity","tight-binding","topological-insulator","topology","user-interface"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joselado.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-07-28T06:44:39.000Z","updated_at":"2026-03-23T07:38:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"f12f5f16-9137-482d-8e2f-342d7a4d68e5","html_url":"https://github.com/joselado/quantum-lattice","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/joselado/quantum-lattice","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joselado%2Fquantum-lattice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joselado%2Fquantum-lattice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joselado%2Fquantum-lattice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joselado%2Fquantum-lattice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joselado","download_url":"https://codeload.github.com/joselado/quantum-lattice/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joselado%2Fquantum-lattice/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31403607,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["interactions","mean-field-theory","spin-orbit-coupling","superconductivity","tight-binding","topological-insulator","topology","user-interface"],"created_at":"2026-04-04T14:46:31.833Z","updated_at":"2026-04-04T14:46:32.395Z","avatar_url":"https://github.com/joselado.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## QUANTUM LATTICE ##\n\n# Summary #\n\nThis program allows to perform tight binding calculations with a user friendly interface in a variety of lattices and dimensionalities.\n\n![Alt text](screenshots/quantum_lattice.png?raw=true \"Quantum Lattice System selection\")\n\n# Video examples #\n\n[Here](https://youtu.be/g2YAE9Kpd9c) \nyou can see four simultaneous examples of the\nusage of Quantum Lattice.\n\nBelow you can see videos showing the real-time usage of this program for\nindividual examples\n- [Confined modes in graphene nanoislands](https://youtu.be/YFIpONVQinc)\n- [Superlattices](https://youtu.be/cPx2tOFxdyI)\n- [Interaction-induced magnetism](https://youtu.be/RrPWVqJ7VS4)\n- [Artificial Chern insulators](https://youtu.be/zEwywwQprNY)\n- [Landau levels and quantum Hall edge states](https://youtu.be/aI-2rMdZ8iY)\n- [Twisted bilayer graphene](https://youtu.be/OHlLOLKAfVs)\n\n# How to install #\n\n## Linux and Mac ##\n\nThe program runs in Linux and Mac machines. \n\nClone the GitHub repository\n```bash\ngit clone https://github.com/joselado/quantum-lattice\n```\n\nand execute the script install as\n```bash\npython install.py\n```\n\nThe script will install all the required dependencies if they are not already\npresent for the python command used. Afterwards, you can run the program by \nexecuting in a terminal\n\n```bash\nquantum-lattice\n```\n\nYou can see [here](https://youtu.be/4H1mNLYdUOU) a short video demonstrating the installation.\n\n## Windows ##\n\nFor using this program in Windows, the easiest solution is to create a virtual\nmachine using [Virtual Box](https://www.virtualbox.org/), installing\na version of [Ubuntu](https://releases.ubuntu.com/20.04/) \nin that virtual machine, and following the previous\ninstructions. \n\n# FUNCTIONALITIES #\n## Single particle Hamiltonians ##\n- Spinless, spinful and Nambu basis for orbitals\n- Full non-collinear electron and Nambu formalism\n- Include magnetism, spin-orbit coupling and superconductivity\n- Band structures with state-resolved expectation values\n- Momentum-resolved spectral functions\n- Local and full operator-resolved density of states\n- 0d, 1d, 2d and 3d tight binding models\n\n## Interacting mean-field Hamiltonians ##\n- Selfconsistent mean-field calculations with local/non-local interactions\n- Both collinear and non-collinear formalism\n- Anomalous mean-field for non-collinear superconductors\n- Full selfconsistency with all Wick terms for non-collinear superconductors\n- Automatic identification of order parameters for symmetry broken states\n\n## Topological characterization ##\n- Berry phases, Berry curvatures, Chern numbers and Z2 invariants\n- Operator-resolved Chern numbers and Berry density\n\n## Spectral functions ##\n- Surface spectral functions for semi-infinite systems\n- Single impurities in infinite systems\n- Operator-resolved spectral functions\n\n## Chebyshev kernel polynomial based-algorithms ##\n- Local and full spectral functions\n- Operator resolved spectral functions\n- Reaching system sizes up to 1000000 atoms on a single-core laptop\n\nQuantum Lattice uses [pyqula](https://github.com/joselado/pyqula).\n\n# Screenshot examples #\n\n## Unconventional superconductivity ##\nElectronic band structure, Berry curvature and momentum resolved surface\nspectral function of a px + ipy spin-triplet topological\nsuperconductor with d-vector (0,0,1).\n![Alt text](screenshots/chiral_superconductor.png?raw=true \"Spin-triplet chiral topological superconductor\")\n\n## Interaction-driven non-collinear magnetism ##\nElectronic band structure and selfconsistent local magnetization\nof a square lattice with an applied Zeeman field\nand local Hubbard interactions.\n![Alt text](screenshots/non_collinear_scf.png?raw=true \"Non-collinear magnetization with Hubbard interactions and Zeeman field\")\n\n\n## Superlattices ##\nElectronic band structure, Fermi surface and local density of states\nof a superlattice built from a defective triangular lattice\n![Alt text](screenshots/2d_superlattice.png?raw=true \"Triangular superlattice\")\n\n\n## Scanning tunnel spectroscopy of nanographene islands ##\nReal space simulation of the STS spectra, using atomic-like orbitals\nfor a nanographene island\n![Alt text](screenshots/nanographene.png?raw=true \"STS nanographene\")\n\n\n\n## Kagome lattice with first and second neighbor hopping ##\nFermi surface and band structure of a two-dimensional lattice,\nincluding both first and second neighbor hoppings. In the absence\nof second neighbor hopping, the lowest band is flat. Only first\nneighbor hoppings are shown in the 3D structure plot.\n![Alt text](screenshots/kagome_lattice_second.png?raw=true \"Kagome lattice with NN and NNN hopping\")\n\n## Interaction-induced symmetry breaking in the Lieb lattice ##\nNon-interacting and interacting band structure of a two-dimensional\nLieb lattice. When repulsive \nlocal Hubbard interactions are included, an spontaneously\nferromagnetic state appears in the system, leading to a real-space\nmagnetic distribution.\n![Alt text](screenshots/lieb_scf.png?raw=true \"Interacting Lieb lattice\")\n\n\n## Artificial Chern insulators ##\nKagome lattice with Rashba spin-orbit coupling and exchange field, giving rise to a net Chern number and chiral edge states\n![Alt text](screenshots/qah.png?raw=true \"QAH state in the Kagome lattice\")\n\n\n## Two-dimensional quantum Spin Hall state ##\nHoneycomb lattice with Kane-Mele spin-orbit coupling and Rashba spin-orbit coupling, giving rise to a gapped spectra with a non-trivial Z2 invariant and helical edge states https://journals.aps.org/prl/abstract/10.1103/PhysRevLett.95.226801\n![Alt text](screenshots/qsh.png?raw=true \"QSH state\")\n\n## Magnetism in graphene zigzag nanoribbons ##\nSelf-consistent mean field calculation of a zigzag graphene ribbon, with electronic interactions included as a mean field Hubbard model. Interactions give rise to an edge magnetization in the ribbon, with an antiferromagnetic alignment between edges\n![Alt text](screenshots/zzscf.png?raw=true \"Magnetism in zigzag nanoribbons\")\n\n\n## Three-dimensional quantum spin Hall insulators ##\nThree-dimensional quantum spin-Hall insulator, engineered by intrinsic\nspin-orbit coupling in the diamond lattice. the top and bottom of the\nslab show an emergent helical electron gas.\n![Alt text](screenshots/3D_QSL.png?raw=true \"3D QSH state\")\n\n\n## Scanning tunnel spectroscopy of graphene nanoribbons ##\nReal space simulation of the STS spectra, using atomic-like orbitals\nfor a graphene nanoribbon \n![Alt text](screenshots/sts_nanoribbon.png?raw=true \"STS graphene nanoribbon\")\n\n\n\n## Nodal line semimetals ##\nBand structure of a slab of a 3D nodal line semimetal in a diamond lattice, showing the emergence of topological zero energy drumhead states in the surface of the slab https://link.springer.com/article/10.1007%2Fs10909-017-1846-3\n![Alt text](screenshots/nodalline.png?raw=true \"Magnetism in zigzag nanoribbons\")\n\n\n## Confined modes in quantum dots ##\nSpectra and spatially resolved density of states of square quantum dot, showing the emergence of confined modes\n![Alt text](screenshots/island.png?raw=true \"Confined modes in square quantum dot\")\n\n\n## Colossal quantum dots ##\nDensity of states and spatially resolved density of states of a big graphene quantum dot. The huge islands module uses special techniques to efficiently solve systems with hundreds of thousands of atoms.\n![Alt text](screenshots/giant_island.png?raw=true \"Big graphene island\")\n\n\n\n## Landau levels ##\nElectronic spectra of a graphene lattice in the presence of an off-plane magnetic field and antiferromagnetic order, giving rise to Landau levels and chiral edge states\n![Alt text](screenshots/honeycomb_qh.png?raw=true \"Landau levels in an antiferromagnetic graphene ribbon\")\n\n\n## Artificial topological superconductors ##\nBogoliuvov de Gennes band structure of a two-dimensional gas in a square lattice with Rashba spin-orbit coupling, off-plane exchange field and s-wave superconducting proximity effect. When superconductivity is turned on, a gap opens up in the spectra hosting a non-trivial Chern number, giving rise to propagating Majorana modes in the system\n![Alt text](screenshots/topologicalSC.png?raw=true \"Artificial topological superconductor in a square lattice\")\n\n\n## Quantum Valley Hall effect ##\nBand structure of Bernal stacked bilayer graphene, showing the emergence of a gap when an interlayer bias is applied. The previous gap hosts a non-trivial valley Chern number, giving rise to the emergence of pseudo-helical states in the edge of the system\n![Alt text](screenshots/qvh.png?raw=true \"Quantum valley Hall state in biased bilayer AB graphene\")\n\n\n## Twisted bilayer graphene ##\nBandstructure and Fermi surface of a twisted graphene bilayer, showing the emergence of nearly flat bands\nhttps://journals.aps.org/prb/abstract/10.1103/PhysRevB.82.121407\n![Alt text](screenshots/tbg.png?raw=true \"Magic angle twisted bilayer graphene\")\n\n\n## Twisted trilayer graphene ##\nStructure and band structure of a twisted graphene trilayer at the magic angle.\n![Alt text](screenshots/TTG.png?raw=true \"Twisted trilayer graphene\")\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoselado%2Fquantum-lattice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoselado%2Fquantum-lattice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoselado%2Fquantum-lattice/lists"}