{"id":15359055,"url":"https://github.com/leouieda/tesseroids","last_synced_at":"2025-10-04T10:14:46.463Z","repository":{"id":6672688,"uuid":"7917503","full_name":"leouieda/tesseroids","owner":"leouieda","description":"Forward modeling of gravity fields in spherical coordinates","archived":false,"fork":false,"pushed_at":"2017-05-24T21:30:53.000Z","size":16904,"stargazers_count":33,"open_issues_count":9,"forks_count":12,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-09-05T21:08:58.355Z","etag":null,"topics":["c","earth-science","geophysics","gravity"],"latest_commit_sha":null,"homepage":"http://tesseroids.leouieda.com","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leouieda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.txt","codeowners":null,"security":null,"support":null}},"created_at":"2013-01-30T15:43:39.000Z","updated_at":"2025-04-24T06:10:40.000Z","dependencies_parsed_at":"2022-08-28T03:00:53.740Z","dependency_job_id":null,"html_url":"https://github.com/leouieda/tesseroids","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/leouieda/tesseroids","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leouieda%2Ftesseroids","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leouieda%2Ftesseroids/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leouieda%2Ftesseroids/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leouieda%2Ftesseroids/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leouieda","download_url":"https://codeload.github.com/leouieda/tesseroids/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leouieda%2Ftesseroids/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278297784,"owners_count":25963792,"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","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["c","earth-science","geophysics","gravity"],"created_at":"2024-10-01T12:43:42.477Z","updated_at":"2025-10-04T10:14:46.413Z","avatar_url":"https://github.com/leouieda.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ![Tesseroids](https://raw.githubusercontent.com/leouieda/tesseroids/master/doc/_static/banner.png)\n\n[Documentation](http://tesseroids.leouieda.com) |\n[Download](https://github.com/leouieda/tesseroids/releases)\n\n[![Version number](http://img.shields.io/github/release/leouieda/tesseroids.svg?style=flat)](https://github.com/leouieda/tesseroids/releases)\n[![Travis CI build status](http://img.shields.io/travis/leouieda/tesseroids/master.svg?style=flat)](https://travis-ci.org/leouieda/tesseroids)\n[![BSD license](http://img.shields.io/badge/license-BSD-lightgrey.svg?style=flat)](https://github.com/leouieda/tesseroids/blob/master/LICENSE.txt)\n[![DOI](https://zenodo.org/badge/doi/10.5281/zenodo.582366.svg)](http://dx.doi.org/10.5281/zenodo.582366)\n\n\n*Forward modeling of gravitational fields in spherical coordinates.*\n\nDeveloped by [Leonardo Uieda](http://www.leouieda.com)\nin cooperation with [Carla Braitenberg](http://lithoflex.org/).\n\n## About\n\n*Tesseroids* is a collection of **command-line tools**\nfor modeling the gravitational potential, acceleration, and\ngradient (Marussi) tensor.\n\nThe mass models can be made of right rectangular prisms or tesseroids\n(spherical prisms).\nComputation for rectangular prisms can be made in Cartesian or spherical\n(geocentric) coordinates.\n\n[![This is a tesseroid.](https://raw.githubusercontent.com/leouieda/tesseroids/master/doc/_static/tesseroid.png)](http://tesseroids.leouieda.com/en/latest/theory.html#what-is-a-tesseroid-anyway)\n\n## License\n\n*Tesseroids* is [free software](http://www.fsf.org/about/what-is-free-software)\nmade available under the terms of the\nBSD 3-clause license.\nSee [LICENSE.txt](https://github.com/leouieda/tesseroids/blob/master/LICENSE.txt).\n\n## Citing\n\n*Tesseroids* is research software made by scientists.\nIf you use it in your research,\nplease **cite** our *Geophysics* paper in your publications:\n\n\u003e Uieda, L., V. Barbosa, and C. Braitenberg (2016), Tesseroids: Forward-modeling gravitational fields in spherical coordinates, GEOPHYSICS, F41-F48, doi:[10.1190/geo2015-0204.1](http://dx.doi.org/10.1190/geo2015-0204.1).\n\nYou can download a copy of the paper PDF at\n[leouieda.com/papers/paper-tesseroids-2016.html](http://www.leouieda.com/papers/paper-tesseroids-2016.html)\nand see all source code used in the paper at the Github repository\n[pinga-lab/paper-tesseroids](https://github.com/pinga-lab/paper-tesseroids).\n\nSee [CITATION.txt](https://github.com/leouieda/tesseroids/blob/master/CITATION.txt)\nor the [Citing](http://tesseroids.leouieda.com/en/latest/citation.html)\npage of the documentation for more information.\n\n## Installing\n\nThe easiest way to install is to download the latest compiled binary\ndistribution from:\n\nhttps://github.com/leouieda/tesseroids/releases/latest\n\nWe offer binaries for Windows (32 and 64 bit)\nand GNU/Linux (32 and 64 bit).\n\nOnce downloaded, simply unpack the archive in the desired directory.\nThe executables will be in the `bin` folder.\nFor easier access to the programs, consider\n[adding the bin folder to your PATH environment\nvariable](http://www.computerhope.com/issues/ch000549.htm).\n\n## Getting started\n\nTake a look at the examples in the\n[Cookbook](http://tesseroids.leouieda.com/en/latest/cookbook.html).\nThey contain scripts that run *Tesseroids* and some Python code to plot the\nresults.\n\nThe documentation contains sections on\n[the theory and equations](http://tesseroids.leouieda.com/en/latest/theory.html)\nand [usage instructions](http://tesseroids.leouieda.com/en/latest/usage.html).\n\nAlso, all programs accept the `-h` flag to print the instructions for using\nthat particular program. For example:\n\n    $ tessgrd -h\n    Usage: tessgrd [PARAMS] [OPTIONS]\n\n    Make a regular grid of points.\n\n    All units either SI or degrees!\n\n    Output:\n      Printed to standard output (stdout) in the format:\n        lon1    lat1    height\n        lon2    lat1    height\n        ...     ...     ...\n        lonNLON lat1    height\n        lon1    lat2    height\n        ...     ...     ...\n        ...     ...     ...\n        lonNLON latNLAT height\n\n      * Comments about the provenance of the data are inserted into\n        the top of the output\n\n    Parameters:\n      -r           W/E/S/N: Bounding region of the grid.\n      -b           NLON/NLAT: Number of grid points in the\n                   longitudinal and latitudinal directions.\n      -z           HEIGHT: Height of the grid with respect to the\n                   mean Earth radius.\n      -h           Print instructions.\n      --version    Print version and license information.\n\n    Options:\n      -v           Enable verbose printing to stderr.\n      -lFILENAME   Print log messages to file FILENAME.\n\n    Part of the Tesseroids package.\n    Project site: \u003chttp://fatiando.org/software/tesseroids\u003e\n    Report bugs at: \u003chttp://code.google.com/p/tesseroids/issues/list\u003e\n\n\n## Getting help\n\nWrite an e-mail to [Leonardo Uieda](http://www.leouieda.com/),\nor [tweet](https://twitter.com/leouieda),\nor [Google Hangout](https://plus.google.com/+LeonardoUieda).\n**Even better**, submit a bug report/feature request/question to the\n[Github issue tracker](https://github.com/leouieda/tesseroids/issues).\n\n## Compiling from source\n\nIf you want to build *Tesseroids* from source, you'll need:\n\n* A C compiler (preferably [GCC](http://gcc.gnu.org))\n* The build tool [SCons](http://www.scons.org/)\n\n### Setting up SCons\n\nTesseroids uses the build tool SCons.\nA `SConstruct` file (`Makefile` equivalent)\nis used to define the compilation rules.\nThe advantage of SCons over Make is that it automatically detects your system\nsettings.\nYou will have to download and install SCons\nin order to easily compile Tesseroids.\nSCons is available for both GNU/Linux and Windows\nso compiling should work the same on both platforms.\n\nSCons requires that you have [Python](http://www.python.org) installed.\nFollow the instructions in the [SCons website](http://www.scons.org/)\nto install it.\nPython is usually installed by default on most GNU/Linux systems.\n\nUnder Windows you will have to put SCons on\nyour `PATH` environment variable\nin order to use it from the command line.\nIt is usually located in the `Scripts` directory of your Python installation.\n\nOn GNU/Linux, SCons will generally use\nthe GCC compiler to compile sources.\nOn Windows it will search for an existing compiler.\nWe recommend that you install GCC on Windows using\n[MinGW](http://mingw.org/).\n\n### Compiling\n\nDownload a source distribution and\nunpack the archive anywhere you want\n(e.g., `~/tesseroids` or `C:\\tesseroids` or whatever).\nTo compile,\nopen a terminal (or `cmd.exe` on Windows)\nand go to the directory where you unpacked (use the `cd` command).\nThen, type the following and hit `Enter`:\n\n    scons\n\nIf everything goes well, the compiled executables will be placed on a `bin`\nfolder.\n\nTo clean up the build (delete all generated files), run:\n\n    scons -c\n\nIf you get any strange errors or the code doesn't compile for some reason,\nplease [submit a bug report](https://github.com/leouieda/tesseroids/issues).\nDon't forget to copy the output of running `scons`.\n\n### Testing the build\n\nAfter the compilation,\na program called `tesstest`\nwill be placed in the directory where you unpacked the source.\nThis program runs the [unit tests](https://en.wikipedia.org/wiki/Unit_testing)\nfor *Tesseroids* (sources in the `test` directory).\n\nTo run the test suite, simply execute `tesstest` with no arguments:\n\n    tesstest\n\nor on GNU/Linux:\n\n    ./tesstest\n\nA summary of all tests (pass or fail) will be printed on the screen.\nIf all tests pass,\nthe compilation probably went well.\nIf any test fail,\nplease [submit a bug report](https://github.com/leouieda/tesseroids/issues)\nwith the output of running `tesstest`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleouieda%2Ftesseroids","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleouieda%2Ftesseroids","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleouieda%2Ftesseroids/lists"}