\title{\texttt{PST-Labo} - matériel de chimie\thanks{Traduction française
    réalisée par Arnaud Schmittbuhl}\\
\footnotesize{version \PSTfileversion}}
\author{%
Denis Girou\thanks{\url{Denis.Girou@idris.fr}}, 
Christophe Jorssen\thanks{\url{Christophe.Jorssen@wanadoo.fr}},
Manuel Luque\thanks{\url{Mluque5130@aol.com}} and
Herbert Vo\ss\thanks{\url{voss@pstricks.de}}}
\date{\today}
\maketitle

\begin{abstract}
  L'extension \LPack{pst-labo} propose un ensemble de macros pour dessiner le
  matériel utilisé en chimie. \cite{pst-labo} En suivant les schématisations
  standards employées, \LPack{pst-labo} vous évite ainsi d'avoir à les réaliser
  vous même. Au-delà du simple usage de \LPack{pst-labo}, ce document explique
  comment créer des objets de « haut-niveau » à l'aide de commandes de
  \PST. \cite{PSTricks2} Tous les objets de base sont contenus dans le fichier
  \LFile{pst-laboObj.tex} et sont chargés au démarrage de l'extension
  \LPack{pst-labo}. Ces objets peuvent être utilisés en vue de créer une
  extension personnelle et sont répertoriés dans la
  section~\ref{sec:pstlabo:Objects}. 
\end{abstract}

\tableofcontents

\newpage
% ---------------------------------------------------------------------------------------
\section{Paramètres}\label{sec:pstlabo8:Parameter}
% ---------------------------------------------------------------------------------------
Le tableau~\ref{tab:pst-labo:Parameter} répertorie l'ensemble des paramètres
propres à \LPack{pst-labo}.

\noindent
\LTXtable{\linewidth}{pstlabo8-tab1-FR.tex}%



% ---------------------------------------------------------------------------------------
\subsection{\texttt{Type de verrerie}}\label{subsec-pstlabo-glassType}
% ---------------------------------------------------------------------------------------
L'option \Loption{glassType} sert à décrire le type de verrerie. Par défaut, il
s'agit d'un tube à essai.

\bgroup
\begin{LTXexample}[preset=\raggedright]
\psset{unit=0.5cm}
\pstTubeEssais
\pstTubeEssais[glassType=ballon]
\pstTubeEssais[glassType=erlen]
\pstTubeEssais[glassType=becher]
\pstTubeEssais[glassType=flacon]
\pstTubeEssais[glassType=fioleJauge]
\end{LTXexample}
\egroup


% ---------------------------------------------------------------------------------------
\subsection{\texttt{bouchon}}\label{subsec-pstlabo-bouchon}
% ---------------------------------------------------------------------------------------
L'option \Loption{bouchon} représente la verrerie hermétiquement scellée par un
bouchon.

\bgroup
\begin{LTXexample}[width=0.575\linewidth,preset=\raggedright]
\psset{unit=0.45cm}
\psset{bouchon=true}
\pstTubeEssais[glassType=tube]
\pstTubeEssais[glassType=ballon]
\pstTubeEssais[glassType=erlen]
\pstTubeEssais[glassType=flacon]
\end{LTXexample}
\egroup


% ---------------------------------------------------------------------------------------
\subsection{\texttt{pince}}\label{subsec-pstlabo-pince}
% ---------------------------------------------------------------------------------------
L'option \Loption{pince} place une pince en bois autour du col de la verrerie.

\bgroup
\begin{LTXexample}[width=0.55\linewidth,preset=\raggedright]
\psset{unit=0.5cm}
\psset{bouchon=true,pince=true}
\pstTubeEssais[glassType=tube]\hspace{1cm}
\pstTubeEssais[glassType=erlen]
\end{LTXexample}
\egroup




% ---------------------------------------------------------------------------------------
\subsection{\texttt{tubeDroit}}\label{subsec-pstlabo-tubeDroit}
%
%---------------------------------------------------------------------------------------
L'option \Loption{tubeDroit} place un réfrigérant à air dans le bouchon. 
Cette option n'est utilisable que si \verb+bouchon=true+, ce qui assuré en
interne par défaut. Prenez garde au fait qu'aucun espace vertical n'est réservé
au-dessus de la verrerie pour placer le réfrigérant. Cette espace doit être
placé manuellement, par exemple avec \verb+\rule{0pt}{4cm}+.

\bgroup
\begin{LTXexample}[width=0.55\linewidth,preset=\raggedright]
\psset{unit=0.5cm}
\psset{tubeDroit=true}
\rule{0pt}{4cm}%
\pstTubeEssais
\pstTubeEssais[glassType=ballon]
\pstTubeEssais[glassType=erlen]
\end{LTXexample}
\egroup

% ---------------------------------------------------------------------------------------
\subsection{\texttt{tubeCoude}}\label{subsec-pstlabo-tubeCoude}
%
%---------------------------------------------------------------------------------------
L'option \Loption{tubeCoude} est pratiquement identique à la précédente, à la
différence du coude à angle droit. L'espace vertical nécessaire au-dessus de
la verrerie est donc moins important.

\bgroup
\begin{LTXexample}[width=0.55\linewidth,preset=\raggedright]
\psset{unit=0.5cm}
\psset{tubeCoude=true}
\rule{0pt}{2.5cm}%
\pstTubeEssais[glassType=erlen]
\end{LTXexample}
\egroup

    
% ---------------------------------------------------------------------------------------
\subsection{\texttt{tubeCoudeU}}\label{subsec-pstlabo-tubeCoudeU}
% ---------------------------------------------------------------------------------------
L'option \Loption{tubeCoudeU} est similaire à la précédente, mais le coude a
une forme de U. Là aussi, moins d'espace vertical est nécessaire à son placement.

\bgroup
\begin{LTXexample}[width=0.5\linewidth,preset=\raggedright]
\psset{unit=0.5cm}
\psset{tubeCoudeU=true}
\rule{0pt}{2.5cm}%
\pstTubeEssais[glassType=ballon]
\end{LTXexample}
\egroup



% ---------------------------------------------------------------------------------------
\subsection{\texttt{tubeCoudeUB}}\label{subsec-pstlabo-tubeCoudeUB}
% ---------------------------------------------------------------------------------------
L'option \Loption{tubeCoudeUB} ressemble au tube coudé en U mais s'étend plus
bas. Ceci peut être est intéressant lors d'une utilisation conjointe avec la
commande \Lmcs{pstChauffageBallon}.

\bgroup
\begin{LTXexample}[pos=t,preset=\raggedright]
\psset{unit=0.5cm,glassType=ballon}
\pstChauffageBallon[tubeCoudeU] \pstChauffageBallon[tubeCoudeUB]
\end{LTXexample}
\egroup


% ---------------------------------------------------------------------------------------
\subsection{\texttt{etiquette} et \texttt{Numero}}\label{subsec-pstlabo-etiquette}
% ---------------------------------------------------------------------------------------
L'option \Loption{etiquette} est un booléen commandant l'affichage d'une
étiquette dont le contenu se trouve dans le paramètre \Loption{Numero}.

\bgroup
\begin{LTXexample}[width=0.42\linewidth,preset=\raggedright]
\psset{unit=0.5cm}
\pstTubeEssais[etiquette]
\pstTubeEssais[etiquette,Numero=1]
\pstTubeEssais[glassType=flacon,bouchon,%
  etiquette,Numero={\small Cu$^{2+}$}]
\end{LTXexample}
\egroup

% ---------------------------------------------------------------------------------------
\subsection{\texttt{tubePenche}}\label{subsec-pstlabo-tubePenche}
% ---------------------------------------------------------------------------------------
L'option \Loption{tubePenche} permet d'incliner la verrerie utilisée en
conservant horizontal l'interface air-eau. Les angles d'inclinaison doivent
être compris entre $-65$ et $+65$ degrés.

\bgroup
\begin{LTXexample}[width=0.4\linewidth,preset=\raggedright]
\psset{unit=0.5cm}
\pstTubeEssais[tubeDroit=true,tubePenche=40]
\pstTubeEssais[tubePenche=-20,bouchon]
\end{LTXexample}
\egroup  


% ---------------------------------------------------------------------------------------
\subsection{\texttt{tubeSeul}}\label{subsec-pstlabo-tubeSeul}
% ---------------------------------------------------------------------------------------
L'option \Loption{tubeSeul} détermine la taille du dessin. Les figures suivantes
illustrent l'intérêt de ce paramètre, avec la commande \Lmcs{psframebox}.
Si l'option n'était pas employée, la figure de droite, où le tube à essai de
barbotage est absent, aurait la même largeur que la figure de gauche.
L'option \verb+tubeSeul=true+ prévient ce comportement. Cette option ne
fonctionne qu'avec la commande \Lmcs{pstChauffageTube} et de la verrerie de
type \verb+ballon+ et \verb+tube+.

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm,glassType=ballon,becBunsen}
\psframebox{\pstChauffageTube[becBunsen,barbotage]}
\psframebox{\pstChauffageTube[tubeSeul=true]}
\end{LTXexample}
\egroup  

% ---------------------------------------------------------------------------------------
\subsection{\texttt{becBunsen}}\label{subsec-pstlabo-becBunsen}
% ---------------------------------------------------------------------------------------
L'option \Loption{becbunsen} ajoute un bec Bunsen sous la verrerie.
Par défaut, ce paramètre est activé (\verb+becbunsen=true+) pour la commande 
\Lmcs{pstChauffeTube} et désactivé (\verb+false+) pour la commande 
\Lmcs{pstChauffageBallon}.

\bgroup
\begin{LTXexample}[width=0.5\linewidth]
\psset{unit=0.5cm,tubeSeul=true}
\pstChauffageTube 
\pstChauffageTube[becBunsen=false]
\end{LTXexample}
\egroup  


% ---------------------------------------------------------------------------------------
\subsection{\texttt{barbotage}}\label{subsec-pstlabo-barbotage}
% ---------------------------------------------------------------------------------------
L'option \Loption{barbotage} place un tube à essai supplémentaire, relié par un
tube à dégagement au premier tube. Afin de réserver la largeur suffisante pour
placer l'ensemble, le paramètre \Loption{tubeSeul} ne doit pas être activé
(voir la section~\vref{subsec-pstlabo-tubeSeul}).

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm}
\pstChauffageTube[tubeSeul=true] 
\pstChauffageTube[barbotage]
\end{LTXexample}
\egroup  



