#+AUTHOR: phdenzel
#+TITLE: skais-mapper
#+DATE: 2022-09-06 Tue
#+OPTIONS: author:nil title:t date:nil timestamp:nil toc:nil num:nil \n:nil
[[https://pypi.org/project/skais-mapper][https://img.shields.io/pypi/v/skais-mapper.svg]]
[[https://pypi.org/project/skais-mapper][https://img.shields.io/pypi/pyversions/skais-mapper.svg]]
[[https://www.gnu.org/licenses/gpl-3.0][https://img.shields.io/badge/License-GPL%20v3-blue.svg]]
*** Table of Contents
- [[#requirements][Requirements]]
- [[#install][Install]]
- [[#usage][Usage]]
- [[#data][Data]]
- [[#license][License]]
~skais-mapper~ is a tool for generating, plotting, and pre-processing
hydrodynamics simulation (image) data for state-of-the-art generative
AI models.
** Requirements
~skais-mapper~ is mostly built on python, but also includes some C
extensions for the compute-intensive raytracing (building and
visualizing datasets). Building from scratch thus requires ~cython~,
however ~skais~ ships with pre-compiled C files, making the minimal
requirements
- ~python >= 3.10~
- ~gcc~ (on linux) / ~clang~ (on macOS)
Also see ~pyproject.toml~ for the relevant python packages.
** Install
It is recommended to install ~skais-mapper~ in a virtual environment
via ~uv~. For this, run
#+begin_src shell
uv sync
#+end_src
Alternatively, you can simply run
#+begin_src shell
python setup.py build_ext --inplace
pip install [-e] .
#+end_src
If you want to compile the C extension from the cython files directly,
run in advance to the above
#+begin_src shell
python setup.py build_c [-a]
#+end_src
*** On Nix(OS)
For Nix(OS) users, the repository includes a ~flake.nix~ file. It
allows to create a development environment compatible with standard
~uv~ use.
** Usage
~skais-mapper~ implements a few sub-commands for generating and
manipulating simulation data. Use the following to see what valid
sub-commands exist:
#+begin_src shell
[uv run] skais-mapper -h
#+end_src
~skais-mapper~ sub-commands implement the hydra configuration
management framework. For more information on sub-command usage,
inspect the ~skais_mapper/configs/~ directory, or use:
#+begin_src shell
[uv run] skais-mapper [sub-command] -h
#+end_src
For instance, the command to generate 1000 images from snapshot 50 is
as follows:
#+begin_src shell
[uv run] skais-mapper generate +experiment=tng50-1-50-2D-0000-1000
#+end_src
** Data
Currently, this framework is fully compatible with SPH data from the
AREPO simulator, in particular the
[[https://www.tng-project.org/data/][IllustrisTNG suite]]. It
provides utility routines to fetch isolated halos from simulations
snapshots and various raytracing algorithms for 2D column density
projections of these halos and its galaxies. The framework generates
HDF5 files with image datasets of various galactic properties, such as
dark matter, star, or gas column density distributions.
** License
~skais-mapper~ is distributed under the terms of the
[[https://spdx.org/licenses/GPL-3.0-or-later.html][GNU General Public
License v3.0 or later]] license.
Raw data
{
"_id": null,
"home_page": null,
"name": "skais-mapper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Philipp Denzel <phdenzel@gmail.com>",
"keywords": "cosmological simulations, illustris-tng, radio mocks",
"author": null,
"author_email": "Philipp Denzel <phdenzel@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/5f/64/4cf065c05c7c606019a650a1afa4adf79dfa03b343513f1c45f1c052448f/skais_mapper-0.1.8.tar.gz",
"platform": null,
"description": "#+AUTHOR: phdenzel\n#+TITLE: skais-mapper\n#+DATE: 2022-09-06 Tue\n#+OPTIONS: author:nil title:t date:nil timestamp:nil toc:nil num:nil \\n:nil\n\n[[https://pypi.org/project/skais-mapper][https://img.shields.io/pypi/v/skais-mapper.svg]]\n[[https://pypi.org/project/skais-mapper][https://img.shields.io/pypi/pyversions/skais-mapper.svg]]\n[[https://www.gnu.org/licenses/gpl-3.0][https://img.shields.io/badge/License-GPL%20v3-blue.svg]]\n\n\n*** Table of Contents\n\n- [[#requirements][Requirements]]\n- [[#install][Install]]\n- [[#usage][Usage]]\n- [[#data][Data]]\n- [[#license][License]]\n\n\n\n~skais-mapper~ is a tool for generating, plotting, and pre-processing\nhydrodynamics simulation (image) data for state-of-the-art generative\nAI models.\n\n\n** Requirements\n\n~skais-mapper~ is mostly built on python, but also includes some C\nextensions for the compute-intensive raytracing (building and\nvisualizing datasets). Building from scratch thus requires ~cython~,\nhowever ~skais~ ships with pre-compiled C files, making the minimal\nrequirements\n\n- ~python >= 3.10~\n- ~gcc~ (on linux) / ~clang~ (on macOS)\n\nAlso see ~pyproject.toml~ for the relevant python packages.\n\n\n** Install\n\nIt is recommended to install ~skais-mapper~ in a virtual environment\nvia ~uv~. For this, run\n\n#+begin_src shell\n uv sync\n#+end_src\n\nAlternatively, you can simply run\n\n#+begin_src shell\n python setup.py build_ext --inplace\n pip install [-e] .\n#+end_src\n\nIf you want to compile the C extension from the cython files directly,\nrun in advance to the above\n\n#+begin_src shell\n python setup.py build_c [-a]\n#+end_src \n\n\n*** On Nix(OS)\n\nFor Nix(OS) users, the repository includes a ~flake.nix~ file. It\nallows to create a development environment compatible with standard\n~uv~ use.\n\n\n** Usage\n\n~skais-mapper~ implements a few sub-commands for generating and\nmanipulating simulation data. Use the following to see what valid\nsub-commands exist:\n\n#+begin_src shell\n[uv run] skais-mapper -h\n#+end_src\n\n~skais-mapper~ sub-commands implement the hydra configuration\nmanagement framework. For more information on sub-command usage,\ninspect the ~skais_mapper/configs/~ directory, or use:\n\n#+begin_src shell\n[uv run] skais-mapper [sub-command] -h\n#+end_src\n\nFor instance, the command to generate 1000 images from snapshot 50 is\nas follows:\n\n#+begin_src shell\n[uv run] skais-mapper generate +experiment=tng50-1-50-2D-0000-1000\n#+end_src\n\n\n** Data\n\nCurrently, this framework is fully compatible with SPH data from the\nAREPO simulator, in particular the\n[[https://www.tng-project.org/data/][IllustrisTNG suite]]. It\nprovides utility routines to fetch isolated halos from simulations\nsnapshots and various raytracing algorithms for 2D column density\nprojections of these halos and its galaxies. The framework generates\nHDF5 files with image datasets of various galactic properties, such as\ndark matter, star, or gas column density distributions.\n\n\n** License\n\n~skais-mapper~ is distributed under the terms of the\n[[https://spdx.org/licenses/GPL-3.0-or-later.html][GNU General Public\nLicense v3.0 or later]] license.\n",
"bugtrack_url": null,
"license": null,
"summary": "A framework for generating deep-learning SKA radio telescope & cosmological hydrodynamical simulation data",
"version": "0.1.8",
"project_urls": {
"Documentation": "https://github.com/phdenzel/skais-mapper#readme",
"Homepage": "https://github.com/phdenzel/skais-mapper",
"Issues": "https://github.com/phdenzel/skais-mapper/issues",
"Repository": "https://github.com/phdenzel/skais-mapper.git"
},
"split_keywords": [
"cosmological simulations",
" illustris-tng",
" radio mocks"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "746b6fa64d38d0c6e15190ddd7c85c8d47d0f2ff017d8f0925d977d2c4ae3e97",
"md5": "c282c26a2f5315908fd0431bf555f9be",
"sha256": "362e1aa7828b6bf0fcbdb5ae768eaf432ba543fc3f832c261dc2756242ba1855"
},
"downloads": -1,
"filename": "skais_mapper-0.1.8-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl",
"has_sig": false,
"md5_digest": "c282c26a2f5315908fd0431bf555f9be",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.10",
"size": 859409,
"upload_time": "2025-08-18T20:42:26",
"upload_time_iso_8601": "2025-08-18T20:42:26.199219Z",
"url": "https://files.pythonhosted.org/packages/74/6b/6fa64d38d0c6e15190ddd7c85c8d47d0f2ff017d8f0925d977d2c4ae3e97/skais_mapper-0.1.8-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ee7ce0600dd49761c4e4b9a74c4e81bcc3d0fe090ca24d70d6f819bbd0d4c1a5",
"md5": "b7e113a59f33bb0f6f431760390fd0e7",
"sha256": "c48143b0a55c75c87386ea1214bc8578053e05c26ad9a51d342844ef304e229a"
},
"downloads": -1,
"filename": "skais_mapper-0.1.8-cp310-cp310-musllinux_1_2_x86_64.whl",
"has_sig": false,
"md5_digest": "b7e113a59f33bb0f6f431760390fd0e7",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.10",
"size": 863762,
"upload_time": "2025-08-18T20:42:28",
"upload_time_iso_8601": "2025-08-18T20:42:28.123965Z",
"url": "https://files.pythonhosted.org/packages/ee/7c/e0600dd49761c4e4b9a74c4e81bcc3d0fe090ca24d70d6f819bbd0d4c1a5/skais_mapper-0.1.8-cp310-cp310-musllinux_1_2_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "46ff5a5271bb541c2cc81eb8ec9548c7bed2acde274b96fc8067a950b20b06ec",
"md5": "73c1c1ce3666aaa967a239461ec95899",
"sha256": "a455e982d17b31692a3610eb83bde55b6de7f09d8bbaa04adbc40a8f6ede2c2d"
},
"downloads": -1,
"filename": "skais_mapper-0.1.8-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl",
"has_sig": false,
"md5_digest": "73c1c1ce3666aaa967a239461ec95899",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.10",
"size": 898841,
"upload_time": "2025-08-18T20:42:29",
"upload_time_iso_8601": "2025-08-18T20:42:29.594645Z",
"url": "https://files.pythonhosted.org/packages/46/ff/5a5271bb541c2cc81eb8ec9548c7bed2acde274b96fc8067a950b20b06ec/skais_mapper-0.1.8-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "56d3898852d99a6a0af813225d398fb1a2b0f8eceac8fce7bf92d283c86f652e",
"md5": "cbe45e4fdc8f664a761718c10e953c88",
"sha256": "0f30bc4e719f3616950801ad15d319167273456603212abb8f48cee73b51dd39"
},
"downloads": -1,
"filename": "skais_mapper-0.1.8-cp311-cp311-musllinux_1_2_x86_64.whl",
"has_sig": false,
"md5_digest": "cbe45e4fdc8f664a761718c10e953c88",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.10",
"size": 904343,
"upload_time": "2025-08-18T20:42:31",
"upload_time_iso_8601": "2025-08-18T20:42:31.114678Z",
"url": "https://files.pythonhosted.org/packages/56/d3/898852d99a6a0af813225d398fb1a2b0f8eceac8fce7bf92d283c86f652e/skais_mapper-0.1.8-cp311-cp311-musllinux_1_2_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5373c0bfd306d58d11e513192c6fe4126af32b8b3c908bda5ba48b8ab9409409",
"md5": "6f52aa557cca793a93f09200360011fe",
"sha256": "51b115942ba96bd2d1fd309a602a974a57d024f2db8971f750e541c082799e50"
},
"downloads": -1,
"filename": "skais_mapper-0.1.8-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl",
"has_sig": false,
"md5_digest": "6f52aa557cca793a93f09200360011fe",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.10",
"size": 894249,
"upload_time": "2025-08-18T20:42:32",
"upload_time_iso_8601": "2025-08-18T20:42:32.645719Z",
"url": "https://files.pythonhosted.org/packages/53/73/c0bfd306d58d11e513192c6fe4126af32b8b3c908bda5ba48b8ab9409409/skais_mapper-0.1.8-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b74555d9b06912c0f742c93a4e36dbd74b1be02238414be369bfa5b7144266fd",
"md5": "3332a1d5b77d2cb0682b2ec769a74f7b",
"sha256": "2d809a49b56f33213ad925824b0c32a0ac66608c555253ddd4bb79e12e493e4a"
},
"downloads": -1,
"filename": "skais_mapper-0.1.8-cp312-cp312-musllinux_1_2_x86_64.whl",
"has_sig": false,
"md5_digest": "3332a1d5b77d2cb0682b2ec769a74f7b",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.10",
"size": 898273,
"upload_time": "2025-08-18T20:42:34",
"upload_time_iso_8601": "2025-08-18T20:42:34.031686Z",
"url": "https://files.pythonhosted.org/packages/b7/45/55d9b06912c0f742c93a4e36dbd74b1be02238414be369bfa5b7144266fd/skais_mapper-0.1.8-cp312-cp312-musllinux_1_2_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5f644cf065c05c7c606019a650a1afa4adf79dfa03b343513f1c45f1c052448f",
"md5": "ba31f8e11c420811c0d8e2c024be79fb",
"sha256": "49ada26ce43a3bbd0694e4077b1be63de712469ffe11d499ddbfee3a907b95ea"
},
"downloads": -1,
"filename": "skais_mapper-0.1.8.tar.gz",
"has_sig": false,
"md5_digest": "ba31f8e11c420811c0d8e2c024be79fb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 267074,
"upload_time": "2025-08-18T20:42:35",
"upload_time_iso_8601": "2025-08-18T20:42:35.439099Z",
"url": "https://files.pythonhosted.org/packages/5f/64/4cf065c05c7c606019a650a1afa4adf79dfa03b343513f1c45f1c052448f/skais_mapper-0.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-18 20:42:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "phdenzel",
"github_project": "skais-mapper#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "skais-mapper"
}
JSON
