Project publication
Every astrophysicist in the scientific community is invited to contribute to the Galactica database. The Galactica web application allows scientists to publish online all the meta-information related to their numerical projects, upload lightweight products (images, plots, spectrum, datacubes, tabulated data, ...) and distribute object catalogs identified in their numerical models.
To meet very specific needs expressed by other research groups, you can also provide access to massive raw simulation data produced by your simulation codes. For more details, see :
Editor user account
To publish a simulation project, a user account with edition privileges (Numerical scientist profile) is necessary :
Once authenticated, you will have access to an administration interface where you could :
- create a new project,
- add simulations,
- include simulation snapshots,
- attach datafiles,
- define target object parameters and publish object catalogs,
- describe the numerical code configuration,
- document the modelisation setup,
- document your analysis results in finer details.
You can even import your project documentation created offline and import it on the Galactica web application with a single click. For more details, see project publication API.
Can I test it in "draft" mode ?
YES. Every project on Galactica is in a "private" state upon creation. A private project is only visible by :
- its creator,
- authenticated users who are explicitly listed as members of the collaboration by the project creator,
- Galactica administrator.
Consequently, you can safely use Galactica as a collaborative environment to document your project with
your scientific collaborators, as you would write a paper draft before submission to journal reviewers. Different
collaborators could contribute to separate parts of the project content until you are ready for publication.
Once satisfied with the content of your project pages, you can change the status of your project in "published" mode.
Once published, your project pages will be visible by everyone.
Can I document my project offline and then update the project pages with an API ?
Some simulation projects may involve many collaborators, a large set of numerical simulations, several simulation codes, a large sample of simulation snapshots, each one attached to a set of datafiles. They can contain many object catalogs, each catalog referencing thousands of objects. In such cases, the use of the online administration interface to edit the content of all the associated project pages can prove cumbersome.
To offer the possibility to automate this project publication process, a dedicated Python API called astrophysix has been developed. You are free to integrate this API into your scientific analysis pipeline to generate the project documentation alongside the production of scientific results.
To generate the documentation offline using the astrophysix API, here is a very simple Python code snippet, illustrating the creation of the Extreme Horizons project:
#!/usr/bin/env python3
from astrophysix.simdm import SimulationStudy, Project, ProjectCategory
# Create a project
proj = Project(category=ProjectCategory.Cosmology, alias="EXTREME_HORIZONS", project_title="Extreme Horizons cosmology project",
short_description="Extreme Horizons project short description...",
general_description="""<p>The Extreme Horizon cosmological simulation of our universe is [...]</p>""")
# Set project in study and export the study in HDF5 file
study = SimulationStudy(project=proj)
study.save_HDF5("./study.h5")
This simple script creates a study.h5 HDF5 file that can be imported on the Galactica administration
interface to instantly deploy a project page (and possibly all the associated simulation, code, snapshot, result
and object catalog pages) on the Galactica web application.
Project permanent and unique url
The project page in our example is then accessible at the url galactica-simulations.eu/db/COSMOLOGY/EXTREME_HORIZONS.
Here the COSMOLOGY part of the URL stands for the project category, and EXTREME_HORIZONS
is the project unique identifier in that category (alias set in the python script). The Galactica
application guarantees that this address, which is the access point to your project page, is a unique and permanent url.
It is therefore safe to use it in any future communication or publication to reference your project.
For more information on the astrophysix python API, see the .
What about my project acknowledgement ?
Either in the online administration interface or using the astrophysix python API, you can
provide instructions on how to acknowledge your project by filling the acknowledgement
property of your project. This property will be displayed when the Cite me banner (see an exemple opposite),
visible in the upper right corner of your project page, will be clicked.
Here is a python script example on how to define this property for the Extreme Horizons project :
#!/usr/bin/env python3
from astrophysix.simdm import SimulationStudy, Project, ProjectCategory
proj = Project(category=ProjectCategory.Cosmology, alias="EXTREME_HORIZONS", project_title="Extreme Horizons cosmology project",
short_description="[...]",
general_description="""<p>[...]</p>""",
acknowledgement="""<p>To acknowledge this project, please cite [<a href="https://doi.org/10.1051/0004-6361/202038614"
target="_blank">Chabanier et al. 2020</a>]:</p>
<div>
<pre>
@ARTICLE{2020A&A...643L...8C,
author = {{Chabanier}, S. and {Bournaud}, F. and {Dubois}, Y. and {Codis}, S. and {Chapon}, D. and {Elbaz}, D. and {Pichon}, C. and
{Bressand}, O. and {Devriendt}, J. and {Gavazzi}, R. and {Kraljic}, K. and {Kimm}, T. and {Laigle}, C. and {Lekien}, J. -B. and
{Martin}, G. and {Palanque-Delabrouille}, N. and {Peirani}, S. and {Piserchia}, P. -F. and {Slyz}, A. and {Trebitsch}, M. and
{Yèche}, C.},
title = "{Formation of compact galaxies in the Extreme-Horizon simulation}",
journal = {\aap},
keywords = {galaxies: formation, galaxies: evolution, galaxies: high-redshift, galaxies: structure, methods: numerical, Astrophysics - Astrophysics of Galaxies},
year = 2020,
month = nov,
volume = {643},
eid = {L8},
pages = {L8},
doi = {10.1051/0004-6361/202038614},
archivePrefix = {arXiv},
eprint = {2007.04624},
primaryClass = {astro-ph.GA},
adsurl = {https://ui.adsabs.harvard.edu/abs/2020A&A...643L...8C}
}
</pre>
</div>""")
Need support ?
If you need support to help you publish your project on the Galactica simulation database, please contact the technical support team.