% ---------------------------------------------------------------------------------------
\subsection{\texttt{substance}}\label{subsec-pstlabo-substance}
% ---------------------------------------------------------------------------------------
La nature de la substance placée dans la verrerie est choisie par l'option
\Loption{substance}. Il s'agit, par défaut, d'un liquide bleu
(\Lmcs{pstBullesChampagne}). Le tableau~\ref{tab-pstlabo-substance} recense les
divers choix possibles. Les options \Lmcs{pstFilaments} et \Lmcs{pstBULLES}
contiennent également un paramètre de couleur.

\begin{table}[!htb]
\caption{Résumé des commandes de l'option \Loption{substance}}\label{tab-pstlabo-substance}
\centering
\begin{tabular}{@{}lcl@{}}
\emph{commande} & \emph{défaut} & \emph{commentaire}\\\hline
\Lmcs{pstBullesChampagne}\Largs{valeur} & 25 & standard\\
\Lmcs{pstFilaments}\Largs{valeur}\Largb{couleur} & 5\\ 
\Lmcs{pstBilles}\Largs{valeur} & 50 & deux dimensions\\
\Lmcs{pstBULLES}\Largs{valeur}\Largb{couleur} & 20 & trois dimensions
\end{tabular}
\end{table}

Le paramètre optionnel correspond au nombre de tour de la boucle
\Lmcs{multido}. Il n'est pas limité mais des valeurs supérieures à $80$ peuvent
saturer la mémoire allouée par \TeX. Pour modifier cette taille, il faut se
référer au fichier de configuration de \TeX, localisable par la commande 
\verb+kpsewhich texmf.cnf+.

\begin{lstlisting}[language=sh]
voss@shania:~> kpsewhich texmf.cnf
/usr/local/texlive/2005/texmf/web2c/texmf.cnf
\end{lstlisting}


La première série d'exemples montre le comportement par défaut, avec deux
couleurs aléatoires. La seconde illustre le comportement du paramètre
optionnel. Les commandes \Loption{substance} et \Loption{solide} peuvent être
associées sans difficultés.


\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm,glassType=becher}
\pstTubeEssais 
\pstTubeEssais[substance=\pstBullesChampagne] 
\pstTubeEssais[substance=\pstFilaments{red}]
\pstTubeEssais[substance=\pstBilles]
\pstTubeEssais[substance=\pstBULLES{white}]
\end{LTXexample}
\egroup  


\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm,glassType=becher}
\pstTubeEssais[substance={\pstBullesChampagne[80]}] 
\pstTubeEssais[substance={\pstFilaments[20]{black}}]
\pstTubeEssais[substance={\pstBilles[80]}]
\pstTubeEssais[substance={\pstBULLES[20]{white}}]
\end{LTXexample}
\egroup  

Lorsque le paramètre optionnel est utilisé, il faut tenir compte du fait qu'il
fait partie d'un autre paramètre, si bien que l'ensemble doit être placé entre
accolades, comme le montrent les exemples précédents.


% ---------------------------------------------------------------------------------------
\subsection{\texttt{solide}}\label{subsec-pstlabo-solide}
% ---------------------------------------------------------------------------------------
L'option \Loption{solide} permet de spécifier le type de substance que
contiendra la verrerie. L'ensemble des paramètres acceptés se trouve dans le
tableau~\ref{tab-pstlabo-solide}. Les règles d'application sont identiques à
celles de la section~\ref{subsec-pstlabo-substance}.

\begin{table}[!htb]
\caption{Résumé des commandes de l'option \Loption{substance}}\label{tab-pstlabo-solide}
\centering
\begin{tabular}{@{}lc@{}}
\emph{commande} & \emph{défaut} \\\hline
\Lmcs{pstTournureCuivre}\Largs{valeur} & 30 \\
\Lmcs{pstClouFer}\Largs{valeur} & 60\\ 
\Lmcs{pstGrenailleZinc}\Largs{valeur} & 25 
\end{tabular}
\end{table}

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm,glassType=becher}
\pstTubeEssais 
\pstTubeEssais[solide=\pstTournureCuivre] 
\pstTubeEssais[solide=\pstClouFer]
\pstTubeEssais[solide=\pstGrenailleZinc]
\end{LTXexample}
\egroup  

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm,glassType=becher}
\pstTubeEssais[solide={\pstTournureCuivre[50]}] 
\pstTubeEssais[solide={\pstGrenailleZinc[80]}]
\pstTubeEssais[glassType=ballon,solide={\pstClouFer[50]}]
\end{LTXexample}
\egroup  

% ---------------------------------------------------------------------------------------
\subsection{\texttt{tubeRecourbe}}\label{subsec-pstlabo-tubeRecourbe}
% ---------------------------------------------------------------------------------------
L'option \Loption{tubeRecourbe} place un tube à dégagement courbé sur le
bouchon de la verrerie employée, ainsi qu'un bec Bunsen.

\bgroup
\begin{LTXexample}[pos=t,preset=\raggedright]
\psset{unit=0.5cm,glassType=erlen,recuperationGaz,substance=\pstTournureCuivre}
\pstChauffageBallon
\pstChauffageBallon[tubeRecourbe]
\end{LTXexample}
\egroup  

