{"id":13408103,"url":"https://github.com/ondrolexa/apsg","last_synced_at":"2025-10-21T19:31:27.345Z","repository":{"id":21559589,"uuid":"24879346","full_name":"ondrolexa/apsg","owner":"ondrolexa","description":"Structural geology package for Python","archived":false,"fork":false,"pushed_at":"2024-05-15T10:53:03.000Z","size":62685,"stargazers_count":91,"open_issues_count":1,"forks_count":27,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-05-16T14:24:24.506Z","etag":null,"topics":["python","structural-geology"],"latest_commit_sha":null,"homepage":"https://apsg.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ondrolexa.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":"CONTRIBUTING.md","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":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-10-07T06:31:58.000Z","updated_at":"2024-06-12T17:06:13.096Z","dependencies_parsed_at":"2023-01-14T13:11:07.666Z","dependency_job_id":"33d69a8a-881f-4149-b61a-5af9e6f9a994","html_url":"https://github.com/ondrolexa/apsg","commit_stats":{"total_commits":520,"total_committers":4,"mean_commits":130.0,"dds":"0.044230769230769185","last_synced_commit":"4a4d2b4a4357583c71a16876e493e05e705647cd"},"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ondrolexa%2Fapsg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ondrolexa%2Fapsg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ondrolexa%2Fapsg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ondrolexa%2Fapsg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ondrolexa","download_url":"https://codeload.github.com/ondrolexa/apsg/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243578507,"owners_count":20313840,"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":["python","structural-geology"],"created_at":"2024-07-30T20:00:50.768Z","updated_at":"2025-10-21T19:31:21.790Z","avatar_url":"https://github.com/ondrolexa.png","language":"Python","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=QTYZWVUNDUAH8\u0026item_name=APSG+development+donation\u0026currency_code=EUR\u0026source=url"],"categories":["Software","Structural Geology and Tectonics"],"sub_categories":["Geology and Geophysics","Structural Geology","Structural geology","Repositories"],"readme":"\u003cimg src=\"https://ondrolexa.github.io/apsg/apsg_banner.svg\" alt=\"APSG logo\" width=\"300px\"/\u003e\n\n[![PyPI - Version](https://img.shields.io/pypi/v/apsg)](https://pypi.org/project/apsg)\n[![Conda](https://img.shields.io/conda/v/conda-forge/apsg)](https://anaconda.org/conda-forge/apsg)\n[![Documentation Status](https://readthedocs.org/projects/apsg/badge/?version=stable)](https://apsg.readthedocs.io/en/stable/?badge=stable)\n[![DOI](https://zenodo.org/badge/24879346.svg)](https://zenodo.org/badge/latestdoi/24879346)\n\n## :thinking: What is APSG?\n\nAPSG is the package for structural geologists. It defines several new python classes to easily manage, analyze and visualize orientational structural geology data.\n\n\u003e [!IMPORTANT]\n\u003e APSG has been significantly refactored from version 1.0 and several changes are\n\u003e breaking backward compatibility. The main APSG namespace provides often-used\n\u003e classes in lowercase names as aliases to `PascalCase` convention used in\n\u003e modules to provide a simplified interface for users. The `PascalCase` names of\n\u003e classes use longer and plain English names instead acronyms for better readability.\n\u003e\n\u003e Check [documentation](https://apsg.readthedocs.org) for more details.\n\n## :hammer_and_wrench: Requirements\n\nYou need Python 3.9 or later to run APSG. The package requires [NumPy](https://numpy.org/) and [SciPy](https://www.scipy.org/),\n[Matplotlib](https://matplotlib.org/), [SciPy](https://scipy.org/), [SQLAlchemy](https://www.sqlalchemy.org/)\nand [pandas](https://pandas.pydata.org/).\n\n## :rocket: How to install\n\nIt is strongly suggested to install **apsg** into separate environment. You can create\nPython virtual environment. For Linux and macOS use:\n\n    python -m venv .venv\n    source .venv/bin/activate\n\nfor Windows use Command Prompt or PowerShell:\n\n    python -m venv .venv\n    .venv\\Scripts\\activate\n\n\u003e [!NOTE]\n\u003e On Microsoft Windows, it may be required to set the execution policy in PowerShell for the user.\n\u003e You can do this by issuing the following PowerShell command:\n\u003e ```\n\u003e Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\n\u003e ```\n\nand install latest stable version of **apsg** using pip within the environment:\n\n    pip install apsg\n\nTo include jupyterlab and pyqt5 in installation, use `extra` option:\n\n## I'm using conda or mamba to manage environments\n\n    pip install apsg[extra]\n\nor install **master** with:\n\n    pip install git+https://github.com/ondrolexa/apsg.git\n\nAlternatively, you can clone the repository and do a local install (recommended for dev):\n    git clone https://github.com/ondrolexa/apsg.git\n    cd apsg\n    pip install -e .[dev]\n\n#### Upgrading via pip\n\nTo upgrade an existing version of APSG from PyPI, execute:\n\n    pip install apsg --upgrade --no-deps\n\n#### Comments on system-wide instalations on Debian systems\n\nLatest Debian-based systems does not allow to install non-debian packages system-wide.\nHowever, installing all requirements allows to force install APSG system-wide without troubles.\n\nInstall requirements using apt:\n\n    sudo apt install python3-numpy python3-matplotlib python3-scipy python3-sqlalchemy python3-pandas\n\nand then install apsg using pip:\n\n    pip install --break-system-packages apsg\n\n### I'm using conda or mamba to manage environments\n\nIf you have already have conda or mamba installed, you can create environment with:\n\n    conda config --add channels conda-forge\n    conda create -n apsg python apsg jupyterlab pyqt\n\nor using mamba\n\n    mamba create -n apsg python apsg jupyterlab pyqt\n\n#### Current release info\n\n| Name | Downloads | Version | Platforms |\n| --- | --- | --- | --- |\n| [![Conda Recipe](https://img.shields.io/badge/recipe-apsg-green.svg)](https://anaconda.org/conda-forge/apsg) | [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/apsg.svg)](https://anaconda.org/conda-forge/apsg) | [![Conda Version](https://img.shields.io/conda/vn/conda-forge/apsg.svg)](https://anaconda.org/conda-forge/apsg) | [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/apsg.svg)](https://anaconda.org/conda-forge/apsg) |\n\n## :blue_book: Documentation\n\nExplore all the features of APSG. You can find detailed documentation [here](https://apsg.readthedocs.org).\n\n## :computer: Contributing\n\nMost discussion happens on [Github](https://github.com/ondrolexa/apsg). Feel free to open [an issue](https://github.com/ondrolexa/apsg/issues/new) or comment on any open issue or pull request. Check ``CONTRIBUTING.md`` for more details.\n\n## :coin: Donate\n\nAPSG is an open-source project, available for you for free. It took a lot of time and resources to build this software. If you find this software useful and want to support its future development please consider donating me.\n\n[![Donate via PayPal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=QTYZWVUNDUAH8\u0026item_name=APSG+development+donation\u0026currency_code=EUR\u0026source=url)\n\n## License\n\nAPSG is free software: you can redistribute it and/or modify it under the terms of the MIT License. A copy of this license is provided in ``LICENSE`` file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fondrolexa%2Fapsg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fondrolexa%2Fapsg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fondrolexa%2Fapsg/lists"}