{"id":22798125,"url":"https://github.com/doi-usgs/ale","last_synced_at":"2026-02-20T22:01:09.224Z","repository":{"id":33548865,"uuid":"159196964","full_name":"DOI-USGS/ale","owner":"DOI-USGS","description":"Abstraction Layer for Ephemerides (ALE)","archived":false,"fork":false,"pushed_at":"2026-02-09T18:12:04.000Z","size":40627,"stargazers_count":16,"open_issues_count":39,"forks_count":36,"subscribers_count":12,"default_branch":"main","last_synced_at":"2026-02-09T22:24:24.832Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"XC","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/DOI-USGS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2018-11-26T16:09:16.000Z","updated_at":"2026-02-09T18:12:09.000Z","dependencies_parsed_at":"2023-10-14T21:37:22.758Z","dependency_job_id":null,"html_url":"https://github.com/DOI-USGS/ale","commit_stats":{"total_commits":467,"total_committers":29,"mean_commits":"16.103448275862068","dds":0.7773019271948608,"last_synced_commit":"775ff216791349f44a643a1080818631f6b7b16e"},"previous_names":["usgs-astrogeology/ale"],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/DOI-USGS/ale","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fale","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fale/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fale/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fale/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DOI-USGS","download_url":"https://codeload.github.com/DOI-USGS/ale/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DOI-USGS%2Fale/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29666419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T19:49:36.704Z","status":"ssl_error","status_checked_at":"2026-02-20T19:44:05.372Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":[],"created_at":"2024-12-12T06:08:28.402Z","updated_at":"2026-02-20T22:01:09.198Z","avatar_url":"https://github.com/DOI-USGS.png","language":"XC","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/ALE_Logo.svg\" alt=\"ALE\" width=200\u003e \n\u003c/p\u003e\n\n# Abstraction Layer for Ephemerides (ALE)\n[![Build Status](https://travis-ci.org/USGS-Astrogeology/ale.svg?branch=master)](https://travis-ci.org/USGS-Astrogeology/ale)\n[![Coverage Status](https://coveralls.io/repos/github/USGS-Astrogeology/ale/badge.svg?branch=master)](https://coveralls.io/github/USGS-Astrogeology/ale?branch=master)\n[![Docs](https://readthedocs.org/projects/ale/badge/?version=latest)](https://ale.readthedocs.io/en/latest/?badge=latest)\n[![DOI](https://img.shields.io/badge/DOI-10.5066/P906D84L-blue)](https://www1.usgs.gov/csas/doi/#/form/doi:10.5066%2FP906D84L)\n\n\nThis library allows for the position, rotation, velocity and rotational velocity tracking of\nmultiple bodies in space, especially in relation to one another. It makes extensive use of NAIF's\nSPICE data for such calculations.\n\n\n## Quick Links\n\n  - [Generating an ISD with `isd_generate`](https://astrogeology.usgs.gov/docs/getting-started/using-ale/isd-generate/)\n      - How to use the `isd_generate` script, and set up NAIF SPICE Data\n\n  - [ALE Quickstart](https://astrogeology.usgs.gov/docs/getting-started/using-ale/isd-generate/)\n      - Brief overview of how to install ALE and use `load`/`loads` in python\n\n  - [Tutorial: Generating an ISD, Creating a CSM Model, and Converting Coordinates](https://astrogeology.usgs.gov/docs/getting-started/csm-stack/image-to-ground-tutorial/#tutorial-instantiating-a-csm-camera-model-from-image)\n      - A tutorial on using ALE and Knoten in python\n\n  - [ALE Driver Architecture](https://astrogeology.usgs.gov/docs/concepts/ale/ale-driver-architecture/)\n      - How ALE and its drivers work\n\n\n## Prerequisite: Conda\n\nConda is a prerequisite for ALE.  If you need it, \n[download and install conda through miniforge](https://conda-forge.org/download/).\n\n## Installing ALE\n```sh\n# Create an environment (\"y\" to confirm)\nconda create -n ale\n\n# Run this to activate your environment whenever you need to use ALE\nconda activate ale\n\n# Install ALE from conda (in your current environment)\nconda install -c conda-forge ale\n```\n\n\n## Adding the ALESPICEROOT environment variable\nIf your ale driver uses NAIF SPICE data, you need to [download NAIF SPICE DATA (see ASC software docs)](https://astrogeology.usgs.gov/docs/getting-started/using-ale/isd-generate/#setting-up-naif-data) and set the ALESPICEROOT variable in one of these two ways:\n\n```sh\n# from your shell:\nexport ALESPICEROOT=/path/to/ale/spice\n\n# from inside a conda env:\nconda env config vars set ALESPICEROOT=/path/to/ale/spice\n```\n\n\n## Using ALE to generate ISDs\n\nTo generate an ISD for an image, use the load(s) function. Pass the path to your image/label file and ALE will attempt to find a suitable driver and return an ISD. You can use load to generate the ISD as a dictionary or loads to generate the ISD as a JSON encoded string.\n\n```\nisd_dict = load(path_to_label)\nisd_string = loads(path_to_label)\n```\n\nYou can get more verbose output from load(s) by passing verbose=True. If you are having difficulty generating an ISD enable the verbose flag to view the actual errors encountered in drivers.\n\n\n## Developing ALE\n\n### Installing ALE with git and conda\n\nClone ALE from git and create a conda environment with the necessary dependencies.\n```sh\ngit clone --recurse-submodules [paste link from \"\u003c\u003e Code\" button above]\ncd ale\nconda env create -n ale -f environment.yml  # \"y\" to confirm\n```\n\n### Conda Environment\n\nActivate the environment whenever you need to use ALE.\n```sh\nconda activate ale\n```\n\u003e *You can add `conda activate ale` to the end of your .bashrc or .zshrc if you want the `ale` environment to be active in every new terminal.*\n\n\n### Building ALE\nAfter you've set up and activated your conda environment, you may then build ALE. Inside\nof a cloned fork of the repository, follow these steps:\n\n```bash\npython setup.py install\ncd build\ncmake ..\nmake\n```\n\nKeep in mind that you will need to clone the repository with the `--recursive` flag in order to\nretrieve the gtest submodule for testing. If you have already cloned without the `--recursive` flag,\nrunning the following command will retrieve the gtest submodule manually:\n```bash\ngit submodule update --init --recursive\n```\n\n\n## Adding ALE as a dependency\n\nYou can add ALE as a dependency of your CMake based C++ project by linking the exported CMake target, `ale::ale`\n\n```c\nadd_library(my_library some_source.cpp)\nfind_package(ale REQUIRED)\ntarget_link_libraries(my_library ale::ale)\n```\n\n\n## Running Tests\n\nTo test the c++ part of ALE, run `ctest` from the build directory. \n\nTo test the python part of ALE, run `pytest tests/pytests`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoi-usgs%2Fale","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdoi-usgs%2Fale","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoi-usgs%2Fale/lists"}