% ---------------------------------------------------------------------------------------
\subsection{\texttt{tubeRecourbeCourt}}\label{subsec-pstlabo-tubeRecourbeCourt}
% ---------------------------------------------------------------------------------------
L'option \Loption{tubeRecourbeCourt} est semblable à l'option
\Loption{tubeRecourbe} mais place un tube court, sans bec Bunsen.

\bgroup
\begin{LTXexample}[pos=t,preset=\raggedright]
\psset{unit=0.5cm,glassType=flacon,recuperationGaz,substance=\pstFilaments{red}}
\pstChauffageBallon[tubeRecourbe]
\pstChauffageBallon[tubeRecourbeCourt]
\end{LTXexample}
\egroup  


% ---------------------------------------------------------------------------------------
\subsection{\texttt{doubletube}}\label{subsec-pstlabo-doubletube}
% ---------------------------------------------------------------------------------------
L'option \Loption{doubletube} dessine deux tubes à dégagement, dont un avec 
un robinet d'arrêt.

\bgroup
\begin{LTXexample}[width=0.6\linewidth]
\rule{0pt}{4cm}
\psset{unit=0.5cm,glassType=ballon,%
  substance=\pstClouFer}
\pstBallon
\pstBallon[doubletube]
\end{LTXexample}
\egroup  


% ---------------------------------------------------------------------------------------
\subsection{\texttt{refrigerantBoulle}}\label{subsec-pstlabo-refrigerantBoulle}
% ---------------------------------------------------------------------------------------
Pour représenter un montage à reflux, il faut utiliser l'option
\Loption{refrigerantBoulle} qui place un réfrigérant à boule au dessus du
ballon, et un chauffe-ballon électrique en dessous. Si d'autres éléments sont
ajoutés, il faudra tenir compte du fait que le centre graphique du dessin
correspond au centre géométrique de la figure.

\bgroup
\begin{LTXexample}[width=0.3\linewidth]
\psset{unit=0.5cm}
\pstBallon[refrigerantBoulles,glassType=ballon,%
  substance=\pstClouFer]
\end{LTXexample}
\egroup  


% ---------------------------------------------------------------------------------------
\subsection{\texttt{recuperationGaz}}\label{subsec-pstlabo-recuperationGaz}
% ---------------------------------------------------------------------------------------
L'option \Loption{recuperationGaz} place le dispositif de récupération des gaz.

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm,glassType=flacon,tubeRecourbe,substance={\pstFilaments[10]{red}}}
\pstChauffageBallon
\pstChauffageBallon[recuperationGaz]
\end{LTXexample}
\egroup  


% ---------------------------------------------------------------------------------------
\subsection{\texttt{burette}}\label{subsec-pstlabo-burette}
% ---------------------------------------------------------------------------------------
Par défaut, la commande \Lmcs{pstDosage} dessine un montage de dosage, avec
burette. L'utilisation de cette option permet de supprimer la burette.

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.4cm}
\pstDosage[glassType=erlen]
\pstDosage[glassType=erlen,burette=false]
\end{LTXexample}
\egroup  

% ---------------------------------------------------------------------------------------
\subsection{\texttt{niveauReactifBurette} et \texttt{couleurReactifBurette}}\label{subsec-pstlabo-niveauReactifBurette}
% ---------------------------------------------------------------------------------------
Les options \Loption{niveauReactifBurette} et \Loption{couleurReactifBurette}
contrôlent respectivement le niveau, en pourcentage, et la couleur du liquide
dans la burette. 

\begin{center}
\bgroup
\psset{unit=0.4cm,glassType=erlen,niveauLiquide1=60}
\pstDosage[niveauReactifBurette=25,couleurReactifBurette=cyan]
\pstDosage[niveauReactifBurette=10]
\egroup  
\end{center}
\begin{lstlisting}
\psset{unit=0.4cm,glassType=erlen,niveauLiquide1=60}
\pstDosage[niveauReactifBurette=25,couleurReactifBurette=cyan]
\pstDosage[niveauReactifBurette=10]
\end{lstlisting}


% ---------------------------------------------------------------------------------------
\subsection{\texttt{AspectMelange} et \texttt{CouleurDistillat}}\label{subsec-pstlabo-AspectMelange}
% ---------------------------------------------------------------------------------------
La couleur du mélange des réactifs se fait sous forme d'un gradient de couleur
que l'on sélectionne par l'option \Loption{AspectMelange}. Elle doit
correspondre à l'un des styles prédéfinis. La couleur du distillat est régie par
l'option \Loption{CouleurDistillat} 

\begin{center}
\bgroup
\psset{unit=0.4cm}
\pstDistillation(-3,-10)(7,6)\quad
\pstDistillation[AspectMelange=Diffusion,CouleurDistillat=red](-3,-10)(7,6)
\egroup  
\end{center}

\begin{lstlisting}
\psset{unit=0.4cm}
\pstDistillation(-3,-10)(7,6)\quad
\pstDistillation[AspectMelange=Diffusion,CouleurDistillat=red](-3,-10)(7,6)
\end{lstlisting}


% ---------------------------------------------------------------------------------------
\subsection{\texttt{phmetre}}\label{subsec-pstlabo-phmetre}
% ---------------------------------------------------------------------------------------
L'option \Loption{phmetre} ne fonctionne qu'avec la commande \Lmcs{pstDosage}
et place un pH-mètre dans le bécher de dosage.

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm,glassType=becher,burette=false}
\pstDosage
\pstDosage[phmetre]
\end{LTXexample}
\egroup  

