Commit 1dd183a8 authored by Dario Del Moro's avatar Dario Del Moro
Browse files

Update usage.rst

parent 6391fadb
CAESAR
=====
.. _intro:
The Italian Space Agency (ASI) funds the CAESAR_ (Comprehensive spAce wEather Studies for the ASPIS prototype Realization) project.
The project, officially started on December 21st and lasting 25 months, responds to a call created by the agreement between ASI and the National Institute of Astrophysics (INAF) aimed at carrying out "Study activities for the scientific community of Space Weather for population of the ASPIS scientific data center ".
------------
.. _project
The project
----------------
The aim of the project is the creation, within the ASI Space Science Data Center, of a scientific center for the collection, processing and distribution of Space Weather data to the Italian scientific community, called ASPIS_ (ASI Space Weather Infrastructure).
CAESAR_ will design and build a prototype of ASPIS_ populated with high scientific level data and products.
Space Weather encompasses the set of physical conditions of the Sun, the Sun-Earth space, and the circumterrestrial environment that can have effects on the technological and biological systems of our planet.
The study of these phenomena is now indispensable, as our civilization is extremely technological and increasingly dependent on the services offered by the thousands of satellites in orbit (half of which guarantee telecommunications throughout the globe) and infrastructure Earth (e.g. electricity grids) and with a small "colony" that lives permanently in space (e.g. in the International Station).
An ever deeper knowledge of these processes and the impact they may have on technology and human health is essential to be able to predict them well in advance, in order to secure the infrastructures and the people potentially involved.
The CAESAR_ project is structured in such a way as to cover all the fundamental issues involved in Space Weather: the Physics of the Sun, the Sun-Earth interaction, Geomagnetism, magnetosphere-ionosphere coupling and the Physics of the earth's upper atmosphere, the effects of Space Weather on the planets of the Solar System, the Physics of Galactic Cosmic Rays and the impact of Space Weather on technological and biological systems.
CAESAR_ involves over 75 scientists from Universities and Research Bodies throughout Italy (University of Rome Tor Vergata, University of Catania, University of Genoa, University of Calabria, University of Trento, University of L'Aquila, University of Perugia, ASI, INAF, National Institute of Nuclear Physics, National Institute of Geophysics and Vulcanonlogy), as well as personnel belonging to some international research centers.
This is a very important opportunity for the creation of a permanent national infrastructure that will collect data and products related to Space Weather.
.. _CAESAR: https://caesar.iaps.inaf.it/
Usage
=====
.. _installation:
Installation
------------
To use Lumache, first install it using pip:
.. code-block:: console
(.venv) $ pip install lumache
Creating recipes
----------------
To retrieve a list of random ingredients,
you can use the ``lumache.get_random_ingredients()`` function:
.. autofunction:: lumache.get_random_ingredients
The ``kind`` parameter should be either ``"meat"``, ``"fish"``,
or ``"veggies"``. Otherwise, :py:func:`lumache.get_random_ingredients`
will raise an exception.
.. autoexception:: lumache.InvalidKindError
For example:
>>> import lumache
>>> lumache.get_random_ingredients()
['shells', 'gorgonzola', 'parsley']
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment