{"id":13524938,"url":"https://github.com/Leedehai/typst-physics","last_synced_at":"2025-04-01T04:30:26.552Z","repository":{"id":149314848,"uuid":"618919303","full_name":"Leedehai/typst-physics","owner":"Leedehai","description":"physica: vectors, fields, differentials, derivatives, Dirac brakets, tensors, and more. See examples in the manual PDF.","archived":false,"fork":false,"pushed_at":"2024-11-01T20:01:16.000Z","size":6889,"stargazers_count":341,"open_issues_count":6,"forks_count":11,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-01T20:29:02.719Z","etag":null,"topics":["typst","typst-package"],"latest_commit_sha":null,"homepage":"https://github.com/Leedehai/typst-physics","language":"Typst","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Leedehai.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2023-03-25T18:19:38.000Z","updated_at":"2024-11-01T20:01:20.000Z","dependencies_parsed_at":"2023-10-04T14:40:14.530Z","dependency_job_id":"f0b885e5-db31-4c59-b526-58187c74c310","html_url":"https://github.com/Leedehai/typst-physics","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leedehai%2Ftypst-physics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leedehai%2Ftypst-physics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leedehai%2Ftypst-physics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leedehai%2Ftypst-physics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Leedehai","download_url":"https://codeload.github.com/Leedehai/typst-physics/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222698190,"owners_count":17024877,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["typst","typst-package"],"created_at":"2024-08-01T06:01:14.765Z","updated_at":"2025-04-01T04:30:26.538Z","avatar_url":"https://github.com/Leedehai.png","language":"Typst","funding_links":[],"categories":["Templates \u0026 Libraries","Typst","库和工具类"],"sub_categories":["Physics","物理 化学 电学"],"readme":":green_book: The [manual](https://github.com/Leedehai/typst-physics/blob/v0.9.5/physica-manual.pdf).\n\u003cp align=\"center\"\u003e\n\u003cimg width=\"545\" alt=\"logo\" src=\"https://github.com/Leedehai/typst-physics/assets/18319900/ed86198a-8ddb-4473-aed3-8111d5ecde60\"\u003e\n\u003c/p\u003e\n\n# The physica package for Typst (v0.9.5)\n\n[![CI](https://github.com/Leedehai/typst-physics/actions/workflows/ci.yml/badge.svg)](https://github.com/Leedehai/typst-physics/actions/workflows/ci.yml)\n[![Latest release](https://img.shields.io/github/v/release/Leedehai/typst-physics.svg?color=gold)][latest-release]\n\nAvailable in the collection of [Typst packages](https://typst.app/docs/packages/): `#import \"@preview/physica:0.9.5\": *`\n\n\u003e physica _noun_.\n\u003e * Latin, study of nature\n\nThis [Typst](https://typst.app) package provides handy typesetting utilities for\nnatural sciences, including:\n* Braces,\n* Vectors and vector fields,\n* Matrices, including Jacobian and Hessian,\n* Smartly render `..^T` as transpose and `..^+` as dagger (conjugate transpose),\n* Dirac braket notations,\n* Common math functions,\n* Differentials and derivatives, including partial derivatives of mixed orders with automatic order summation,\n* Familiar \"h-bar\", tensor abstract index notations, isotopes, Taylor series term,\n* Signal sequences i.e. digital timing diagrams.\n\n## A quick look\n\nSee the [manual](https://github.com/Leedehai/typst-physics/blob/v0.9.5/physica-manual.pdf) for more details and examples.\n\n![demo-quick](https://github.com/Leedehai/typst-physics/assets/18319900/4a9f40df-f753-4324-8114-c682d270e9c7)\n\nA larger [demo.typ](https://github.com/Leedehai/typst-physics/blob/master/demo.typ):\n\n![demo-larger](https://github.com/Leedehai/typst-physics/assets/18319900/75b94ef8-cc98-434f-be5f-bfac1ef6aef9)\n\n## Using physica in your Typst document\n\n### With `typst` package management (recommended)\n\nSee https://github.com/typst/packages. If you are using the Typst's web app,\npackages listed there are readily available; if you are using the Typst\ncompiler locally, it downloads packages on-demand and caches them on-disk, see\n[here](https://github.com/typst/packages#downloads) for details.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/Leedehai/typst-physics/assets/18319900/f2a3a2bd-3ef7-4383-ab92-9a71affb4e12\" width=\"173\" alt=\"effect\"\u003e\n\u003c/p\u003e\n\n```typst\n// Style 1\n#import \"@preview/physica:0.9.5\": *\n\n$ curl (grad f), tensor(T, -mu, +nu), pdv(f,x,y,[1,2]) $\n```\n\n```typst\n// Style 2\n#import \"@preview/physica:0.9.5\": curl, grad, tensor, pdv\n\n$ curl (grad f), tensor(T, -mu, +nu), pdv(f,x,y,[1,2]) $\n```\n\n```typst\n// Style 3\n#import \"@preview/physica:0.9.5\"\n\n$ physica.curl (physica.grad f), physica.tensor(T, -mu, +nu), physica.pdv(f,x,y,[1,2]) $\n```\n\n### Without `typst` package management\n\nSimilar to examples above, but import with the undecorated file path like `\"physica.typ\"`.\n\n## Typst version\n\nThe version requirement for the compiler is in [typst.toml](typst.toml)'s\n`compiler` field. If you are using an unsupported Typst version, the compiler\nwill throw an error. You may want to update your compiler with `typst update`,\nor choose an earlier version of the `physica` package.\n\nDeveloped with compiler version:\n\n```sh\n$ typst --version\ntypst 0.13.0 (8dce676d)\n```\n\n## Manual\n\nSee the [manual](https://github.com/Leedehai/typst-physics/blob/v0.9.5/physica-manual.pdf) for a more comprehensive coverage, a PDF file\ngenerated directly with the [Typst](https://typst.app) binary.\n\nTo regenerate the manual, use command\n\n```sh\ntypst watch physica-manual.typ\n```\n\n## Contribution\n\n* Bug fixes are welcome!\n\n* New features: welcome as well. If it is small, feel free to create a pull\nrequest. If it is large, the best first step is creating an issue and let us\nexplore the design together. Some features might warrant a package on its own.\n\n* Testing: currently testing is done by closely inspecting the generated\n[manual](https://github.com/Leedehai/typst-physics/blob/v0.9.5/physica-manual.pdf).\nThis does not scale well. I plan to add programmatic testing by comparing\nrendered pictures with golden images.\n\n## Change log\n\n[changelog.md](https://github.com/Leedehai/typst-physics/blob/v0.9.5/changelog.md).\n\n## License\n\n* Code: the [MIT License](LICENSE.txt).\n* Docs: the [Creative Commons BY-ND 4.0 license](https://creativecommons.org/licenses/by-nd/4.0/).\n\n[latest-release]: https://github.com/Leedehai/typst-physics/releases/latest \"The latest release\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLeedehai%2Ftypst-physics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLeedehai%2Ftypst-physics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLeedehai%2Ftypst-physics/lists"}