{"id":17113228,"url":"https://github.com/jmert/healmex","last_synced_at":"2026-01-04T18:33:28.433Z","repository":{"id":53538800,"uuid":"153509852","full_name":"jmert/healmex","owner":"jmert","description":null,"archived":false,"fork":false,"pushed_at":"2024-03-15T04:29:42.000Z","size":60121,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-29T06:49:13.312Z","etag":null,"topics":["cmb","cosmic-microwave-background","healpix","matlab"],"latest_commit_sha":null,"homepage":null,"language":"CMake","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jmert.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2018-10-17T19:08:39.000Z","updated_at":"2024-03-08T13:38:41.000Z","dependencies_parsed_at":"2024-12-01T02:53:09.195Z","dependency_job_id":null,"html_url":"https://github.com/jmert/healmex","commit_stats":{"total_commits":73,"total_committers":8,"mean_commits":9.125,"dds":0.6027397260273972,"last_synced_commit":"6571fd83172e630d1044a2a0426f5d822545cdf1"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmert%2Fhealmex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmert%2Fhealmex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmert%2Fhealmex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmert%2Fhealmex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmert","download_url":"https://codeload.github.com/jmert/healmex/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245186924,"owners_count":20574553,"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":["cmb","cosmic-microwave-background","healpix","matlab"],"created_at":"2024-10-14T17:04:36.830Z","updated_at":"2026-01-04T18:33:28.399Z","avatar_url":"https://github.com/jmert.png","language":"CMake","funding_links":[],"categories":[],"sub_categories":[],"readme":"# healmex\n\nA package providing Matlab bindings to the [HEALPix][healpix] C++ package.\n\n## Build Requirements\n\n- GCC 7+ (or a compiler which supports C++17's structured bindings)\n- Matlab R2019b+\n- CMake 3.9.0+\n- `pkg-config` (or `pkgconf`)\n- Internet connection (to download HEALPix sources)\n  - HEALPix v3.60 is used\n- HEALPix's build requirements, such as:\n  - GNU Autotools (`autoreconf`, `make`, etc)\n  - CFITSIO\n\nAt this time, compilation and use on Linux is the only tested and supported\nplatform.\n\nIt is not planned to provide support for any versions of Matlab older than\nR2018a since it is the first version which provides the [interleaved][]\ncomplex data storage format. This new option finally provides a format\ncompatible with standard complex data types (e.g. `double complex` in C and\n`complex\u003cdouble\u003e` in C++). In Matlab's prior format, complex arrays must be\nduplicated (doubling memory requirements) and copied on each entrance/exit\nacross the Matlab/C++ boundary.\n\n## Installation Instructions\n\nThe repository can be cloned via `git` from GitHub:\n```bash\n$ git clone https://github.com/jmert/healmex.git\n```\nConfiguration is performed via CMake's `cmake` or `ccmake` commands. For\nnon-interactive use, the installation prefix (where the compiled MEX function\nand associated Matlab scripts) are installed to can be configured with:\n```bash\n$ cmake -DCMAKE_INSTALL_PREFIX=~/matlab/healmex\n```\nwhere `~/matlab/healmex` can be any other path of your choice. Then to build\nand install\n```bash\n$ make \u0026\u0026 make install\n```\nThe build will start by downloading HEALPix, unpacking it, and compiling the\nC++ library. (The C and Fortran components are not built!) After that, the MEX\nfunction bindings to HEALPix's C++ APIs are compiled.\n\nTo use within Matlab, the installation path should be added into Matlab's\nruntime path:\n```matlab\n\u003e\u003e addpath('~/matlab/healmex')\n```\nAdding a similar line to your `startup.m` file may be useful.\n\n### Configuration Options\n\nThe following are available options which can be set during configuration.\nEach should be set in either the interact `ccmake` prompt or via a CMake\nvariable definition with `cmake -DVAR=VALUE`.\n\n* **`ASPACKAGE`**: Defaults to `ON`. If `ON`, the package is installed as a\n  Matlab package. Otherwise if `OFF`, the package is installed as a flat\n  set of functions.\n\n## Usage\n\nIf installed as a Matlab package, the bindings in Matlab are presented as\nmethods within the `healmex` package namespace.\n\nHelp is available for each binding\n```matlab\n\u003e\u003e help healmex.pix2ang\n  [theta, phi] = pix2ang(nside, ipix, varargin)\n\n  INPUTS\n    nside       The HEALPix Nside parameter.\n    ipix        Pixel indices.\n  ...\n```\nwith descriptions of the calling convention for each binding. For example,\na call to `pix2ang` to convert pixel 72 in an Nside = 4 map to θ and φ\ncoordinates is accomplished with a call like:\n```matlab\n\u003e\u003e [th,ph] = healmex.pix2ang(4, 74)\n\nth =\n\n    1.4033\n\n\nph =\n\n    0.7854\n\n```\nIf installed in the flat form, the `healmex.` prefix from calls should\nbe removed.\n\n[healpix]: https://healpix.sourceforge.io/index.php\n[interleaved]: https://www.mathworks.com/help/matlab/matlab_external/matlab-support-for-interleaved-complex.html\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmert%2Fhealmex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmert%2Fhealmex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmert%2Fhealmex/lists"}