\section{Installation}\index{installation}
\subsection{Structure de la source}\index{source}\index{exploit}
Le package \cesam2k se compose des sous-directory~:
\index{sun\_star\_data}
\begin{enumerate}
\item {\tt EXPLOIT}~: ensemble de programmes et d'exemples de fichiers pour
 l'exploitation. On en trouve une description au \paragr{sec:expl}, et 
 la liste au \paragr{sec:aexp}. Le sous-directory {\tt EXPLOIT}
 occupe de l'ordre de 40Ko,
\item {\tt NOTICE}~: sources \LaTeX, fichiers
 postscript (1.6Mo) et pdf (3Mo) de la notice d'utilisation et de
 l'aide mémoire. On en trouve une description au \paragr{sec:noti}, et 
 la liste au \paragr{sec:anoti}.
\item {\tt SCRIPTS}~: procédure UNIX/LINUX pour l'installation et 
 l'exploitation. On en trouve la liste avec une description au
 \paragr{sec:ascri}.
\item {\tt SOURCE}~: rassemble les routines mathématiques décrites
 au \paragr{sec:sspn} et les routines spécifiques à {\sc cesam2k}
 décrites au \paragr{cha:ssp}; on en trouvera une liste complète au
 \paragr{sec:asce}. Ces routines sont regroupéees dans des
 {\sc modules}\footnote{La notion de
 {\sc module} en {\sc fortran90/95} est succintement décrite au
 \paragr{sec:mod}.} suivant leur fonctionalité. Le sous-directory
 {\tt SOURCE} occupe de l'ordre de 30Mo. 
\item {\tt SUN\_STAR\_DATA}~: données physiques, tables d'EOS par exemple.
 On en trouve une description au \paragr{cha:pext}, et 
 la liste au \paragr{sec:assd}.
 {\tt SUN\_STAR\_DATA} occupe de l'ordre de  46Mo, dont la majeure partie
 est prise par les données de l'équation d'état OPAL. 
\item {\tt TESTS}~: programmes de test. On en trouve une description
 au \paragr{sec:test}, et la liste au \paragr{sec:atest}.
\end{enumerate}

\subsection{Création des modules exécutables}\index{module exécutable}
Il faut d'abord décompresser et "détarer"la source~:
{\tt tar -xzvf CESAM2k.tar.gz}
\index{libcesam2k.a}
\noindent Pour l'exploitation de {\sc cesam2k} sous {\sc unix/linux} il est
pratique de créer,
dans le sous-directory {\tt SOURCE}, 
une bibliothèque partageable de nom, par exemple~:
\centerline{\sf libcesam2k.a.}
Cette bibliothèque nécessite de l'ordre de 2.2Mo.
Une fois le module exécutable créé, la
bibliothèque est aussi utilisée par certains programmes d'exploitation
et de tests, il est donc utile de la conserver.