% ---------------------------------------------------------------------------------------
\subsection{\texttt{agitateurMagnetique}}\label{subsec-pstlabo-agitateurMagnetique}
% ---------------------------------------------------------------------------------------
Active par défaut, l'option \Loption{agitateurMagnetique} place l'agitateur
magnétique dans le bécher. Lorsqu'elle est désactivée, l'agitateur et le
dispositif de commande de sa rotation disparaissent.

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm,burette=false,glassType=becher}
\pstDosage
\pstDosage[agitateurMagnetique=false]
\end{LTXexample}
\egroup


% ---------------------------------------------------------------------------------------
\subsection{\texttt{niveauLiquide1}, \texttt{niveauLiquide2}, \texttt{niveauLiquide3}
    et \texttt{aspectLiquide1}, \texttt{aspectLiquide2}, \texttt{aspectLiquide3}}\label{subsec-pstlabo-niveauLiquide1}
% ---------------------------------------------------------------------------------------
Ces options servent à définir le niveau et le style des liquides 1, 2 et 3.
Le style peut être un de ceux prédéfinis ou une création personnelle (voir la
section~\ref{subsec-pstlabo-substance}). Selon la commande employée, toutes les
options ne sont pas accessibles.

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.4cm,glassType=becher}
\rule{0pt}{6cm}
\pstDosage[niveauReactifBurette=18,niveauLiquide1=30,aspectLiquide1=Champagne,%
  glassType=becher,phmetre=true]
\pstDosage[niveauReactifBurette=20,niveauLiquide1=40,aspectLiquide1=Champagne,%
  glassType=becher,phmetre=false,agitateurMagnetique=false]
\end{LTXexample}
\egroup  

\bgroup
\makebox[\textwidth]{%
\begin{pspicture}(0,0)(5,6)
  \rput(4,3){\pstChauffageBallon[becBunsen=true,unit=0.5]}
  \rput(2.5,4){\pstBallon[glassType=becher,xunit=1,yunit=0.5,aspectLiquide1=Champagne,runit=0.7]}
  \psset{glassType=tube}
  \rput(2.5,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=70,aspectLiquide1=Diffusion]}
  \rput(3,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=75,aspectLiquide1=Sang]}
  \rput(2,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=80]}
\end{pspicture}
\begin{pspicture}(0,0)(5,6)
  \rput(4,3){\pstChauffageBallon[becBunsen=true,unit=0.5]}
  \rput(2.5,4){\pstBallon[glassType=becher,xunit=1,yunit=0.5,aspectLiquide1=Champagne,runit=0.7]}
  \rput(2.4,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=70,aspectLiquide1=Diffusion]}
  \rput(2.8,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=65,aspectLiquide1=Sang]}
  \rput(1.7,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=80,tubePenche=10]}
  \rput(3.5,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=80,tubePenche=-10]}
\end{pspicture}
\begin{pspicture}(1,3)(5,6)
  \rput(2.5,4){\pstBallon[glassType=ballon,unit=0.5,niveauLiquide1=15]}
  \rput(1.3,5.4){\pstTubeEssais[unit=0.5,niveauLiquide1=95,
  niveauLiquide2=60,niveauLiquide3=30,tubePenche=-60]}
\end{pspicture}
}
\egroup  

\begin{lstlisting}
\begin{pspicture}(0,0)(5,6)
  \rput(4,3){\pstChauffageBallon[becBunsen=true,unit=0.5]}
  \rput(2.5,4){\pstBallon[glassType=becher,xunit=1,yunit=0.5,aspectLiquide1=Champagne,runit=0.7]}
  \psset{glassType=tube}
  \rput(2.5,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=70,aspectLiquide1=Diffusion]}
  \rput(3,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=75,aspectLiquide1=Sang]}
  \rput(2,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=80]}
\end{pspicture}
\begin{pspicture}(0,0)(5,6)
  \rput(4,3){\pstChauffageBallon[becBunsen=true,unit=0.5]}
  \rput(2.5,4){\pstBallon[glassType=becher,xunit=1,yunit=0.5,aspectLiquide1=Champagne,runit=0.7]}
  \rput(2.4,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=70,aspectLiquide1=Diffusion]}
  \rput(2.8,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=65,aspectLiquide1=Sang]}
  \rput(1.7,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=80,tubePenche=10]}
  \rput(3.5,3.7){\pstTubeEssais[tubeDroit=true,unit=0.35,niveauLiquide1=80,tubePenche=-10]}
\end{pspicture}
\begin{pspicture}(1,3)(5,6)
  \rput(2.5,4){\pstBallon[glassType=ballon,unit=0.5,niveauLiquide1=15]}
  \rput(1.3,5.4){\pstTubeEssais[unit=0.5,niveauLiquide1=95,
  niveauLiquide2=60,niveauLiquide3=30,tubePenche=-60]}
\end{pspicture}
\end{lstlisting}



% ---------------------------------------------------------------------------------------
\section{Couleurs et styles prédéfinis}\label{sec:pstlabo8:Stile}
% ---------------------------------------------------------------------------------------
L'ensemble des couleurs et styles prédéfinis dans l'extension \LPack{pst-labo}
est présenté ci-dessous. Tous peuvent être modifiés pour les besoins de
l'utilisateur. 

