{"id":26445163,"url":"https://github.com/rodrigopcastro018/nodimo","last_synced_at":"2025-03-18T11:15:24.104Z","repository":{"id":224449101,"uuid":"761469347","full_name":"rodrigopcastro018/nodimo","owner":"rodrigopcastro018","description":"Nodimo generalizes a dimensional relationship between quantities by turning it into a dimensionless expression.","archived":false,"fork":false,"pushed_at":"2024-08-19T01:55:38.000Z","size":24570,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-17T04:05:20.030Z","etag":null,"topics":["dimensional-analysis","engineering","jupyter-notebook","physics","python"],"latest_commit_sha":null,"homepage":"https://nodimo.readthedocs.io/","language":"Python","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/rodrigopcastro018.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.rst","funding":null,"license":"LICENSE","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":"2024-02-21T22:17:30.000Z","updated_at":"2024-08-19T01:55:41.000Z","dependencies_parsed_at":"2024-04-01T05:29:51.817Z","dependency_job_id":"b642115c-7c41-4fe7-8065-f546456e46ce","html_url":"https://github.com/rodrigopcastro018/nodimo","commit_stats":null,"previous_names":["rodrigopcastro018/nodimo"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodrigopcastro018%2Fnodimo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodrigopcastro018%2Fnodimo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodrigopcastro018%2Fnodimo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodrigopcastro018%2Fnodimo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rodrigopcastro018","download_url":"https://codeload.github.com/rodrigopcastro018/nodimo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244066189,"owners_count":20392407,"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":["dimensional-analysis","engineering","jupyter-notebook","physics","python"],"created_at":"2025-03-18T11:15:23.492Z","updated_at":"2025-03-18T11:15:24.098Z","avatar_url":"https://github.com/rodrigopcastro018.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\" width=\"100%\"\u003e\r\n    \u003cimg src=\"https://github.com/rodrigopcastro018/nodimo/raw/main/docs/logo/logo_name_side.svg\" alt=\"Nodimo Logo\" width=\"500\"\u003e\r\n\u003c/p\u003e\r\n\r\n---\r\n\r\n| **Docs**    | [![Docs Status Badge]][Docs Status]                                           |\r\n| :---------- | :---------------------------------------------------------------------------- |\r\n| **Tests**   | [![Tests Status Badge]][Tests Status] [![Coverage Badge]][Coverage]           |\r\n| **Python**  | [![Python Versions Badge]][Python Versions]                                   |\r\n| **Version** | [![PyPI Version Badge]][PyPI Version] [![Conda Version Badge]][Conda Version] |\r\n| **License** | [![License Badge]][License]                                                   |\r\n\r\n# Nodimo\r\nThe main purpose of Nodimo is to transform a dimensional relationship between quantities into a dimensionless one. This is done by grouping dimensional quantities into dimensionless products in such a way that the resulting number of products is always lower than or equal to the starting number of quantities. Therefore, the ensuing dimensionless model is, at the same time, a generalization and simplification of the dimensional model.\r\n\r\nNodimo supports any number of dimensions and quantities. It can be used for applications in science, engineering, economics and finance. The resulting dimensionless relations can be used as the basis for further studies in similarity and model testing.\r\n\r\n## Notes\r\n\r\n* The use of Nodimo requires basic knowledge of dimensional analysis, specially on choosing the appropriate set of scaling parameters and indentifying established dimensionless groups.\r\n\r\n* It is recommended the use of [jupyter notebook][Jupyter Notebook] for a better displaying of the results.\r\n\r\n## Installation\r\nVia `PyPI`, Nodimo is installed by:\r\n```shell\r\npip install nodimo\r\n```\r\n\r\nAlternatively, via `Anaconda`:\r\n```shell\r\nconda install nodimo\r\n```\r\n\r\n## Getting started\r\n### Basic example\r\n* Simple pendulum\r\n\r\n\u003cp align=\"center\" width=\"100%\"\u003e\r\n    \u003cimg width=\"30%\" src=\"https://github.com/rodrigopcastro018/nodimo/raw/main/docs/tutorials/drawings/01_simple_pendulum.svg\" alt=\"Simple Pendulum\"\u003e\r\n\u003c/p\u003e\r\n\r\nThe dimensionless relation between the pendulum's period `T` and the other quantities presented in the figure above is built and displayed as:\r\n\r\n```python\r\nfrom nodimo import Quantity, Model\r\n\r\nT = Quantity('T', mass=0, length=0, time=1, dependent=True)  # period\r\nL = Quantity('L', mass=0, length=1, time=0, scaling=True)    # length\r\nm = Quantity('m', mass=1, length=0, time=0)                  # mass\r\ng = Quantity('g', mass=0, length=1, time=-2, scaling=True)   # gravity\r\nt0 = Quantity('theta_0')                                     # initial angle\r\n\r\nmodel = Model(T, L, m, g, t0)\r\nmodel.show()\r\n```\r\n\r\nAnd the result is:\r\n\r\n$$\\displaystyle \\frac{T g^{\\frac{1}{2}}}{L^{\\frac{1}{2}}} = \\Phi{\\left(\\theta_{0} \\right)}$$\r\n\r\nFor more applications and functionalities, check the [documentation][Docs Status].\r\n\r\n\u003c!-- Links --\u003e\r\n[Docs Status]: https://nodimo.readthedocs.io/\r\n[Docs Status Badge]: https://img.shields.io/readthedocs/nodimo?color=8A2BE2\r\n[Tests Status]: https://github.com/rodrigopcastro018/nodimo/actions/workflows/full_test.yml?query=branch%3Amain\r\n[Tests Status Badge]: https://img.shields.io/github/actions/workflow/status/rodrigopcastro018/nodimo/full_test.yml?branch=main\u0026label=Tests\r\n[Coverage]: https://coverage-badge.samuelcolvin.workers.dev/redirect/rodrigopcastro018/nodimo\r\n[Coverage Badge]: https://coverage-badge.samuelcolvin.workers.dev/rodrigopcastro018/nodimo.svg\r\n[Python Versions]: https://pypi.org/project/nodimo\r\n[Python Versions Badge]: https://img.shields.io/pypi/pyversions/nodimo\r\n[PyPI Version]: https://pypi.org/project/nodimo/\r\n[PyPI Version Badge]: https://img.shields.io/pypi/v/nodimo?label=PyPI\u0026color=orange\r\n[Conda Version]: https://anaconda.org/conda-forge/nodimo\r\n[Conda Version Badge]: https://img.shields.io/conda/v/conda-forge/nodimo?label=Conda\u0026color=green\r\n[PyPI Downloads]: https://pypi.org/project/nodimo\r\n[PyPI Downloads Badge]: https://img.shields.io/pypi/dm/nodimo?label=PyPI%20downloads\u0026color=blue\r\n[Conda Downloads]: https://anaconda.org/conda-forge/nodimo\r\n[Conda Downloads Badge]: https://img.shields.io/conda/d/conda-forge/nodimo?label=Conda%20downloads\u0026color=green\r\n[License]: https://github.com/rodrigopcastro018/nodimo/blob/main/LICENSE\r\n[License Badge]: https://img.shields.io/github/license/rodrigopcastro018/nodimo?label=License\u0026color=yellow\r\n[Jupyter Notebook]: https://jupyter.org/\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frodrigopcastro018%2Fnodimo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frodrigopcastro018%2Fnodimo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frodrigopcastro018%2Fnodimo/lists"}