\subsection{Compilateur}\index{unix}\index{linux}\index{windows}
\index{compilation}\index{ifc}\index{lf95}\index{compact visual fortan}
{\sc cesam2k} est écrit en {\sc fortran90/95}. Pour des
routines d'origine externe l'investissement nécessaire
pour venir à bout de structures de programmation en
{\sc fortran66}, s'est avéré trop important et la transformation n'est
effectuée qu'en partie. Les
compilateurs {\sc fortran95} acceptent, en principe, ces anciennes
structures sans trop de difficulté. Les compilateurs suivants ont été
utilisés avec succ\`es
\begin{itemize}
\item sous {\sc linux}~: Lahey-Fujitsu {\tt lf95}, Intell {\tt ifc}
\item sous {\sc unix}~: le compilateur des machines ALPHA
\item sous {\sc windows}~: Compact Visual Fortran
\end{itemize}
Incontestablement, comme pour les versions antérieures de {\sc cesam},
le système d'exploitation
le plus pratique est {\sc unix/linux} en raison de possibilité d'utiliser
des procédures. Sous {\sc windows} on a utilisé le
compilateur de Compact "Visual Fortran".
%L'expérience a montré qu'il était utile, avant de tenter cette
%aventure, de remettre en mémoire ses jurons favoris, de s'entrainer à 
%taper rageusement des pieds et qu'il n'est pas inutile, non plus, 
%d'être capable de lever fréquemment
%les bras vers le ciel avec de grands soupirs de désespoir.
On ne décrit ci-dessous que la gestion sous {\sc unix/linux (cshell)} avec
utilisation d'une bibliothèque.

\subsection{Disponibilité de {\sc PGPLOT}}\index{PGPLOT}\label{sec:npgplot}
{\sc cesam2k} offre la possibilité de visualiser ``on line''
l'évolution de certaines
grandeurs, les abondances, par exemple. Le tracé utilise le logiciel 
{\sc pgplot}. Avec son mode d'emploi, ce logiciel
 est téléchargeable via {\tt anonymous ftp} \`a l'adresse~:\par
 \noi{\tt http://astro.caltech.edu/$\sim$tpj/pgplot/.}\par
 \noi En suivant les
 instructions du README, créer les bibliothèques de ce logiciel
 et indiquer le chemin d'accès dans le fichier {\sf .cshrc}~:\par
 \noi{\tt setenv PGPLOT\_DIR /usr/local/pgplot.}\par
  
 \noi A défaut, du logiciel de dessin {\sc pgplot}, dans le sous-directory
 {\tt SOURCE}~:
 \begin{enumerate}
 \item Supprimer les routines {\sf des\_r.f} et {\sf des\_m.f} de la liste des
  {\tt INCLUDE} du module {\sf mod\_cesam.f}. 
  \item Supprimer les routines {\sf box.f} et {\sf boite.f} de la liste des
  {\tt INCLUDE} du module {\sf mod\_numerique.f}. 
 \item Dans la subroutine {\sf des.f} ne conserver que  
  {\tt CASE ('no\_des')} et {\tt CASE DEFAULT}.
 \end{enumerate}
 
 \medskip\index{ifc}\index{PGPLOT}
 {\PB La source de PGPLOT ne contient pas le fichier de configuration pour le
 compilateur {\tt ifc} d'INTELL. Th.Corbard de l'OCA a construit ce fichier que
 l'on trouvera \paragr{sec:ifc} avec la description de son utilisation.}

\subsection{Compilation}\index{compilation}\label{sec:compil}
\index{mod\_kind}\index{mod\_numerique}\index{mod\_donnees}
\index{mod\_cesam}\index{mod\_etat}\index{mod\_opacite}\index{mod\_chim}
\index{mod\_quasi\_static}\index{mod\_sta\_chim}
La compilation, la formation de la bibliothèque d'exploitation et 
du module exécutable réside dans la compilation des modules dans l'ordre
donné dans le fichier {\sf list\_cesam2k} qu'il est
{\bf impératif} de respecter~:
\begin{enumerate}
 \item mod\_kind
 \item mod\_numerique
 \item mod\_donnees
 \item mod\_variables
 \item mod\_etat
 \item mod\_opa
 \item mod\_conv
 \item mod\_atm
 \item mod\_nuc
 \item mod\_evol
 \item mod\_static
 \item mod\_cesam 
 \item mod\_exploit 
\end{enumerate}
Une des raisons de cette contrainte est que les modules des niveaux
inférieurs
utilisent les variables définies dans les modules des niveaux supérieurs;
par exemple des quantités définies dans {\sf mod\_numerique} sont utilisées
dans {\sf mod\_evol}. La transmission de ces informations est effectuée
par les fichiers
d'extension {\sf .mod}  ({\sf mod\_kind.mod} par exemple) créés lors de la
compilation, voir aussi \paragr{sec:mod}; il est donc nécessaire
de laisser ces fichiers dans l'environnement.

\medskip

\noi Sous {\sc unix/linux} il est pratique d'utiliser des\index{csh}
procédures pour cette compilation. Par exemple, en {\sc csh} on pourra
utiliser la procédure {\sf compile2k}~:\index{procédure}
\index{compile2k}
\begin{tt}\begin{verbatim}
#
#* compile2k programme1 programme2 ... programme8
#* 
#* compilation de programmes fortran avec f95 avec formation
#* d'object module de noms programme1.o ... programme8.o
#*
echo 'compilation du/des programme/s:'
foreach i ($*)
 echo $i.f
 f95 -c -extend_source -error_limit 5 -fpconstant \
        -I/users/user2/morel/CESAM2k/SOURCE \
        -o $i.o -O5 -shared $i.f
end
\end{verbatim}\end{tt}
la source de {\sc cesam2k} est ici supposée se trouver dans le sous-directory:
\centerline{\tt /users/user2/morel/CESAM2k/SOURCE.}
\noindent Pour cette procédure et celles données ci-après, il convient
d'adapter, au cas par cas, le nom du compilateur et celles
des options utiliséees.
On trouvera toutes ces procédures dans le sous-directory {\sc SCRIPTS}
de la distribution.

\noi De même, il est pratique d'utiliser la
procédure {\sf compile2k\_list} pour
compiler et insérer automatiquement les {\tt object module}
dans la bibliothèque~:\index{bibliothèque}\index{compile2k\_list}
\begin{tt}\begin{verbatim}
#* compile2k_list biblio1 list
#*
#* script pour compiler et insérer dans une bibliothèque partageable
#* biblio1.a les object module ***.o correspondants aux routines
#* de la liste list
#*
#* suppression d'alias
#*
unalias rm
#*
 foreach i (`cat $argv[2]`)	#* compilation et mise dans la bibliotheque
  echo 'compilation de' $i.f
  compile2k $i
  lib_del_repl $argv[1] $i
 end
echo ' '
echo 'liste de la bibliotheque' $argv[1].a
ar t $argv[1].a
#*
\end{verbatim}\end{tt}
l'appel est alors~:

\centerline{\tt compile2k\_list libcesam2k list\_cesam2k}
\noindent il y a formation de la bibliothèque {\tt libcesam2k.a}
et insertion des
{\tt object module} correspondants aux routines
de la liste suivante écrite dans le fichier
{\sf list\_compil} du directory {\sc source}~:
\index{list\_cesam2k}
\begin{tt}\begin{verbatim}
 mod_kind.o
 mod_numerique.o
 mod_donnees.o
 mod_variables.o
 mod_etat.o
 mod_opa.o
 mod_conv.o
 mod_atm.o
 mod_nuc.o
 mod_evol.o
 mod_static.o
 mod_cesam.o
 mod_exploit.o 
\end{verbatim}\end{tt}

\noindent La procédure {\tt lib\_del\_repl} utiliséee ci-dessus
est la suivante~:\index{lib\_del\_repl}\label{sec:libd}
\begin{tt}\begin{verbatim}
#* lib_del_repl bibliotheque routine2 routine2 ... routine9
#*
#* script pour remplacer ou ajouter dans une bibliotheque.a 
#* les routine1.o ... routine9.o compilee
#*
unalias rm
echo dans la bibliotheque: $1.a
@ i = 2			#i demarre a 2
while ($i <= $#argv)		#pour tous les arguments
 echo  suppression de: $argv[$i]
 ar d  $1.a $argv[$i].o		# si oui suppression de routine.o
 echo  remplacement ou insertion de: $argv[$i]
 ar ru $1.a $argv[$i].o		# introduction de routine.o dans la bibliotheque
 rm $argv[$i].o	# suppression de routine.o 
# rm $argv[$i].l # suppression de routine.l
 @ i++		# i donne i+1
end
ranlib $1.a		# introduction de routine.o dans le directory
#*
\end{verbatim}\end{tt}

\section{Appel à {\sc cesam}}\index{mon\_modele.don}
L'appel \`a {\sc cesam2k} diffère de l'appel à {\sc cesam4} au sens
où le module exécutable est formé une fois pour toutes.
En plus des valeurs des variables physiques (Ex~: {\tt X0=0.70}),
le fichier de données ({\sf mon\_modele.don}) comporte
les noms des options physiques à utiliser
(Ex~: {\tt nom\_tdetau='edding'}).
Cette disposition a l'avantage de permettre une vérification de
la cohérence entre la physique d'un modèle repris et de celle
proposée pour celui à poursuivre; elle a l'inconvénient de nécessiter
un module exécutable de dimension plus importante que
dans les versions précédentes.

\noindent En se placant toujours dans le sous-directory {\tt SOURCE},
l'instruction~:

\centerline{\tt exe2k cesam2k}

\noindent qui fait appel à la procédure {\sf exe2k}\index{exe2k}
ci-dessous, permet d'exécuter
{\sc cesam2k} une première fois et de créer ainsi le module exécutable~:
\begin{tt}\begin{verbatim}
#*
#* exe2k program
#*
#* compilation/execution du programme en fortran95 program.f
#* utilisation du compilateur f95, formation d'un module executable
#* de nom progr.out
#* program.f nom du programme
f95 -extend_source -fpconstant\
        -I/users/user2/morel/CESAM2k/SOURCE \
        -error_limit 5 -O5 -o $1.out $1.f \
        -L/users/user2/morel/CESAM2k/SOURCE/ -lcesam2k \
        -L/users/user2/morel/v9/lib/ -lopint \
        -lpgplot -lX11 -lm -warning_unresolved
if ( $status != 0 )exit         #* on sort s'il y a eu Pb

#* execution

$1.out
\end{verbatim}\end{tt}
\noindent La bibliothèque {\tt libopint.a} du directory {\tt v9/lib}
 contient
les routines utilisées pour la détermination de l'opacité par la routine
{\sf opa\_houdek9}. Au cas ou le logiciel de tracé {\sc pgplot} est
indisponible, enlever {\tt -lpgplot} des instruction  du {\tt link}.

\noindent On trouvera un exemple de création du module
 exécutable \paragr{sec:btst}
Pour les exécutions ultérieures l'appel à {\sc cesam2k} se réduit à~:
\centerline{\tt cesam2k.out}.
\index{cesam2k.out}\index{path}\index{mypath}\index{cshrc}

\noindent Il n'est pas n\'ecessaire de recopier l'ex\'ecutable
 {\tt cesam2k.out}
dans chaque directory traitant d'une application donn\'ee
(par exemple SOLEIL, ALPHA\_CEN..) si on a pris soin, dans le fichier
{\sf .cshrc}, d'indiquer le chemin du directory {\sc cesam2k/source}
dans les {\tt path}~:\label{sec:cshrc}
\begin{tt}\begin{verbatim} 
set mypath=(... ~/CESAM2k/SOURCE ...)
set path=(. ~ ... $LPath $path $mypath)
\end{verbatim}\end{tt}

\begin{figure}%[ht]
\includegraphics[width=0.9\textwidth]{Orga-gene.eps}
\caption{Sch\'ema de l'organigramme g\'en\'eral de {\sc cesam2k}.
Le programme {\sf cesam2k}, compil\'e une fois pour toutes, fait appel \`a la
routine {\sf cesam} qui constitue en fait, le programme principal. Dans
{\sf cesam} apr\`es des initialisations on s\'epare le traitement
des 3 possibilit\'es~: poursuite d'une \'evolution, initialisation sur la
ZAMS homog\`ene, initialisation d'une PMS. Le calcul se poursuit par des
op\'erations de gestion de l'\'evolution, listing, cr\'eation de fichiers de
sortie, dessin, etc... Est fait ensuite appel \`a {\sf resout} o\`u
 les \'equations de l'\'equilibre quasi-statique sont r\'esolues
 alternativement avec celles de l'\'evolution de la composition chimique,
 ces derni\`eres \'etant r\'esolues s\'epar\'ement dans {\sf evol}.
 Une fois la convergence
 obtenue, il y a retour vers les
 algorithmes de gestion de l'\'evolution de {\sf cesam} et, de l\`a,
 poursuite de
 l'\'evolution ou retour \`a {\sf cesam2k} pour sortie. Les routines d'analyse
 num\'erique et de physique sont sollicit\'ees \`a diff\'erents niveaux des
 calculs. 
}\label{fig:org}
\end{figure}

\section{Le fichier de donn\'ees {\sf mon\_modele.don}}\label{sec:don}
Les options physiques \`a utiliser et les donn\'ees sont transmises
au programme principal par des {\tt NAMELIST} regroup\'ees dans un fichier en
ASCII dont le nom a {\bf n\'ecessairement} l'extension {\tt .don},
{\sc mon\_modele.don} par exemple~:
\index{mon\_modele.don}

\begin{itemize}
 \item {\tt \& NL\_NOMS}~: regroupe les noms des routines de physique \`a
  utiliser;\index{NAMELIST NL\_NOMS}
 \item {\tt \& NL\_ESPACE}~: regroupe les param\`etres physiques relatifs \`a
  la variable spatiale;\index{NAMELIST NL\_ESPACE}
 \item {\tt \& NL\_ATMOSPHERE}~: regroupe les param\`etres physiques relatifs \`a
  la restitution de l'atmosph\`ere;\index{NAMELIST NL\_ATMOSPHERE}
 \item {\tt \& NL\_TEMPS}~: regroupe les param\`etres physiques relatifs \`a
  la variable temporelle;\index{NAMELIST NL\_TEMPS}
 \item {\tt \& NL\_CHIM}~: regroupe les param\`etres physiques relatifs \`a
  la composition chimique;\index{NAMELIST NL\_CHIM}
 \item {\tt \& NL\_ROT}~: regroupe les param\`etres physiques relatifs \`a
  la rotation;\index{NAMELIST NL\_ROT}
 \item {\tt \& NL\_CONV}~: regroupe les param\`etres physiques relatifs \`a
  la convection;\index{NAMELIST NL\_CONV} 
 \item {\tt \& NL\_ETAT}~: regroupe les noms des fichiers, {\em d'acc\`es externe},
  \'eventuellement n\'ecessaires au calcul de l'\EOS;\index{NAMELIST NL\_ETAT}
 \item {\tt \& NL\_OPA}~: regroupe les noms des fichiers, {\em d'acc\`es externe},
  \'eventuellement n\'ecessaires au calcul de l'opacit\'e;\index{NAMELIST NL\_OPA}
 \item {\tt \& NL\_NUC}~: d\'efinit des options relatives au calcul des taux de
  r\'eactions thermonucl\'eaires.\index{NAMELIST NL\_NUC}
\end{itemize}

\subsection{Exemple de fichier de données}\label{sec:fdon}
\index{nom\_ctes\_phys}\index{nom\_des}\index{nom\_perte}
\index{nom\_atm}\index{nom\_tdetau}\index{nom\_abon}
\index{nom\_diffm}\index{nom\_difft}\index{nom\_conv}
\index{nom\_etat}\index{nom\_opa}\index{nom\_nuc}\index{nom\_chemin}
\index{fichier de données}
\begin{tt}\begin{verbatim}
 &NL_NOMS
 nom_ctes_phys='ctes_85',
 nom_des='no_des',
 nom_perte='perte_ext',
 nom_atm='lim_atm',
 nom_tdetau='edding',
 nom_abon='solaire_gn',
 nom_diffm='diffm_mp',
 nom_difft='difft_nu',
 nom_conv='conv_jmj',
 nom_etat='etat_eff',  
 nom_opa='opa_int_zsx',
 nom_nuc='ppcno9',
 nom_nuc_cpl='NACRE'
 nom_osc='no_osc'
 nom_chemin='/home/morel/SUN_STAR_DATA/'    
 /
 &NL_ESPACE
 MTOT    =   1.0000000000000,
 MDOT    =  0.000000000000000E+000,
 DER_NUM = f,
 PRECISION       = 'sp',
 N_MAX=1500
 / 
 &NL_ATMOSPHERE
 TAU_MAX =   20.0000000000000     ,
 LIM_RO  = T
 /
 &NL_TEMPS
 AGEMAX  =   0.0d0   ,
 DTLIST  =   100000000.000000     ,
 X_STOP  =   -0.10000000000000     ,
 LOG_TEFF        =   10.0000000000000     ,
 T_STOP  =   5.d7     ,
 ARRET   = 'else',
 NB_MAX_MODELES=1000
 /
 &NL_CHIM
 X0      =  0.70 ,
 Y0      =  0.28 ,
 ZSX0    =  0.,
 GARDE_XISH=.FALSE., 
 D_TURB  =   0.d0,
 RE_NU = 1.d0, 
 DIFFUSION = f,
 F_RAD=f,
 GRILLE_FIXE=f
 /
 &NL_ROT
 W_ROT   =  0.d0,
 DW=4.d-7,
 ROT_SOLID       = t
 /
 &NL_CONV
 ALPHA   =   1.8     ,
 CPTURB  =  0.000000000000000E+000,
 OVSHTS  =  0.000000000000000E+000,
 OVSHTI  =  0.000000000000000E+000,
 JPZ     = F,
 LEDOUX  = F
 /
 &NL_ETAT 
 F_EOS   = 'eos_190.bin', 7*' '
 /
 &NL_OPA 
 F_OPA   = 'opa_yveline_etendu.dat','v9/OPINTPATH_AX', 6*' '
 /
 &NL_NUC
 MITLER  = F
 /
\end{verbatim}\end{tt}

\section{Liste des routines disponibles}\index{routines disponibles}
 \index{nom\_ctes\_phys}\index{nom\_ctes\_phys85}
 \index{ctes\_phys94}
\begin{itemize} 
 \item {\tt ctes\_phys}~: indique le nom de la routine d'initialisation des
 principales constantes de physique \`a utiliser.
 \begin{itemize}
  \item {\tt cte\_85}~: constantes de physique propos\'ees par {\sc gong}.
  \item {\tt cte\_94}~: constantes de physique r\'ecentes.
 \end{itemize}
 \item {\tt nom\_des}~: indique le nom de la routine de dessin {\em on line} à
 utiliser.\index{nom\_des}\index{des\_r}\index{des\_m}
 \index{no\_des}\index{pgplot}
 \begin{itemize}
  \item {\tt des\_r}~: dessin en fonction du rayon, {\em nécessite la 
  disponibilité du logiciel} {\sc pgplot},
  \item {\tt des\_m}~: dessin en fonction de la masse, {\em nécessite la 
  disponibilité du logiciel} {\sc pgplot},
  \item {\tt no\_des}~: pas de dessin, {\em à utiliser quand on ne dispose pas du
  logiciel} {\sc pgplot}, voir \paragr{sec:npgplot},
  \item {\tt zoom}: forme personnalisée du dessin décrite au
   \paragr{sec:zoom}.  
 \end{itemize}
 \item {\tt nom\_perte}~: nom de la routine de perte de masse.
 \index{nom\_perte}\index{perte\_ext}\index{perte\_msol}\index{perte\_tot}
 \begin{itemize}
  \item {\tt perte\_ext}~: perte/gain de masse externe,
  linéaire en fonction du temps,
  \item {\tt perte\_msol}~: perte/gain de masse externe linéaire
  en fonction du temps, la masse de l'étoile restant au moins
  égale à $1\,M_\odot$,  
  \item {\tt perte\_tot}~: perte/gain de masse externe, linéaire
  en fonction du temps et tenant compte de la perte de masse due aux 
  réactions thermonucléaires ($E=mc^2$).	  
 \end{itemize}
 \item {\tt nom\_atm}~: nom de la routine de restitution de l'atmosphère.
 \index{restitution de l'atmosphère}\index{nom\_atm}\index{lim\_atm}
 \index{lim\_gong1}\index{lim\_tau1}  
 \begin{itemize}
  \item {\tt lim\_atm}~: restitution de l'atmosphère à partir d'une
  loi $T(\tau)$,
  \item {\tt lim\_gong1}~: restitution simplifiée de l'atmosphère,
  cas de {\sc gong1},
  \item {\tt lim\_tau1}~: restitution simplifiée de l'atmosphère,
  atmosphère mono-couche.	  
 \end{itemize}
 \item {\tt nom\_tdetau}~: nom de la loi $T(\tau)$ utilisée pour
 la restitution de l'atmosphère.
 \index{nom\_tdetau}\index{edding}\index{hopf}\index{K5750}
 \index{K5777}\index{roger00}\index{roger02}\index{roger05}\index{roger10a}
 \begin{itemize}
  \item {\tt edding}~: loi $T(\tau)$ totalement radiative d'Eddington,
  \item {\tt hopf}~: loi $T(\tau)$ totalement radiative de Hopf,
  \item {\tt K5750}~: loi $T(\tau)$ non totalement radiative, dérivée
  du modèle d'atmosphère solaire de Kurucz, $T_{\rm eff}=5750$\,K
  \item {\tt K5777}~: loi $T(\tau)$ non totalement radiative, dérivée
  du modèle d'atmosphère solaire de Kurucz, $T_{\rm eff}=5777$\,K   
  \item {\tt roger00}~: loi $T(\tau)$ non totalement radiative, dérivée
  de modèles d'atmosphère de Kurucz, de métallicité $\rm [\frac{Fe}H]=0.0$,
  \item {\tt roger02}~: loi $T(\tau)$ non totalement radiative, dérivée   
  de modèles d'atmosphère de Kurucz, de métallicité $\rm [\frac{Fe}H]=-0.2$, 
  \item {\tt roger05}~: loi $T(\tau)$ non totalement radiative, dérivée
  de modèles d'atmosphère de Kurucz, de métallicité $\rm [\frac{Fe}H]=-0.5$,
  \item {\tt roger10a}~: loi $T(\tau)$ non totalement radiative, dérivée
  de modèles d'atmosphère de Kurucz, de métallicité $\rm [\frac{Fe}H]=-1.0$
  avec éléments $\alpha$ "enhanced".	   	   
 \end{itemize}
 \item {\tt nom\_abon}~: nom de la compilation d'abondances, pour
 l'initialisation de la composition chimique (\cf{\EOS\ OPAL~: {\sc web} site
 \tt http://www-phys.llnl.gov/V\_Div/OPAL/opal.html}).
 \index{nom\_abon}\index{abondances initiales}
 \index{enhan\_al}\index{enhan\_cha}\index{enhan\_w}\index{meteorites}
 \begin{itemize} 
  \item{\tt enhan\_al}~: abondances $\alpha$-enhanced de Allard,
  \item{\tt enhan\_cha}~: abondances $\alpha$-enhanced de Chaboyer, 
  \item{\tt enhan\_w}~:  abondances $\alpha$-enhanced de Weiss,
  \item{\tt meteorites}~: abondances m\'et\'eoritiques,
  \item{\tt mixture}: forme personnalisée de la compilation d'abondances  
  décrite au \paragr{sec:mix},
  \item{\tt solaire\_gn}: mixture solaire de Grevesse \& Noels.    
 \end{itemize}
 \index{diffusion microscopique}\index{diffm\_br}\index{diffm\_mp}
 \index{diffm\_0}\index{nom\_diffm}	
 \item {\tt nom\_diffm}~: nom de la routine calculant les coefficients
 de diffusion microscopique.
 \begin{itemize}
  \item{\tt diffm\_br}~: calcul des coefficients de diffusion
  microscopique suivant le formalisme de Burgers en tenant compte, 
  \'eventuellement, des acc\'elerations radiatives, 
  \item{\tt diffm\_mp}~: calcul des coefficients de diffusion microscopique
  suivant le formalisme simplifi\'e de Michaud \& Proffit,   
  \item{\tt diffm\_0}~: coefficients de diffusion microscopique nuls.  
 \end{itemize}
 \index{diffusion turbulente}\index{difft\_nu}\index{nom\_diffm}	
 \item {\tt nom\_difft}~: nom de la routine calculant les coefficients
 de diffusion turbulente.
 \begin{itemize}
  \item{\tt difft\_nu}~: calcul des coefficients de diffusion turbulente
  incluant la diffusivité radiative.
 \end{itemize}     
 \index{convection}\index{conv\_a0}\index{conv\_cm}\index{conv\_jmj}
 \index{nom\_conv}\index{conv\_cgm\_reza}\index{conv\_cm\_reza}
 \index{conv\_cml}
 \item {\tt nom\_conv}~: nom de la routine calculant le gradient de
 temp\'erature dans les zones convectives.
 \begin{itemize}
  \item{\tt conv\_a0}~: convection MLT, avec longueur de m\'elange
  $l\rightarrow 0$ aux limites ZR/ZC,	    
  \item{\tt conv\_cgm\_reza}~: convection suivant Canuto \& Mazitelli avec
  $l=\alpha H_{\rm p}$, tient compte de la prescription de Bernkopf,    
  \item{\tt conv\_cm}~: convection suivant Canuto \& Mazitelli avec
  $l=\alpha H_{\rm p}$,
  \item{\tt conv\_cml}~: convection suivant Canuto \& Mazitelli avec
  avec longueur de m\'elange égale à la plus courte distance des
  bords de la ZC,  
  \item{\tt conv\_cm\_reza}~: convection suivant Canuto \& Mazitelli avec
  $l=\alpha H_{\rm p}$, tient compte de $\delta$,        
  \item{\sf conv\_jmj}~: convection MLT avec $l=\alpha H_{\rm p}$.      
 \end{itemize}   
 \index{etat\_eff}\index{etat\_gong1}\index{etat\_gong2}\index{etat\_mhd}
 \index{etat\_opal}\index{equation d'etat}\index{nom\_etat}	
 \item {\tt nom\_etat}~: nom de la routine d'\'equation d'\'etat.
 \begin{itemize}
  \item{\tt etat\_ceff}~: \'equation d'\'etat de Eggleton et al., avec
  corrections Coulombiennes;  appel \`a {\tt etat\_eff} en cas de
  difficult\'e,
  \item{\tt etat\_eff}~: \'equation d'\'etat de Eggleton et al., appel
  \`a {\tt etat\_gong2} en cas de difficult\'e,
  \item{\tt etat\_gong1}~: \'equation d'\'etat de {\tt gong1},
  seuls H et He sont pris en compte et suppos\'es totalement ionis\'es, 
  \item{\tt etat\_gong2}~: \'equation d'\'etat de {\tt gong2},
  seuls H et He4 sont pris en compte,
  \item{\tt etat\_mhd}~: \'equation d'\'etat de Mihalas, Hummer \& Dappen,
  appel \`a {\tt etat\_eff} en cas de difficult\'e; fait appel aux tables
  en binaire {\tt mhd1.bin} ... {\tt mhd7.bin} construites dans le
  directory {\sc sun\_star\_data}, voir \paragr{sec:mhdk}
  \item{\tt etat\_opal}~: \'equation d'\'etat de {\tt opal}, appel \`a
  {\tt etat\_eff} en cas de difficult\'e; fait appel aux tables
  en binaire {\tt eos\_opal*.bin} construites dans le directory
  {\sc sun\_star\_data}, voir \paragr{sec:eosopal}.
 \end{itemize}
 \index{opacite}\index{opa\_gong}\index{opa\_houdek9}\index{opa\_yveline}
 \index{opa\_yveline\_lisse}\index{nom\_opa}\label{sec:nopa}	
 \item {\tt nom\_opa}~: nom de la routine de calcul des opacit\'es moyenne de
 Rosseland.
 \begin{itemize}
  \item{\tt opa\_gong}~: opacit\'es simplifi\'ees (Kramers am\'elior\'e),
  \item{\tt opa\_houdek9}~: opacit\'es de Houdek version 9,
  (OPAL+Alexander), interpolation par rational B-spline; fait appel à
  des tables en binaire construites dans le directory
  {\sc sun\_star\_data/v9}, voir \paragr{sec:opahd}   
  \item{\tt opa\_yveline}~: opacit\'es OPAL+Alexander interpolation et
  raccord d'Yveline; fait appel aux tables
  en binaire {\tt opa\_yveline*.bin} construites dans le directory
  {\sc sun\_star\_data}, voir \paragr{sec:opayv}.   
  \item{\tt opa\_yveline\_lisse}~: opacit\'es OPAL+Alexander raccord
  d'Yveline, interpolation lin\'eaire ou lissage; fait appel aux tables
  en binaire {\tt opa\_yveline*.bin} construites dans le directory
  {\sc sun\_star\_data}, voir \paragr{sec:opayv}.
 \end{itemize}
 \index{pp1}\index{nom\_nuc}
 \index{ppcno9}\index{ppcno10}\index{ppcno10Fe}\index{ppcno11}\index{ppcno12}
 \index{ppcno12Be}\index{ppcno12Li}\index{ppcn03a9}\index{ppcn03ac10}
 \index{reactions thermonucleaires}
 \item {\tt nom\_nuc}~: nom de la routine de calcul des taux des
 r\'eactions thermonucl\'eaires et d'initialiation de la composition
 chimique.
 \begin{itemize}
  \item{\tt pp1}~: calcul simplifi\'e du cycle PP, 
  \item{\tt ppcno9}~:  r\'eactions PP+CNO, 9 \'el\'ements, H2, Li7, Be7 à
  l'\'equilibre,
  \item{\tt ppcno10}~: r\'eactions PP+CNO, 10 \'el\'ements, H2, Be7 \`a
  l'equilibre,
  \item{\tt ppcno10Fe}~: r\'eactions PP+CNO, 10 \'el\'ements+Fe, H2, Be7 à
  l'\'equilibre,
  \item{\tt ppcno11}~: r\'eactions PP+CNO, 11 \'el\'ements, Be7 à
  l'\'equilibre, 
  \item{\tt ppcno12}~: r\'eactions PP+CNO, 12 \'el\'ements,
  \item{\tt ppcno12Be}~: r\'eactions PP+CNO, 12 \'el\'ements + Be9,
  \item{\tt ppcno12Li}~: r\'eactions PP+CNO, 12 \'el\'ements + Li6, 
  \item{\tt ppcn03a9}~: r\'eactions PP+CNO+3$\alpha$, 9 \'el\'ements,
  H2, Be7 à l'\'equilibre,
  \item{\tt ppcn03ac10}~: r\'eactions PP+CNO+3$\alpha$+C,
  10 \'el\'ements H2, Be7 à l'\'equilibre.    
 \end{itemize}
 \index{nom\_nuc\_cpl}\index{NACRE}\index{Cau-Fow}\index{Adelb}
 \item {\tt nom\_nuc\_cpl}~: nom de la compilation des r\'eactions
  thermonucl\'eaires.
 \begin{itemize}
  \item {\tt Adelb}~: Compilation d'Adelberger et al.,
  \item {\tt Cau-Fow}~: Compilation de Caughlan \& Fowler,	
  \item {\tt NACRE}~: Compilation de NACRE.	
 \end{itemize}
 \index{nom\_osc}\index{osc\_adia}\index{no\_osc}
 \index{fichier d'oscillations}
 \item {\tt nom\_osc}~: type de fichier d'oscillations \`a g\'en\'erer
 \`a l'issue du calcul.
 \begin{itemize}\label{sec:out}
  \item {\tt osc\_adia}~: g\'en\'eration du fichier pour le calcul des
  ocillations adiabatiques,
  \item {\tt osc\_nadia}~: g\'en\'eration du fichier pour le calcul des
  ocillations non adiabatiques,
  \item {\tt no\_osc}~: il n'y a pas de g\'en\'eration de fichier pour
  le calcul des oscillations. 
 \end{itemize} 
 \index{nom\_chemin}
 \item {\tt nom\_chemin}~: chemin du directory où se trouvent les données de
 physique \cf équation d'état, opacités, \etc \index{nom\_chemin}           
\end{itemize}

\PB{Les noms de routines sont ``case sensitive'', par exemple il faut coder
{\tt NACRE} et non {\tt nacre}.}