\begin{lstlisting}[xrightmargin=-\marginparwidth]
\definecolor{Beige}         {rgb}{0.96,0.96,0.86}
\definecolor{GrisClair}     {rgb}{0.8,0.8,0.8}
\definecolor{GrisTresClair} {rgb}{0.9,0.9,0.9}
\definecolor{OrangeTresPale}{cmyk}{0,0.1,0.3,0}
\definecolor{OrangePale}    {cmyk}{0,0.2,0.4,0}
\definecolor{BleuClair}     {cmyk}{0.2,0,0,0}
\definecolor{LightBlue}     {rgb}{.68,.85,.9}
\definecolor{Copper}        {cmyk}{0,0.9,0.9,0.2}
\definecolor{Marron}        {cmyk}{0,0.3,0.5,.3}
%
\newpsstyle{aspectLiquide1}   {linestyle=none,fillstyle=solid,fillcolor=cyan}
\newpsstyle{aspectLiquide2}   {linestyle=none,fillstyle=solid,fillcolor=yellow}
\newpsstyle{aspectLiquide3}   {linestyle=none,fillstyle=solid,fillcolor=magenta}
\newpsstyle{Champagne}        {linestyle=none,fillstyle=solid,fillcolor=Beige}
\newpsstyle{BilleThreeD}      {linestyle=none,fillstyle=gradient,gradmidpoint=0,gradend=white,GradientCircle=true}
\newpsstyle{Sang}             {linestyle=none,fillstyle=solid,fillcolor=red}
\newpsstyle{Cobalt}           {linewidth=0.2,fillstyle=solid,fillcolor=blue}
\newpsstyle{Huile}            {linestyle=none,fillstyle=solid,fillcolor=yellow}
\newpsstyle{Vinaigre}         {linestyle=none,fillstyle=solid,fillcolor=magenta}
\newpsstyle{Diffusion}        {linestyle=none,fillstyle=gradient,gradmidpoint=0}
\newpsstyle{DiffusionMelange2}{fillstyle=gradient,gradbegin=white,gradend=red,gradmidpoint=0,linecolor=red}
\newpsstyle{flammeEtGrille}   {linestyle=none,fillstyle=gradient,gradmidpoint=0,gradbegin=OrangePale,gradend=yellow}
\newpsstyle{rayuresJaunes}    {fillstyle=hlines,linecolor=yellow,hatchcolor=yellow}
\newpsstyle{DiffusionBleue}   {fillstyle=gradient,gradmidpoint=0,linestyle=none,gradbegin=green,gradend=cyan}
\end{lstlisting}


% ---------------------------------------------------------------------------------------
\section{Macros}\label{sec:pstlabo8:Makros}
% ---------------------------------------------------------------------------------------

% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstTubeEssais}}\label{sec:pstlabo8:pstTubeEssais}
% ---------------------------------------------------------------------------------------
Cette commande, déjà présente dans la plupart des exemples, permet de
représenter les divers types de verrerie rencontrés. Lorsqu'elle est employée
sans paramètre, un tube à essai est affiché (\verb+glassType=tube+).

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5}
\pstTubeEssais
\pstTubeEssais[glassType=becher]
\pstTubeEssais[glassType=erlen,niveauLiquide1=80]
\pstTubeEssais[glassType=flacon]
\pstTubeEssais[glassType=ballon,niveauLiquide1=20,aspectLiquide1=DiffusionBleue]
\pstTubeEssais[glassType=fioleJauge]
\end{LTXexample}
\egroup

% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstChauffageTube}}\label{sec:pstlabo8:pstChauffageTube}
% ---------------------------------------------------------------------------------------
L'option \Lmcs{pstChauffageTube} propose plus d'options que la commande
précédente en permettant notamment le tracé d'un bec Bunsen, d'une pince en
bois ou d'un tube à dégagement.

\begin{center}
\bgroup
\psset{unit=0.5}
\pstChauffageTube[tubeSeul]
\pstChauffageTube[glassType=ballon,becBunsen=false,tubeSeul]
\pstChauffageTube[glassType=erlen,becBunsen,pince,tubeSeul]
\pstChauffageTube[becBunsen,barbotage,glassType=flacon]
\pstChauffageTube[becBunsen,tubeCoude,glassType=ballon,niveauLiquide1=20,%
   aspectLiquide1=DiffusionBleue,tubeSeul,pince]
\egroup
\end{center}

\begin{lstlisting}[xrightmargin=-\marginparwidth]
\psset{unit=0.5}
\pstChauffageTube[tubeSeul]
\pstChauffageTube[glassType=ballon,becBunsen=false,tubeSeul]
\pstChauffageTube[glassType=erlen,becBunsen,pince,tubeSeul]
\pstChauffageTube[becBunsen,barbotage,glassType=flacon]
\pstChauffageTube[becBunsen,tubeCoude,glassType=ballon,niveauLiquide1=20,%
   aspectLiquide1=DiffusionBleue,tubeSeul,pince]
\end{lstlisting}


% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstBallon}}\label{sec:pstlabo8:pstBallon}
% ---------------------------------------------------------------------------------------
L'option \Lmcs{pstBallon} est proche de l'option \Lmcs{pstTubeEssais} mais
dispose de quelques options supplémentaires.

