{"id":15494453,"url":"https://github.com/addisonelliott/polartransform","last_synced_at":"2025-07-07T14:32:44.694Z","repository":{"id":57453961,"uuid":"123046007","full_name":"addisonElliott/polarTransform","owner":"addisonElliott","description":"Python package that converts between polar and cartesian domain (in images too).","archived":false,"fork":false,"pushed_at":"2019-01-09T02:12:08.000Z","size":33219,"stargazers_count":26,"open_issues_count":2,"forks_count":13,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-23T00:03:03.415Z","etag":null,"topics":["cartesian","conversion","image-processing","polar","python","python3"],"latest_commit_sha":null,"homepage":"http://polartransform.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/addisonElliott.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-02-26T23:47:16.000Z","updated_at":"2025-05-03T15:39:19.000Z","dependencies_parsed_at":"2022-08-29T11:12:04.243Z","dependency_job_id":null,"html_url":"https://github.com/addisonElliott/polarTransform","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/addisonElliott/polarTransform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addisonElliott%2FpolarTransform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addisonElliott%2FpolarTransform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addisonElliott%2FpolarTransform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addisonElliott%2FpolarTransform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/addisonElliott","download_url":"https://codeload.github.com/addisonElliott/polarTransform/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addisonElliott%2FpolarTransform/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261386708,"owners_count":23150866,"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":["cartesian","conversion","image-processing","polar","python","python3"],"created_at":"2024-10-02T08:14:16.690Z","updated_at":"2025-06-23T00:03:10.023Z","avatar_url":"https://github.com/addisonElliott.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: https://travis-ci.org/addisonElliott/polarTransform.svg?branch=master\n    :target: https://travis-ci.org/addisonElliott/polarTransform\n    :alt: Build Status\n\n.. image:: https://img.shields.io/pypi/pyversions/polarTransform.svg\n    :target: https://img.shields.io/pypi/pyversions/polarTransform.svg\n    :alt: Python version\n\n.. image:: https://badge.fury.io/py/polarTransform.svg\n    :target: https://badge.fury.io/py/polarTransform\n    :alt: PyPi version\n\n.. image:: https://readthedocs.org/projects/polartransform/badge/?version=latest\n    :target: https://polartransform.readthedocs.io/en/latest/?badge=latest\n    :alt: Documentation Status\n\n.. image:: https://codecov.io/gh/addisonElliott/polarTransform/branch/master/graph/badge.svg\n  :target: https://codecov.io/gh/addisonElliott/polarTransform\n\n|\n\nIntroduction\n=================\npolarTransform is a Python package for converting images between the polar and Cartesian domain. It contains many\nfeatures such as specifying the start/stop radius and angle, interpolation order (bicubic, linear, nearest, etc), and\nmuch more.\n\nInstalling\n=================\nPrerequisites\n-------------\n* Python 3\n* Dependencies:\n   * numpy\n   * scipy\n   * scikit-image\n\nInstalling polarTransform\n-------------------------\npolarTransform is currently available on `PyPi \u003chttps://pypi.python.org/pypi/polarTransform/\u003e`_. The simplest way to\ninstall alone is using ``pip`` at a command line::\n\n  pip install polarTransform\n\nwhich installs the latest release.  To install the latest code from the repository (usually stable, but may have\nundocumented changes or bugs)::\n\n  pip install git+https://github.com/addisonElliott/polarTransform.git\n\n\nFor developers, you can clone the polarTransform repository and run the ``setup.py`` file. Use the following commands to get\na copy from GitHub and install all dependencies::\n\n  git clone pip install git+https://github.com/addisonElliott/polarTransform.git\n  cd polarTransform\n  pip install .\n\nor, for the last line, instead use::\n\n  pip install -e .\n\nto install in 'develop' or 'editable' mode, where changes can be made to the local working code and Python will use\nthe updated polarTransform code.\n\nTest and coverage\n=================\nRun the following command in the base directory to run the tests:\n\n.. code-block:: bash\n\n    python -m unittest discover -v polarTransform/tests\n\nExample\n=================\nInput image:\n\n.. image:: http://polartransform.readthedocs.io/en/latest/_images/verticalLines.png\n    :alt: Cartesian image\n\n.. code-block:: python\n\n    import polarTransform\n    import matplotlib.pyplot as plt\n    import imageio\n\n    verticalLinesImage = imageio.imread('IMAGE_PATH_HERE')\n\n    polarImage, ptSettings = polarTransform.convertToPolarImage(verticalLinesImage, initialRadius=30,\n                                                                finalRadius=100, initialAngle=2 / 4 * np.pi,\n                                                                finalAngle=5 / 4 * np.pi)\n\n    cartesianImage = ptSettings.convertToCartesianImage(polarImage)\n\n    plt.figure()\n    plt.imshow(polarImage, origin='lower')\n\n    plt.figure()\n    plt.imshow(cartesianImage, origin='lower')\n\nThe result is a polar domain image with a specified initial and final radius and angle:\n\n.. image:: http://polartransform.readthedocs.io/en/latest/_images/verticalLinesPolarImage_scaled3.png\n    :alt: Polar image\n\nConverting back to the cartesian image results in only a slice of the original image to be shown because the initial and final radius and angle were specified:\n\n.. image:: http://polartransform.readthedocs.io/en/latest/_images/verticalLinesCartesianImage_scaled.png\n    :alt: Cartesian image\n\nNext Steps\n=================\nTo learn more about polarTransform, see the `documentation \u003chttp://polartransform.readthedocs.io/\u003e`_.\n\nLicense\n=================\npolarTransform has an MIT-based `license \u003chttps://github.com/addisonElliott/polarTransform/blob/master/LICENSE\u003e`_.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faddisonelliott%2Fpolartransform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faddisonelliott%2Fpolartransform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faddisonelliott%2Fpolartransform/lists"}