diff options
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.tex | 257 |
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} |