\begin{center}
\bgroup
\psset{unit=0.5cm}
\pstBallon\hspace{-0.5cm}
\pstBallon[glassType=erlen]\hspace{-0.5cm}
\pstBallon[glassType=becher,xunit=0.75cm,yunit=0.3cm,aspectLiquide1=Champagne,runit=0.4cm]\hspace{-0.5cm}
\raisebox{0.5cm}{\pstBallon[refrigerantBoulles=true]}
\egroup  
\end{center}

\begin{lstlisting}[xrightmargin=-\marginparwidth]
\psset{unit=0.5cm}
\pstBallon\hspace{-0.5cm}
\pstBallon[glassType=erlen]\hspace{-0.5cm}
\pstBallon[glassType=becher,xunit=0.75cm,yunit=0.25cm,aspectLiquide1=Champagne,runit=0.4cm]\hspace{-0.5cm}
\raisebox{1cm}{\pstBallon[refrigerantBoulles=true]}
\end{lstlisting}

% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstChauffageBallon}}\label{sec:pstlabo8:pstChauffageBallon}
% ---------------------------------------------------------------------------------------
L'option \Lmcs{pstChauffageBallon} complète la précédente en associant, par
défaut, un bec Bunsen.

\begin{center}
\bgroup
\psset{unit=0.5cm}
\pstChauffageBallon
\pstChauffageBallon[barbotage,tubeCoudeUB,becBunsen,substance=\pstBilles]\\
\pstChauffageBallon[glassType=flacon,recuperationGaz,tubeRecourbeCourt,substance={\pstFilaments[10]{red}}]
\pstChauffageBallon[doubletube,recuperationGaz,substance=\pstClouFer]
\egroup
\end{center}

\begin{lstlisting}[xrightmargin=-\marginparwidth]
\psset{unit=0.5cm}
\pstChauffageBallon
\pstChauffageBallon[barbotage,tubeCoudeUB,becBunsen,substance=\pstBilles]\\
\pstChauffageBallon[glassType=flacon,recuperationGaz,tubeRecourbeCourt,substance={\pstFilaments[10]{red}}]
\pstChauffageBallon[doubletube,recuperationGaz,substance=\pstClouFer]
\end{lstlisting}



\begin{center}
\bgroup
\psset{unit=0.5cm}
\pstChauffageBallon[glassType=erlen,tubeRecourbe,recuperationGaz,substance=\pstTournureCuivre]\hspace{3cm}
\pstChauffageBallon[glassType=becher,aspectLiquide1=Champagne,substance=\pstBullesChampagne]\hspace{.25cm}
\pstChauffageBallon[glassType=erlen,substance=\pstBullesChampagne,tubeDroit]
\egroup  
\end{center}

\begin{lstlisting}[xrightmargin=-\marginparwidth]
\psset{unit=0.5cm}
\pstChauffageBallon[glassType=erlen,tubeRecourbe,recuperationGaz,substance=\pstTournureCuivre]
\pstChauffageBallon[glassType=becher,aspectLiquide1=Champagne,substance=\pstBullesChampagne]
\pstChauffageBallon[glassType=erlen,substance=\pstBullesChampagne,tubeDroit]
\end{lstlisting}




% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstEntonnoir}}\label{sec:pstlabo8:pstTubeEssais}
% ---------------------------------------------------------------------------------------
L'option \Lmcs{pstEntonnoir} place un entonnoir au-dessus de la verrerie
employée, un tube à essai par défaut. Cette commande accepte tous les
paramètres disponibles.

\bgroup
\begin{LTXexample}[pos=t]
\psset{unit=0.5cm}
\pstEntonnoir
\pstEntonnoir[glassType=becher,tubePenche=-20]
\pstEntonnoir[glassType=flacon,etiquette=true,Numero={\green 37},%
  aspectLiquide1=DiffusionBleue,niveauLiquide1=80]
\end{LTXexample}
\egroup  

% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstEprouvette}}\label{sec:pstlabo8:pstEprouvette}
% ---------------------------------------------------------------------------------------
L'option \Lmcs{pstEprouvette} dessine une éprouvette graduée. Pour ajuster sa
taille, il suffit de jouer sur les facteurs d'échelle de \PST.

\bgroup
\begin{LTXexample}
\pstEprouvette[yunit=0.5cm]
\pstEprouvette[unit=0.6cm,niveauLiquide1=100,niveauLiquide2=60,niveauLiquide3=30]
\end{LTXexample}
\egroup  



% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstpipette}}\label{sec:pstlabo8:pstpipette}
% ---------------------------------------------------------------------------------------
L'option \Lmcs{pstpipette} représente une pipette. Là aussi, les facteurs
d'échelle de \PST permette d'en modifier la dimension.

\bgroup
\begin{LTXexample}
\pstpipette[unit=0.5cm,tubePenche=40]
\pstpipette[yunit=0.5cm]
\end{LTXexample}
\egroup  


% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstDosage}}\label{sec:pstlabo8:pstDosage}
% ---------------------------------------------------------------------------------------
L'option \Lmcs{pstDosage} représente un montage classique de dosage. La
capacité maximale de la burette est de 25~mL. Diverses options contrôlent la
hauteur de liquide et sa nature. Le montage peut être complété par un
chauffe-ballon et un pH-mètre (uniquement avec un \verb+becher+).

