summaryrefslogtreecommitdiff
path: root/graphics/pstricks/contrib/pst-labo/doc/pst-labo-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'graphics/pstricks/contrib/pst-labo/doc/pst-labo-doc.tex')
-rw-r--r--graphics/pstricks/contrib/pst-labo/doc/pst-labo-doc.tex257
1 files changed, 104 insertions, 153 deletions
diff --git a/graphics/pstricks/contrib/pst-labo/doc/pst-labo-doc.tex b/graphics/pstricks/contrib/pst-labo/doc/pst-labo-doc.tex
index e2eb78c0f1..1610d0678e 100644
--- a/graphics/pstricks/contrib/pst-labo/doc/pst-labo-doc.tex
+++ b/graphics/pstricks/contrib/pst-labo/doc/pst-labo-doc.tex
@@ -1,41 +1,29 @@
-\DocumentMetadata{}
-\documentclass[11pt,a4paper,english]{article}
-%\usepackage[latin1]{inputenc}%
-%\usepackage[T1]{fontenc}
-\usepackage{babel}
-\usepackage{libertinus}
-\setmonofont{AnonymousPro}[Scale=MatchLowercase,FakeStretch=0.88]
-
-\usepackage{biblatex}
-\addbibresource{\jobname.bib}
+\RequirePackage{pdfmanagement-testphase}
+\DeclareDocumentMetadata{}
+% $Id: pst-labo-doc.tex 724 2023-05-17 17:57:02Z herbert $
+\documentclass[fontsize=11pt,english,BCOR=10mm,DIV=12,bibliography=totoc,parskip=false,headings=small,
+ headinclude=false,footinclude=false,oneside]{pst-doc}
+\usepackage{pst-labo}
+\let\pstLaboFV\fileversion
+\renewcommand\bgImage{%
+ \psset{unit=0.5cm,glassType=erlen,recuperationGaz,substance=\pstTournureCuivre}%
+ \pstChauffageBallon[tubeRecourbe]%
+}
+\lstset{pos=t,wide=false,language=PSTricks,
+ morekeywords={psKnot},basicstyle=\footnotesize\ttfamily}
-\usepackage{enumerate,longtable,url}
-\let\OldUrl=\url
-\renewcommand\url[1]{\protect\OldUrl{#1}}
+\addbibresource{\jobname.bib}
-%\usepackage[scaled]{luximono}
-%
-\usepackage{xspace,nonfloat}
-\usepackage[bottom]{footmisc}
-%
-\usepackage{tabularx}
-\usepackage{longtable}
-\usepackage{ltxtable}
+\usepackage{xltabular}
\usepackage{varioref}
-\usepackage[NewCommands,NewParameters]{ragged2e}
-\usepackage{url}
-\def\UrlFont{\ttfamily}
-
\usepackage{makeidx}\makeindex
%
-\usepackage[dvipsnames,table]{pstricks}
+\usepackage{pstricks}
\colorlet{tableheadcolor}{gray!25}
\colorlet{tablerowcolor}{gray!12}
-\newcommand\XCBox[1]{\fcolorbox{black}{#1}{\phantom{aa}} \small #1}
-\usepackage{pst-labo}
-\let\PSTfileversion\fileversion
\psset{griddots=10,subgriddiv=0,gridlabels=7pt}
+
%
\definecolor{hellgelb}{rgb}{1,1,0.8}
\definecolor{shadecolor}{rgb}{0.9,0.9,0.9}
@@ -44,40 +32,10 @@
% ------------------------------- Namen Abkuerungen ----------------------
\def\pst{\texttt{pstricks}\xspace}
\def\PST{\texttt{PSTricks}\xspace}
-\def\PS{PostScript\xspace}
-\newcommand*\CMD[1]{{\texttt{\textbackslash #1}}}
-\newcommand\Paket[1]{\texttt{#1}}
-\providecommand\Programm[1]{\textsf{#1}}
-\providecommand\RaggedRight{\raggedright}
-%
+\let\CMD\Lcs
+
\def\Index#1{\index{#1}#1}
-\index{Environment|see{Umgebung}}
-\def\eIndex#1{\index{Umgebung!#1@\texttt{#1}}\index{#1@\texttt{#1}}}
-\def\tIndex#1{\index{#1@\texttt{#1}}}
-\def\cIndex#1{\index{#1@\protect\CMD{#1}}}
-\def\pIndex#1{\index{Parameter@\textbf{Parameter}!#1@\texttt{#1}}\index{#1@\texttt{#1}}}
-\def\ppIndex#1{\index{Parameter@\textbf{Parameter}!#1@\texttt{#1}}}
-\def\sIndex#1{\index{Syntax@\textbf{Syntax}!\protect\CMD{#1}}}
-\def\csIndex#1{\sIndex{#1}\cIndex{#1}}
-\def\PIndex#1{\index{Paket@\textbf{Paket}!\texttt{#1}}}
-\def\mIndex#1{\texttt{#1}\tIndex{#1}\pIndex{#1}}
-\def\aref#1{$\rightarrow$\vref{#1}}
-\def\PSindex#1{\index{PostScript!#1}}
-\def\Makroindex#1{\index{Makro!#1@\protect\CMD{#1}}}
-\def\Optindex#1{\index{Parameter@\textbf{Parameter}!\texttt{#1}}}
-\def\ttindex#1{\index{#1@\texttt{#1}}}
-\def\vert{\ensuremath{|}}
%
-\let\Olddegrees\textdegrees
-\def\textdegrees{\ensuremath{\mbox{\Olddegrees}}}
-\def\sa{\ensuremath{\sphericalangle}\xspace}% needs amssymb
-%
-%
-%%-------------------------------- danger ---------------------------------------------
-\usepackage{manfnt}
-\usepackage{lettrine}
-\newsavebox{\dBox}
-
%-------------------------------- Listings -------------------------------------
\usepackage{showexpl}% not a real PSTricks package
%
@@ -90,72 +48,30 @@
\providecommand\eV{e.V\kern-.18em\@ifnextchar.{}{.}}
\def\textat{\protect\makeatletter\texttt{@}\protect\makeatother}
-\def\lBrace{\texttt{\{}}
-\def\rBrace{\texttt{\}}}
-\def\lBracket{\texttt{[}}
-\def\rBracket{\texttt{]}}
-%
-\def\PSTemph#1{\textit{\texttt{#1}}}
-%
-\def\LPack#1{\texttt{#1}}
-\def\Lmenv#1{\texttt{#1}}
-\def\Lmcs#1{\CMD{#1}\Makroindex{#1}\cIndex{#1}}
-\let\xLcs\Lmcs
-\let\Lcs\CMD
-\let\Lit\texttt
-\def\Loption#1{\texttt{#1}\Optindex{#1}\ttindex{#1}}
-\def\LProg#1{\texttt{#1}\pIndex{#1}}
-\let\Prog\LProg
-\def\LFile#1{\texttt{#1}\tIndex{#1}}
-\def\LColor#1{\texttt{#1}\index{Farbe!#1@\texttt{#1}}}
-\def\Lindex#1{#1\index{#1}}% Ausgeben und in den Index
-\def\Lext#1{\texttt{#1}\index{Dateiendung!#1@\texttt{#1}}}
-\def\LClass#1{\texttt{#1}}
-\def\Lmnotation#1{\texttt{#1}\tIndex{#1}}
-\newcommand\Larga{}
-\DeclareRobustCommand\Larga[1]{$\langle$\PSTemph{#1}$\rangle$}
-\newcommand\LargA{}
-\DeclareRobustCommand\LargA[1]{\lBrace$\langle$\PSTemph{#1}$\rangle$\rBrace}
-\newcommand\Largs{}
-\DeclareRobustCommand\Largs[1]{\lBracket$\langle$\PSTemph{#1}$\rangle$\rBracket}
-\newcommand\Largb{}
-\DeclareRobustCommand\Largb[1]{\lBrace$\langle$\PSTemph{#1}$\rangle$\rBrace}
-\newcommand\Largr{}
-\DeclareRobustCommand\Largr[1]{\PSTemph{({#1})}}
-\DeclareRobustCommand\Largra[1]{(\Larga{#1})}
-\newcommand\Larg{}
-\DeclareRobustCommand\Larg[1]{\lBrace\texttt{#1}\rBrace}
-\def\begEnv#1{\CMD{begin\{#1\}}\tIndex{#1}}
-\def\endEnv#1{\CMD{end\{#1\}}}
-\def\OptArg{\Largs{Optionen}}
-\def\Largrao{($\langle x_0,y_0\rangle$)}
-\def\Largrai{($\langle x_1,y_1\rangle$)}
-\def\Largraii{($\langle x_2,y_2\rangle$)}
-\def\Largraiii{($\langle x_3,y_3\rangle$)}
-\def\Largran{($\langle x_n,y_n\rangle$)}
-%
\input random
-%\def\cite#1{}
-%
-\begin{document}
-% $Id: pst-labo-docEN.tex 295 2016-05-02 19:11:36Z herbert $
-\title{\texttt{PST-Labo} - chemical objects\thanks{The english translation was done by Patrick Drechsler}\\
-\footnotesize{version \PSTfileversion}}
+\title{PSTricks package \texttt{pst-labo}}
+\subtitle{Chemical objects. Version \pstLaboFV}
+
\author{%
-Denis Girou\thanks{\url{Denis.Girou@idris.fr}}\and
-Christophe Jorssen\thanks{\url{Christophe.Jorssen@wanadoo.fr}}\and
-Manuel Luque\thanks{\url{ManuelLuque27@gmail.com}} \and
-Herbert Vo\ss\thanks{\url{hvoss@tug.org}}}
+Denis Girou\\
+Christophe Jorssen\\
+Manuel Luque\\
+Herbert Voß}
+\docauthor{}
\date{\today}
-\maketitle
+
+\begin{document}
+
+\settitle
+
+
\begin{abstract}
\LPack{pst-labo} provides macros for a variety of devices used
mainly for chemical applications.~\cite{pst-labo} Since most of these
devices have a standardised design \LPack{pst-labo} spares you the
- trouble of having to create them manually. Besides the usage of the
- package \LPack{pst-osci} this document also describes how to create
+ trouble of having to create them manually. This document also describes how to create
``high-level'' objects using the command \PST.~\cite{PSTricks2} All
basic objects are included in the file \LFile{pst-laboObj.tex} and
are loaded during the start of \LPack{pst-labo}. These objects can
@@ -163,6 +79,14 @@ Herbert Vo\ss\thanks{\url{hvoss@tug.org}}}
gives an overview of all objects.
\end{abstract}
+\vfill
+\noindent
+Thanks to:\\
+Frédéric Bréal; Patrick Drechsler (English translation);
+
+\clearpage
+
+
\tableofcontents
\newpage
@@ -173,7 +97,7 @@ Table~\ref{tab:pst-labo:Parameter} describes all parameters unique to
\LPack{pst-labo}.
\noindent
-\LTXtable{\linewidth}{pst-labo8-tab1.tex}%
+\input{pst-labo8-tab1.tex}
@@ -296,7 +220,7 @@ there is less space needed in the vertical direction.
% ---------------------------------------------------------------------------------------
The option \Loption{tubeCoudeUB} is an extension of the U-shaped glass
tube which is only useful if extending the tube to the bottom makes
-sense, as shown for instance in the macro \Lmcs{pstChauffageBallon}.
+sense, as shown for instance in the macro \Lcs{pstChauffageBallon}.
\bgroup
\begin{LTXexample}[pos=t,preset=\raggedright]
@@ -344,12 +268,12 @@ horizontal. The angles must be within the interval of $-65\ldots
\subsection{\texttt{tubeSeul}}\label{subsec-pstlabo-tubeSeul}
% ---------------------------------------------------------------------------------------
\Loption{tubeSeul} influences the size of the chosen box. This can be
-advantageous as the following example using \Lmcs{psframebox} shows:
+advantageous as the following example using \Lcs{psframebox} shows:
If you do not wish to add a further container to the box on the right
hand side the box would still have the same size as the one on the
left. The option \verb+tubeSeul=true+ prevents this from
happening. This option only has effects in combination with the macro
-\Lmcs{pstChauffageTube} and glass containers of the type \verb+ballon+
+\Lcs{pstChauffageTube} and glass containers of the type \verb+ballon+
and \verb+tube+.
\bgroup
@@ -365,8 +289,8 @@ and \verb+tube+.
% ---------------------------------------------------------------------------------------
The option \Loption{becbunsen} toggles the drawing of a Bunsen burner.
\Loption{becbunsen} is set to \verb+true+ by default for the macro
-\Lmcs{pstChauffeTube} and to \verb+false+ for the macro
-\Lmcs{pstChauffageBallon}.
+\Lcs{pstChauffeTube} and to \verb+false+ for the macro
+\Lcs{pstChauffageBallon}.
\bgroup
\begin{LTXexample}[width=0.5\linewidth]
@@ -400,24 +324,24 @@ activated (see section~\vref{subsec-pstlabo-tubeSeul})
% ---------------------------------------------------------------------------------------
The type of substance within the glass container can be selected by
the option \Loption{substance}. The default value is a blue fluid
-(\Lmcs{pstBullesChampagne}). The available macros are summarised in
+(\Lcs{pstBullesChampagne}). The available macros are summarised in
table~\ref{tab-pstlabo-substance}. It should be pointed out that
-\Lmcs{pstFilaments} and \Lmcs{pstBULLES} are required parameters.
+\Lcs{pstFilaments} and \Lcs{pstBULLES} are required parameters.
\begin{table}[!htb]
\caption{Summary of macros for the option \Loption{substance}}\label{tab-pstlabo-substance}
\centering
\begin{tabular}{@{}lcl@{}}
\emph{macro} & \emph{default} & \emph{comment}\\\hline
-\Lmcs{pstBullesChampagne}\Largs{value} & 25 & standard\\
-\Lmcs{pstFilaments}\Largs{value}\Largb{color} & 5\\
-\Lmcs{pstBilles}\Largs{value} & 50 & two dimensional\\
-\Lmcs{pstBULLES}\Largs{value}\Largb{color} & 20 & three dimensional
+\Lcs{pstBullesChampagne}\Largs{value} & 25 & standard\\
+\Lcs{pstFilaments}\Largs{value}\Largb{color} & 5\\
+\Lcs{pstBilles}\Largs{value} & 50 & two dimensional\\
+\Lcs{pstBULLES}\Largs{value}\Largb{color} & 20 & three dimensional
\end{tabular}
\end{table}
The optional value describes the number of passes for the internal
-\Lmcs{multido}-loop. It is basically unlimited although values larger
+\Lcs{multido}-loop. It is basically unlimited although values larger
than $80$ can lead to problems with \TeX 's defined memory. The later
can be modified in the \TeX\ configuration file. The location of this
file can be acquired using \verb+kpsewhich texmf.cnf+.
@@ -474,9 +398,9 @@ section~\ref{subsec-pstlabo-substance}.
\centering
\begin{tabular}{@{}lc@{}}
\emph{macro} & \emph{default} \\\hline
-\Lmcs{pstTournureCuivre}\Largs{value} & 30 \\
-\Lmcs{pstClouFer}\Largs{value} & 60\\
-\Lmcs{pstGrenailleZinc}\Largs{value} & 25
+\Lcs{pstTournureCuivre}\Largs{value} & 30 \\
+\Lcs{pstClouFer}\Largs{value} & 60\\
+\Lcs{pstGrenailleZinc}\Largs{value} & 25
\end{tabular}
\end{table}
@@ -578,7 +502,7 @@ that the geometrical origin is located in the centre of the setup.
% ---------------------------------------------------------------------------------------
\subsection{\texttt{burette}}\label{subsec-pstlabo-burette}
% ---------------------------------------------------------------------------------------
-The macro \Lmcs{pstDosage} displays a buret by default. This option
+The macro \Lcs{pstDosage} displays a buret by default. This option
suppresses its display.
\bgroup
@@ -636,7 +560,7 @@ distillate without this restriction.
\subsection{\texttt{phmetre}}\label{subsec-pstlabo-phmetre}
% ---------------------------------------------------------------------------------------
\Loption{phmetre} displays a pH-meter. Note that this option is only
-available with the macro \Lmcs{pstDosage}.
+available with the macro \Lcs{pstDosage}.
\bgroup
\begin{LTXexample}[pos=t]
@@ -798,7 +722,7 @@ value when used without further parameters is a normal test tube
% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstChauffageTube}}\label{sec:pstlabo8:pstChauffageTube}
% ---------------------------------------------------------------------------------------
-\Lmcs{pstChauffageTube} enhances the previous macro to include either
+\Lcs{pstChauffageTube} enhances the previous macro to include either
a heat block, a Bunsen burner or a second narrow glass tube
respectively.
@@ -828,7 +752,7 @@ respectively.
% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstBallon}}\label{sec:pstlabo8:pstBallon}
% ---------------------------------------------------------------------------------------
-\Lmcs{pstBallon} is basically identical to \Lmcs{pstTubeEssais} with
+\Lcs{pstBallon} is basically identical to \Lcs{pstTubeEssais} with
more possible options.
\begin{center}
@@ -852,7 +776,7 @@ more possible options.
% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstChauffageBallon}}\label{sec:pstlabo8:pstChauffageBallon}
% ---------------------------------------------------------------------------------------
-\Lmcs{pstChauffageBallon} enhances the previous macro by displaying a
+\Lcs{pstChauffageBallon} enhances the previous macro by displaying a
Bunsen burner by default.
\begin{center}
@@ -895,9 +819,9 @@ Bunsen burner by default.
% ---------------------------------------------------------------------------------------
-\subsection{\CMD{pstEntonnoir}}\label{sec:pstlabo8:pstTubeEssais}
+\subsection{\CMD{pstEntonnoir}}\label{sec:pstlabo8:pstEnnoir}
% ---------------------------------------------------------------------------------------
-\Lmcs{pstEntonnoir} displays a funnel. Called without any parameters
+\Lcs{pstEntonnoir} displays a funnel. Called without any parameters
it is combined with a test tube. It can be combined with any kind of setup.
\bgroup
@@ -913,7 +837,7 @@ it is combined with a test tube. It can be combined with any kind of setup.
% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstEprouvette}}\label{sec:pstlabo8:pstEprouvette}
% ---------------------------------------------------------------------------------------
-\Lmcs{pstEprouvette} displays a measuring cylinder. Its size can by
+\Lcs{pstEprouvette} displays a measuring cylinder. Its size can by
changed using the \PST scaling factor.
\bgroup
@@ -928,7 +852,7 @@ changed using the \PST scaling factor.
% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstpipette}}\label{sec:pstlabo8:pstpipette}
% ---------------------------------------------------------------------------------------
-\Lmcs{pstpipette} displays a pipette. Its scaling range can be altered
+\Lcs{pstpipette} displays a pipette. Its scaling range can be altered
by changing \PST scaling factors.
\bgroup
@@ -942,7 +866,7 @@ by changing \PST scaling factors.
% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstDosage}}\label{sec:pstlabo8:pstDosage}
% ---------------------------------------------------------------------------------------
-\Lmcs{pstDosage} is normally used in combination with other
+\Lcs{pstDosage} is normally used in combination with other
devices. The buret has a maximal capacity of 25 mL. The current height
and substrate can be changed by their options. An optional pH-meter
(only with glass type \verb+becher+) or heat block can be selected.
@@ -970,18 +894,18 @@ and substrate can be changed by their options. An optional pH-meter
% ---------------------------------------------------------------------------------------
\subsection{\CMD{pstDistillation}}\label{sec:pstlabo8:pstDistillation}
% ---------------------------------------------------------------------------------------
-The only macro which has be passed on to \Lmcs{pstDistillation} are
-the dimensions of the \Lmenv{pspicture} environment.
+The only macro which has be passed on to \Lcs{pstDistillation} are
+the dimensions of the \Lenv{pspicture} environment.
\medskip
\noindent
-\Lmcs{pstDistillation}\\
-\Lmcs{pstDistillation}\Largr{$x_{ll},y_{ll}$}\Largr{$x_{ur},y_{ur}$} % $
+\Lcs{pstDistillation}\\
+\Lcs{pstDistillation}\Largr{$x_{ll},y_{ll}$}\Largr{$x_{ur},y_{ur}$} % $
\medskip
In case these coordinates are not supplied a rectangle of
$(-4,-10)(8,7)$ is used, assuming that further objects will be
-included using \Lmcs{rput},
+included using \Lcs{rput},
\bgroup
\begin{LTXexample}
@@ -991,6 +915,33 @@ included using \Lmcs{rput},
\egroup
+\newpage
+
+% ---------------------------------------------------------------------------------------
+\subsection{\CMD{pstSeparateFunnel}}\label{sec:pstlabo8:pstSeparateFunnel}
+% ---------------------------------------------------------------------------------------
+
+\begin{LTXexample}[pos=b]
+\psset{unit=0.5}
+\begin{pspicture}(-2,-6)(6,16)%\psgrid%
+\pstSupport
+\pstSeparateFunnel[OpenTap=false,bouchon]
+\end{pspicture}
+\quad
+\begin{pspicture}(-2,-6)(6,16)%\psgrid%
+\pstSupport
+\pstSeparateFunnel[OpenTap=false,bouchon=false,niveauLiquide1=-1,niveauLiquide2=10]
+\rput(0,-3){\pstTubeEssais[glassType=becher,aspectLiquide1=AqueoPhase]}
+\end{pspicture}
+\quad
+\begin{pspicture}(-2,-6)(6,16)%\psgrid%
+\pstSeparateFunnel[OpenTap,bouchon=false,niveauLiquide1=1,niveauLiquide2=1]
+\rput(0,-3){\pstTubeEssais[glassType=becher,aspectLiquide1=OrganicPhase,niveauLiquide1=30]}
+\pstSupport
+\end{pspicture}
+\end{LTXexample}
+
+
@@ -1005,8 +956,8 @@ objects. For lack of space they are not displayed here explicitly.
\section{Examples}\label{sec:pstlabo:Beispiele}
% ---------------------------------------------------------------------------------------
Creating complex examples is eased significantly by using a coordinate
-grid underlying the setup (\Lmcs{psgrid}) or the oprional argument \Loption{showgrid}
-for the \Lmenv{pspicture} environment.
+grid underlying the setup (\Lcs{psgrid}) or the oprional argument \Loption{showgrid}
+for the \Lenv{pspicture} environment.
\begin{figure}
\centering
@@ -1033,7 +984,7 @@ for the \Lmenv{pspicture} environment.
\end{minipage}}}
\end{pspicture}
\egroup
-\caption{Example usage of \Lmcs{pstDosage}}
+\caption{Example usage of \Lcs{pstDosage}}
\end{figure}
\begin{figure}
@@ -1052,7 +1003,7 @@ for the \Lmenv{pspicture} environment.
\pstTubeEssais[Numero={\footnotesize Cu$^{2+}$}]
\pstTubeEssais[niveauLiquide1=30,aspectLiquide1=Champagne,Numero={\footnotesize NaOH},unit=0.75]
\egroup
-\caption{Example usage of \Lmcs{pstTubeEssais}}
+\caption{Example usage of \Lcs{pstTubeEssais}}
\end{figure}