Add docstrings to subpackages

.mailmap

@@ -223,3 +223,8 @@ Youssef Eweis <[email protected]> Youssef Eweis <[email protected]
 Rohith Varma Buddaraju <[email protected]>
 Rohith Varma Buddaraju <[email protected]> rohithvarma3000 <[email protected]>
 Rohith Varma Buddaraju <[email protected]> Rohith <[email protected]>
+
+Le Truong <[email protected]>
+
+Kim Lingemann <[email protected]> kimsina <[email protected]>
+Kim Lingemann <[email protected]> kim <[email protected]>

tardis/analysis.py

@@ -1,4 +1,6 @@
-# codes to for analyse the model.
+"""
+Code to analyse the model.
+"""
 
 import re
 import os

tardis/base.py

@@ -1,4 +1,6 @@
-# Functions that are important for the general usage of TARDIS.
+"""
+Functions that are important for the general usage of TARDIS.
+"""
 
 import logging
 

tardis/grid/__init__.py

@@ -1 +1,7 @@
+"""
+Storing a grid of TARDIS parameters that 
+facilitates running large numbers of 
+simulations easily.
+"""
+
 from tardis.grid.base import *

tardis/gui/__init__.py

@@ -0,0 +1,9 @@
+"""
+Creation of the basic framework for the TARDIS GUI.
+
+The data that should be displayed in the GUI is put into 
+respective data structures (either a tree or a table), such 
+that they can be used in the widgets. These widgets are 
+used to form the building blocks of the basic framework for
+the GUI.
+"""

tardis/io/__init__.py

@@ -1,3 +1,7 @@
+"""
+A collection of subpackages and submodules to handle input and output data. 
+"""
+
 # readin model_data
 from tardis.io.model_reader import (
     read_simple_ascii_density,

tardis/io/atom_data/__init__.py

@@ -1,2 +1,6 @@
+"""
+Getting and handling the atomic data. 
+"""
+
 from tardis.io.atom_data.base import AtomData
 from tardis.io.atom_data.atom_web_download import download_atom_data

tardis/io/logger/__init__.py

@@ -0,0 +1,3 @@
+"""
+Managing the logging output. 
+"""

tardis/io/parsers/__init__.py

@@ -1,3 +1,12 @@
+"""
+A collection of parsers to read data of different formats. 
+
+Accepted data formats are Arepo snapshots, the Blondin toy-model
+format, CSVY files and STELLA files. These are parsed into 
+either CSV files, YAML files or Pandas DataFrames, which are 
+data formats interpretable by TARDIS. 
+"""
+
 from tardis.io.parsers.blondin_toymodel import (
     read_blondin_toymodel,
     convert_blondin_toymodel,

tardis/model/__init__.py

@@ -1 +1,9 @@
+"""
+Holding information about the TARDIS model. 
+
+This includes information about the shell structure, 
+density, abundance, temperatures and dilution 
+factor of the model used in the simulation.
+"""
+
 from tardis.model.base import *

tardis/model/geometry/__init__.py

@@ -0,0 +1,10 @@
+"""
+Holding information about model geometry for radial 1D models.
+
+The information stored about the model are the following attributes:
+r_inner : The radius of the inner shell boundaries
+r_outer : The radius of the outer shell boundaries
+v_inner : The velocity of the inner boundaries of each shell
+v_outer : The velocity of the outer boundaries of each shell
+volume : Volume of each shell computed from r_outer and r_inner
+"""

tardis/montecarlo/__init__.py

@@ -1 +1,10 @@
+"""
+Faciliating the MonteCarlo iterations. 
+
+During a simulation run, a number of MonteCarlo iterations specified
+in the configuration are run using the numba compiler.
+Most of the iterations are used to calculate the steady-state plasma 
+properties and with the last iteration, the spectrum is determined.
+"""
+
 from tardis.montecarlo.base import *

tardis/montecarlo/montecarlo_numba/__init__.py

@@ -1,3 +1,7 @@
+"""
+Implements the main loop of the MonteCarlo routine.
+"""
+
 from llvmlite import binding
 
 binding.set_option("tmp", "-non-global-value-max-name-size=2048")

tardis/plasma/__init__.py

@@ -1 +1,5 @@
+"""
+Dealing with plasma properties and calculations related to it. 
+"""
+
 from tardis.plasma.base import BasePlasma

tardis/plasma/properties/__init__.py

@@ -1,3 +1,10 @@
+"""
+Store and calculate the properties of the plasma.
+
+Each plasma object has an array of properties which are then used to calculate plasma parameter values.
+Every property has a calculate function that returns the values of its outputs.
+"""
+
 from tardis.plasma.properties.atomic import *
 from tardis.plasma.properties.general import *
 from tardis.plasma.properties.ion_population import *

tardis/plasma/properties/util/__init__.py

@@ -1 +1,3 @@
-
+"""
+Calculating transition probabilities for macro_atom interactions.
+"""

tardis/scripts/__init__.py

@@ -0,0 +1,3 @@
+"""
+Translate cmfgen format to a format TARDIS can use.
+"""

tardis/simulation/__init__.py

@@ -1 +1,5 @@
+"""
+Handling simulation runs.
+"""
+
 from tardis.simulation.base import Simulation

tardis/stats/__init__.py

@@ -1 +1,3 @@
-
+"""
+Providing Poisson statistics that govern the MonteCarlo processes.
+"""

tardis/transport/__init__.py

@@ -1 +1,3 @@
-
+"""
+Handling the packet propagation.
+"""

tardis/transport/geometry/__init__.py

@@ -1 +1,3 @@
-
+"""
+Calculating distances.
+"""

tardis/util/__init__.py

@@ -1 +1,3 @@
-# Utilities for TARDIS
+"""
+Utilities for TARDIS.
+"""