\bgroup\noindent
\makebox[\linewidth]{%
\psset{unit=0.5cm}
\pstDosage
\pstDosage[glassType=becher,phmetre=true]
\pstDosage[niveauReactifBurette=10,niveauLiquide1=60,aspectLiquide1=Champagne,%
  glassType=flacon,agitateurMagnetique=false]
\pstDosage[glassType=erlen,burette=false]}
\egroup  

\begin{lstlisting}[xrightmargin=-\marginparwidth]
\psset{unit=0.5cm}
\pstDosage
\pstDosage[glassType=becher,phmetre=true]
\pstDosage[niveauReactifBurette=10,niveauLiquide1=60,aspectLiquide1=Champagne,%
  glassType=flacon,agitateurMagnetique=false]
\pstDosage[glassType=erlen,burette=false]}
\end{lstlisting}


% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstDistillation}}\label{sec:pstlabo8:pstDistillation}
% ---------------------------------------------------------------------------------------
Les seuls paramètres acceptés par la commande \Lmcs{pstDistillation} sont ceux
de la dimension de l'environnement \Lmenv{pspicture}.

\medskip
\noindent
\Lmcs{pstDistillation}\\
\Lmcs{pstDistillation}\Largr{$x_{ll},y_{ll}$}\Largr{$x_{ur},y_{ur}$} % $

\medskip
En l'absence de coordonnées optionnelles, la dimension de travail sera
$(-4,-10)(8,7)$. L'espace important suppose que d'autres objets seront placés,
à l'aide de la commande \Lmcs{rput},

\bgroup
\begin{LTXexample}
\psset{unit=0.5cm}
\pstDistillation(-3,-10)(7,6)
\end{LTXexample}
\egroup  




% ---------------------------------------------------------------------------------------
\section{Objets de base}\label{sec:pstlabo:Objects}
% ---------------------------------------------------------------------------------------
Tous les objets de base de l'extension se trouvent dans le fichier
\LFile{pst-laboObj.tex}. Par manque de place, ils ne sont pas présentés ici.


% ---------------------------------------------------------------------------------------
\section{Exemples}\label{sec:pstlabo:Beispiele}
% ---------------------------------------------------------------------------------------
La création d'exemples complexes est grandement facilitée par l'utilisation
d'une grille de référence (\Lmcs{psgrid}).

\begin{figure}
\centering
\bgroup
\sffamily
\begin{pspicture}(0,-4)(7,4)
  \rput(3,0){\pstDosage[niveauReactifBurette=25,niveauLiquide1=30,%
    aspectLiquide1=Champagne,glassType=becher,phmetre,unit=0.5]}
  \rput(2,3){Burette}   
  \rput(4.7,3.6){25 mL}
  \rput(5.2,-2.2){H$_3$O$^+$+Cl$^-$}
  \rput(.8,-3){pH-mètre} 
  \rput(5,-2.8){20 mL}
  \rput(5,1){Na$^+$+OH$^-$} \rput(6.4,-3.6){Plaque chauffante}
  \psline{->}(2.7,2.9)(3.4,2.9)
\end{pspicture}
\begin{pspicture}(-3,-2)(2,3)
  \psset{unit=0.5cm}
  \rput(-4.5,4.0){\pstEprouvette[tubePenche=-60,niveauLiquide1=90,niveauLiquide2=50]}
  \rput(.5,0){\pstEntonnoir[glassType=flacon,niveauLiquide1=30]}
  \rput(.5,7.5){
    \framebox{\begin{minipage}{3.2cm}Après la décantation, les différentes
        phases sont séparées et la dernière est filtrée.
    \end{minipage}}}
\end{pspicture}
\egroup
\caption{Exemple d'utilisation de \Lmcs{pstDosage}}
\end{figure}


\begin{figure}
\centering
\bgroup
\psset{unit=0.5cm,etiquette}
\newpsstyle{Nickel}{fillstyle=solid,fillcolor=green}
\pstTubeEssais[niveauLiquide1=20,aspectLiquide1=Champagne,Numero=1]\kern-20pt
\pstTubeEssais[niveauLiquide1=30,aspectLiquide1=Cobalt,Numero=2]\kern-20pt
\pstTubeEssais[niveauLiquide1=40,aspectLiquide1=Sang,Numero=3]\kern-20pt
\pstTubeEssais[Numero=4]\kern-20pt
\psset{bouchon,glassType=flacon}
\pstTubeEssais[aspectLiquide1=Vinaigre,Numero={\footnotesize MnO$_4^-$}]
\pstTubeEssais[aspectLiquide1=Huile,unit=0.75,Numero={\footnotesize Ce$^{4+}$}]
\pstTubeEssais[aspectLiquide1=Nickel,Numero={\footnotesize Ni$^{2+}$}]
\pstTubeEssais[Numero={\footnotesize Cu$^{2+}$}]
\pstTubeEssais[niveauLiquide1=30,aspectLiquide1=Champagne,Numero={\footnotesize NaOH},unit=0.75]
\egroup  
\caption{Exemple d'utilisation de \Lmcs{pstTubeEssais}}
\end{figure}


\nocite{*}
\bibliographystyle{plain}
\bibliography{pst-labo-doc}


\endinput
