nucleardatapy 1.0.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

nucleardatapy/fig/eos_setupAM_asy_lep_fig.py

@@ -5,19 +5,22 @@ import nucleardatapy as nuda
 
 def eos_setupAM_e2a_asy_lep_fig( pname, micro_mbs, pheno_models, asy, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the leptonic contribution to the energy per nucleon in asymmetric matter controlled by the variable `asy` (defined as (N-Z)/A).
+
+    The plot is 1x2 with:
+
+    [0]: microscopic models. [1]: phenomenologic models.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param asy: asymmetry parameter defined as (N-Z)/A.
+    :type asy: real.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')
@@ -126,19 +129,22 @@ def eos_setupAM_e2a_asy_lep_fig( pname, micro_mbs, pheno_models, asy, band ):
 
 def eos_setupAM_pre_asy_lep_fig( pname, micro_mbs, pheno_models, asy, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the leptonic contribution to the pressure in asymmetric matter controlled by the variable `asy` (defined as (N-Z)/A).
+
+    The plot is 1x2 with:
+
+    [0]: microscopic models. [1]: phenomenologic models.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param asy: asymmetry parameter defined as (N-Z)/A.
+    :type asy: real.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')
@@ -247,19 +253,22 @@ def eos_setupAM_pre_asy_lep_fig( pname, micro_mbs, pheno_models, asy, band ):
 
 def eos_setupAM_cs2_asy_lep_fig( pname, micro_mbs, pheno_models, asy, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the leptonic contribution to the square of the sound speed in asymmetric matter controlled by the variable `asy` (defined as (N-Z)/A).
+
+    The plot is 1x2 with:
+
+    [0]: microscopic models. [1]: phenomenologic models.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param asy: asymmetry parameter defined as (N-Z)/A.
+    :type asy: real.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')

nucleardatapy/fig/eos_setupAM_asy_nuc_fig.py

@@ -5,19 +5,22 @@ import nucleardatapy as nuda
 
 def eos_setupAM_e2a_asy_nuc_fig( pname, micro_mbs, pheno_models, asy, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the nucleon contribution to the energy per nucleon in asymmetric matter controlled by the variable `asy` (defined as (N-Z)/A).
+
+    The plot is 1x2 with:
+
+    [0]: microscopic models. [1]: phenomenologic models.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param asy: asymmetry parameter defined as (N-Z)/A.
+    :type asy: real.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')
@@ -116,19 +119,22 @@ def eos_setupAM_e2a_asy_nuc_fig( pname, micro_mbs, pheno_models, asy, band ):
 
 def eos_setupAM_pre_asy_nuc_fig( pname, micro_mbs, pheno_models, asy, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the nucleon contribution to the pressure in asymmetric matter controlled by the variable `asy` (defined as (N-Z)/A).
+
+    The plot is 1x2 with:
+
+    [0]: microscopic models. [1]: phenomenologic models.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param asy: asymmetry parameter defined as (N-Z)/A.
+    :type asy: real.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')
@@ -227,19 +233,22 @@ def eos_setupAM_pre_asy_nuc_fig( pname, micro_mbs, pheno_models, asy, band ):
 
 def eos_setupAM_cs2_asy_nuc_fig( pname, micro_mbs, pheno_models, asy, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the nucleon contribution to the square of the sound speed in asymmetric matter controlled by the variable `asy` (defined as (N-Z)/A).
+
+    The plot is 1x2 with:
+
+    [0]: microscopic models. [1]: phenomenologic models.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param asy: asymmetry parameter defined as (N-Z)/A.
+    :type asy: real.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')

nucleardatapy/fig/eos_setupAM_asy_tot_fig.py

@@ -5,19 +5,22 @@ import nucleardatapy as nuda
 
 def eos_setupAM_e2a_asy_tot_fig( pname, micro_mbs, pheno_models, asy, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the total (nucleon+leptonic) contribution to the energy per nucleon in asymmetric matter controlled by the variable `asy` (defined as (N-Z)/A).
+
+    The plot is 1x2 with:
+
+    [0]: microscopic models. [1]: phenomenologic models.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param asy: asymmetry parameter defined as (N-Z)/A.
+    :type asy: real.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')
@@ -118,19 +121,22 @@ def eos_setupAM_e2a_asy_tot_fig( pname, micro_mbs, pheno_models, asy, band ):
 
 def eos_setupAM_pre_asy_tot_fig( pname, micro_mbs, pheno_models, asy, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the total (nucleon+leptonic) contribution to the pressure in asymmetric matter controlled by the variable `asy` (defined as (N-Z)/A).
+
+    The plot is 1x2 with:
+
+    [0]: microscopic models. [1]: phenomenologic models.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param asy: asymmetry parameter defined as (N-Z)/A.
+    :type asy: real.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')
@@ -231,19 +237,22 @@ def eos_setupAM_pre_asy_tot_fig( pname, micro_mbs, pheno_models, asy, band ):
 
 def eos_setupAM_cs2_asy_tot_fig( pname, micro_mbs, pheno_models, asy, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the total (nucleon+leptonic) contribution to the square of the sound speed in asymmetric matter controlled by the variable `asy` (defined as (N-Z)/A).
+
+    The plot is 1x2 with:
+
+    [0]: microscopic models. [1]: phenomenologic models.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param asy: asymmetry parameter defined as (N-Z)/A.
+    :type asy: real.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')

nucleardatapy/fig/eos_setupAM_fig.py

@@ -5,19 +5,24 @@ import nucleardatapy as nuda
 
 def eos_setupAM_e2a_fig( pname, micro_mbs, pheno_models, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the nucleon, lepton and total (nucleon+leptonic) contribution to the energy per nucleon in asymmetric matter.
+
+    The plot is 2x3 with:
+
+    [0,0]: microscopic models (nucleon).  [0,1]: phenomenologic models (nucleon).
+
+    [1,0]: microscopic models (lepton).   [1,1]: phenomenologic models (lepton).
+
+    [2,0]: microscopic models (total).    [2,1]: phenomenologic models (total).
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')
@@ -174,19 +179,24 @@ def eos_setupAM_e2a_fig( pname, micro_mbs, pheno_models, band ):
 
 def eos_setupAM_pre_fig( pname, micro_mbs, pheno_models, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the nucleon, lepton and total (nucleon+leptonic) contribution to the pressure in asymmetric matter.
+
+    The plot is 2x3 with:
+
+    [0,0]: microscopic models (nucleon).  [0,1]: phenomenologic models (nucleon).
+
+    [1,0]: microscopic models (lepton).   [1,1]: phenomenologic models (lepton).
+
+    [2,0]: microscopic models (total).    [2,1]: phenomenologic models (total).
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')
@@ -343,19 +353,24 @@ def eos_setupAM_pre_fig( pname, micro_mbs, pheno_models, band ):
 
 def eos_setupAM_cs2_fig( pname, micro_mbs, pheno_models, band ):
     """
-    Plot nuclear chart (N versus Z).\
-    The plot is 1x2 with:\
-    [0]: nuclear chart.
+    Plot the nucleon, lepton and total (nucleon+leptonic) contribution to the square of the sound speed in asymmetric matter.
+    
+    The plot is 2x3 with:
+
+    [0,0]: microscopic models (nucleon).  [0,1]: phenomenologic models (nucleon).
+
+    [1,0]: microscopic models (lepton).   [1,1]: phenomenologic models (lepton).
+
+    [2,0]: microscopic models (total).    [2,1]: phenomenologic models (total).
 
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param micro_mbs: array with names of many-body framework for microscopic interactions.
+    :type micro_mbs: array of str.
+    :param pheno_models: array of interaction names for phenomenologic interactions.
+    :type pheno_models: array of str.
+    :param band: object instantiated on the reference band.
+    :type band: object.
     """
     #
     print(f'Plot name: {pname}')

nucleardatapy/fig/eos_setupCC_fig.py

@@ -5,18 +5,24 @@ import nucleardatapy as nuda
 
 def eos_setupCC_eos_fig( pname, band, crust_model, core_kind, core_model, core_param ):
     """
-    Plot the EoS with crust and core parts.\
+    Plot the EoS with crust and core parts.
+
     The plot is 1x1.
 
+    [0]: pressure as a function of the energy density.
+
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param band: object instantiated on the reference band.
+    :type band: object.
+    :param crust_model: the name of the crust model.
+    :type crust_model: str.
+    :param core_kind: the kind of the core model ('micro' or 'pheno').
+    :type core_kind: str.
+    :param core_model: the name of the core model.
+    :type core_model: str.
+    :param core_param: the parameters of the core model.
+    :type core_param: str.
     """
     #
     print(f'Plot name: {pname}')
@@ -91,18 +97,30 @@ def eos_setupCC_eos_fig( pname, band, crust_model, core_kind, core_model, core_p
 
 def eos_setupCC_checkpre_fig( pname, band, crust_model, core_kind, core_model, core_param, connect, boundaries, emp ):
     """
-    Plot the EoS with crust and core parts.\
+    Check the EoS with crust and core parts.
+
     The plot is 1x1.
 
+    [0]: pressure and band to check visualy.
+
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param band: object instantiated on the reference band.
+    :type band: object.
+    :param crust_model: the name of the crust model.
+    :type crust_model: str.
+    :param core_kind: the kind of the core model ('micro' or 'pheno').
+    :type core_kind: str.
+    :param core_model: the name of the core model.
+    :type core_model: str.
+    :param core_param: the parameters of the core model.
+    :type core_param: str.
+    :param connect: The thermodynamic quantity employed to connect the crust and the core. Can be: 'density', 'epsilon' (energy density) or 'pressure'.
+    :type connect: str.
+    :param boundaries: array with lower and upper boundaries to consider. Connected to the variable `connect`. For instance boundaries = [ 0.016, 0.16 ] for 'density' (in units of fm-3), boundaries = [ 15.0, 150.0 ] for 'epsilon' (in units of MeV fm-3), or boundaries = [ 0.1, 1.0 ] for pressure (in units of MeV fm-3).
+    :type boundaries: array of real.
+    :param emp: way to connect the crust and the core. Can be: 'None', 'simple', 'Steiner'.
+    :type emp: str.
     """
     #
     print(f'Plot name: {pname}')
@@ -166,18 +184,30 @@ def eos_setupCC_checkpre_fig( pname, band, crust_model, core_kind, core_model, c
 
 def eos_setupCC_checkeos_fig( pname, band, crust_model, core_kind, core_model, core_param, connect, boundaries, emp ):
     """
-    Plot the EoS with crust and core parts.\
+    Check the EoS with crust and core parts.
+
     The plot is 1x1.
 
+    [0]: pressure and band to check visualy.
+
     :param pname: name of the figure (*.png)
     :type pname: str.
-    :param table: table.
-    :type table: str.
-    :param version: version of table to run on.
-    :type version: str.
-    :param theo_tables: object instantiated on the reference band.
-    :type theo_tables: object.
-
+    :param band: object instantiated on the reference band.
+    :type band: object.
+    :param crust_model: the name of the crust model.
+    :type crust_model: str.
+    :param core_kind: the kind of the core model ('micro' or 'pheno').
+    :type core_kind: str.
+    :param core_model: the name of the core model.
+    :type core_model: str.
+    :param core_param: the parameters of the core model.
+    :type core_param: str.
+    :param connect: The thermodynamic quantity employed to connect the crust and the core. Can be: 'density', 'epsilon' (energy density) or 'pressure'.
+    :type connect: str.
+    :param boundaries: array with lower and upper boundaries to consider. Connected to the variable `connect`. For instance boundaries = [ 0.016, 0.16 ] for 'density' (in units of fm-3), boundaries = [ 15.0, 150.0 ] for 'epsilon' (in units of MeV fm-3), or boundaries = [ 0.1, 1.0 ] for pressure (in units of MeV fm-3).
+    :type boundaries: array of real.
+    :param emp: way to connect the crust and the core. Can be: 'None', 'simple', 'Steiner'.
+    :type emp: str.
     """
     #
     print(f'Plot name: {pname}')

nucleardatapy/fig/hnuc_setupChart_fig.py

@@ -3,29 +3,26 @@ import matplotlib.pyplot as plt
 
 import nucleardatapy as nuda
 
-def hnuc_setupChart_fig( pname, table1L, table2L, table1Xi ):
+def hnuc_setupChart_fig( pname, tables1L, tables2L, tables1Xi ):
     """
-    Plot hyper-nuclear chart (N versus Z).\
-    The plot is 1x1 with:\
+    Plot hyper-nuclear chart (N versus Z).
+
+    The plot is 1x1 with:
+
     [0]: nuclear chart.
 
     :param pname: name of the figure (*.png)
     :type pname: str.
     :param table1L: table.
-    :type table1L: str.
+    :type table1L: array of str.
     :param table2L: table.
-    :type table2L: str.
+    :type table2L: array of str.
     :param table1Xi: table.
-    :type table1Xi: str.
-
+    :type table1Xi: array of str.
     """
     #
     print(f'Plot name: {pname}')
     #
-    hnuc1L = nuda.hnuc.setupRE1LExp( table = table1L )
-    hnuc2L = nuda.hnuc.setupRE2LExp( table = table2L )
-    hnuc1Xi = nuda.hnuc.setupRE1XiExp( table = table1Xi )
-    #
     # plot
     #
     fig, axs = plt.subplots(1,1)
@@ -39,9 +36,15 @@ def hnuc_setupChart_fig( pname, table1L, table2L, table1Xi ):
     axs.set_xlim([0.8, 140])
     axs.set_ylim([0.8, 90.0])
     #
-    axs.scatter( hnuc1L.N,      hnuc1L.Z,      marker='s', s=12, color=nuda.param.col[0], label=r'1$\Lambda$ from table '+table1L )
-    axs.scatter( hnuc2L.N+0.05, hnuc2L.Z+0.05, marker='s', s=12, color=nuda.param.col[1], label=r'2$\Lambda$ from table '+table2L )
-    axs.scatter( hnuc1Xi.N+0.1, hnuc1Xi.Z+0.1, marker='s', s=12, color=nuda.param.col[2], label=r'1$\Xi^{-}$ from table '+table1Xi )
+    for table1L in tables1L:
+        hnuc1L = nuda.hnuc.setupRE1LExp( table = table1L )
+        axs.scatter( hnuc1L.N,      hnuc1L.Z,      marker='s', s=12, color=nuda.param.col[0], label=r'1$\Lambda$ from table '+table1L )
+    for table2L in tables2L:
+        hnuc2L = nuda.hnuc.setupRE2LExp( table = table2L )
+        axs.scatter( hnuc2L.N+0.05, hnuc2L.Z+0.05, marker='s', s=12, color=nuda.param.col[1], label=r'2$\Lambda$ from table '+table2L )
+    for table1Xi in tables1Xi:
+        hnuc1Xi = nuda.hnuc.setupRE1XiExp( table = table1Xi )
+        axs.scatter( hnuc1Xi.N+0.1, hnuc1Xi.Z+0.1, marker='s', s=12, color=nuda.param.col[2], label=r'1$\Xi^{-}$ from table '+table1Xi )
     #
     #axs.text(0.15,12,r'$K_{sym}$='+str(int(Ksym))+' MeV',fontsize='12')
     axs.legend(loc='lower right',fontsize='11',ncol=1)

nucleardatapy/fig/hnuc_setupRE1LExp_fig.py

@@ -4,8 +4,18 @@ import matplotlib.pyplot as plt
 import nucleardatapy as nuda
 
 def hnuc_setupRE1LExp_fig( pname, tables ):
-    #
-    # plot
+    """
+    Plot the removal energies as a function of A^{-2/3}.
+
+    The plot is 1x1 with:
+
+    [0]: nuclear chart.
+
+    :param pname: name of the figure (*.png)
+    :type pname: str.
+    :param tables: table.
+    :type tables: str.
+    """
     #
     fig, axs = plt.subplots(1,1)
     fig.tight_layout() # Or equivalently,  "plt.tight_layout()"