diff --git a/documentation/MPIE_CPFEM_manual.bib b/documentation/MPIE_CPFEM_manual.bib new file mode 100644 index 000000000..00c85c073 --- /dev/null +++ b/documentation/MPIE_CPFEM_manual.bib @@ -0,0 +1,35 @@ +% This file was created with JabRef 2.5. +% Encoding: Cp1252 + +@BOOK{Bunge1982, + title = {Texture Analysis in Materials Science}, + publisher = {Butterworths Publishers}, + year = {1982}, + author = {H.J. Bunge}, + address = {London}, + owner = {c.zambaldi}, + timestamp = {2008.10.21} +} + +@ARTICLE{Roters2010, + author = {F. Roters and P. Eisenlohr and L. Hantcherli and D. D. Tjahjanto + and T. R. Bieler and D. Raabe}, + title = {Overview of constitutive laws, kinematics, homogenization, and multiscale + methods in crystal plasticity finite element modeling: theory, experiments, + applications}, + journal = {Acta Materialia}, + year = {2010}, + volume = {58}, + pages = {1152--1211}, + number = {4}, + doi = {10.1016/j.actamat.2009.10.058} +} + +@comment{jabref-meta: selector_publisher:} + +@comment{jabref-meta: selector_author:} + +@comment{jabref-meta: selector_journal:} + +@comment{jabref-meta: selector_keywords:} + diff --git a/documentation/MPIE_CPFEM_manual.pdf b/documentation/MPIE_CPFEM_manual.pdf new file mode 100644 index 000000000..8700d4c13 Binary files /dev/null and b/documentation/MPIE_CPFEM_manual.pdf differ diff --git a/documentation/MPIE_CPFEM_manual.tex b/documentation/MPIE_CPFEM_manual.tex new file mode 100644 index 000000000..d07c8aa94 --- /dev/null +++ b/documentation/MPIE_CPFEM_manual.tex @@ -0,0 +1,181 @@ +\input{./header.tex} +%\listfiles% outputs info about packages +\bibpunct{(}{)}{,}{}{,}{,} % Zitierstil: {start}{ende}{multi-sep}{}{}... + +\newcommand{\marcinput}{\_.dat\xspace} + +\begin{document} +% BLANK SPACES BEFORE AND AFTER SECTIONS ... +% \@startsection {NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE} +% optional * [ALTHEADING]{HEADING} +% Generic command to start a section. +% NAME : e.g., 'subsection' +% LEVEL : a number, denoting depth of section -- e.g., chapter=1, +% section = 2, etc. A section number will be printed if +% and only if LEVEL < or = the value of the secnumdepth +% counter. +% INDENT : Indentation of heading from left margin +% BEFORESKIP : Absolute value = skip to leave above the heading. +% If negative, then paragraph indent of text following +% heading is suppressed. +% AFTERSKIP : if positive, then skip to leave below heading, +% else - skip to leave to right of run-in heading. +% STYLE : commands to set style +% If '*' missing, then increments the counter. If it is present, then +% there should be no [ALTHEADING] argument. A sectioning command +% is normally defined to \@startsection + its first six arguments. + +%\renewcommand\section{\@startsection {section}{1}{\z@}{-3.5ex plus -1ex minus +% -.2ex}{2.3ex plus .2ex}{\Large\bf}} +\renewcommand\subsection{\@startsection{subsection}{2}{\z@}{-.5ex plus -.2ex minus + -.2ex}{.3ex plus .2ex}{\large\bf}} %\large\bf +\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}{-.5ex plus +-1ex minus -.2ex}{.2ex plus .5ex}{\normalsize\bf}}%\bf}} +%\renewcommand\paragraph{\@startsection +% {paragraph}{4}{\z@}{3.25ex plus 1ex minus .2ex}{-1em}{\normalsize\bf}} +%\renewcommand\subparagraph{\@startsection +% {subparagraph}{4}{\parindent}{3.25ex plus 1ex minus +% .2ex}{-1em}{\normalsize\bf}} +%\renewcommand{\subsection}{\newpage \subsection} + +\input{./mpie_cpfem_macros}\newpage +\input{titlepage.tex}\newpage +%\input{titlepage}\cleardoublepage \phantomsection % set the hyperref anchor at the right position +\addcontentsline{toc}{section}{Table of contents} % +\tableofcontents +%\listoftables \addcontentsline{toc}{section}{Tables} % +%\listoffigures \addcontentsline{toc}{section}{Figures} %\newpage +\renewcommand{\chaptermark}[1]{\markboth{{\thechapter\ \ #1}}{}} + +\chapter{Preliminaries} +\section{Introduction} +For the theory and some application examples, see \citet{Roters2010}. + +\section{History of the code} +?, spaghetti version, + +\input{svn_guide.tex} + + +\section{Style guide for programming the CPFEM subroutine} +Some hints +\begin{itemize} +\item This manual cannot substitute proper commenting in the Fortran code. Try to include as much comments as possible directly in the code. +\item When commenting, do not use cryptic comments such as \emph{Random is random!} -- an actual +example from the code. +\end{itemize} + + +\chapter{Organization of the code} + + +\begin{figure} + \centering + \includegraphics[width=0.80\textwidth]{../../cpfem/documentation/NSD/crystallite_updateState.pdf} + \caption{updateState} + \label{fig:crystallite_updateState} +\end{figure} + + +\chapter{Homogenization schemes} +%\section{Introduction} +If more than one grain is simulated per integration point, a homogenization scheme is required to distribute the deformation gradient of the IP to the respective grains. The simplest choice is the \emph{isostrain approach} which simply consists in assuming the IP deformation gradient to be applicable directly to each grain. +%\section{Isostrain homogenization -- Taylor's assumption} +%\section{RGC} + +cite RGC papers... + +\chapter{Constitutive Laws} +\section{phenoPowerlaw} +\subsection{The material file for phenoPowerlaw} +\section{dislotwin} +\section{The non-local model} + +\section{The material file: material.config} + +\chapter{Application notes for different finite elements systems} +\section{MSC.MARC/Mentat} +In MARC the CPFEM routine is interfaced through the {\ttfamily hypela2} subroutine. The routine {\ttfamily makeMe.py} produces the interface files such as {\ttfamily mpie\_cpfem\_marc2008r1.f90} that will can be called by the different MARC releases. + +Necessary changes in the submit scripts + +Model definition for using the subroutine: In MARC, state variable 1 defines the temperature in Kelvin. State variables 2 and 3 define the microstructure and texture, respectively. + +Analysis options to invoke: Large Strain, Updated Lagrange. +% plan: The analysis options are most conveniently defined through the procedure file. + +\subsection{Utility scripts} +\begin{itemize} +\item marcAddUserOutput.py [] \marcinput --- adds UserVariables to the \marcinput file under the "post" section +\end{itemize} + +\subsection{Practical hints} +A copy of the subroutine on the home directory on the SAN makes the routine accessible from all workstations under /san/arbitraryfoldername/code/*.f90 . +Under windows it is beneficial to keep an additional local copy of the routine to work with TortoiseSVN, since the change of folder icons seems to not work on the SAN. + + +\section{Troubleshooting} +\subsection{Inside out element error} +An inside out element error can occur if the number of increment is chosen too small. This was observed for revision 539 using the pheno-powerlaw constitutive formulation on a particle in mesh problem. + +\section{Abaqus} +Differences to Marc. + +\chapter{Postprocessing of the results} +mentat, py\_post, gri, ParaView, TSL-OIM + +\chapter{Worked examples} +Refer to the corresponding publications ... + + + +\appendix \addcontentsline{toc}{chapter}{Appendix} +\cleardoublepage \phantomsection % set the hyperref anchor at the right position + +\fancypagestyle{plain} +{% Redefine "plain" style (e.g. for 1st side of chapters) +\fancyhf{} % clear all header and footer fields +\fancyfoot[ro,le]{\footnotesize\thepage} +} + +\input{euler_angles.tex}\newpage + +\chapter{Related works} +\section{Publications} + +\section{PhD thesises} +KuoDiss MaDiss ZaafaraniDiss +% +% Quellenverzeichnis +% http://www.cs.stir.ac.uk/~kjt/software/latex/showbst.html +%\bibliographystyle{} % +%\bibliographystyle{authordate3} % EX: DEY, S.R., HAZOTTE, A., & BOUZY, E. 2006. Multiscale gamma variant selection in a quarternary near-gamma Ti-Al alloy. Philosophical Magazine, 86(20), 3089–3112. +% +%\bibliographystyle{chicago} % EX: Appel and Christoph (1999) || Appel, F. and U. Christoph (1999). Coherency stresses and interface-related deformation phenomena in two-phase titanium aluminides. Intermetallics 7, 1173–1182. +%\bibliographystyle{elsarticle-num-names} +% +%\bibliographystyle{test} %see zambaldi/makebstTest/latex makebst +\bibliographystyle{diss_doi} %small manual changes from test.bst: +% doi linking, no ISSN for articles +% +%\bibliographystyle{spmpsci} % Springer +%\bibliographystyle{FRADINAT} % +%\bibliographystyle{abbrv} % [1], numbered +%\bibliographystyle{./bst/plainnat} % makes *everything* lower-case; plainnatm,abbrvnat,unsrtnat +%\bibliographystyle{./plainnat} % makes *everything* lower-case; plainnatm,abbrvnat,unsrtnat +% http://www.elisanet.fi/ptvirtan/misc/google-bibtex.html for doi linking +% Literaturverzeichnis +%\renewcommand{\bibname}{References} % default: Bibliography +\cleardoublepage \phantomsection % set the hyperref anchor +\addcontentsline{toc}{chapter}{\bibname} % +\small +%\footnotesize +\setlength\bibsep{0.3ex plus 0.1ex} +% Disable single lines at the start of a paragraph (Schusterjungen) +\clubpenalty = 10000 +% Disable single lines at the end of a paragraph (Hurenkinder) +\widowpenalty = 10000 \displaywidowpenalty = 10000 +%\pagestyle{fancy} % +\bibliography{mpie_cpfem_manual} %Use more than one bib file by {bib1,bib2,...} +\normalsize +\end{document} \ No newline at end of file diff --git a/documentation/diss_doi.bst b/documentation/diss_doi.bst new file mode 100644 index 000000000..33ef3175e --- /dev/null +++ b/documentation/diss_doi.bst @@ -0,0 +1,1536 @@ +%% +%% This is file `test.bst', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% merlin.mbs (with options: `ay,nat,nm-rvvc,keyxyr,yr-par,note-yr,atit-u,num-xser,isbn,issn,doi,xedn,nfss,') +%% ---------------------------------------- +%% *** test of makebst *** +%% +%% Copyright 1994-2007 Patrick W Daly + % =============================================================== + % IMPORTANT NOTICE: + % This bibliographic style (bst) file has been generated from one or + % more master bibliographic style (mbs) files, listed above. + % + % This generated file can be redistributed and/or modified under the terms + % of the LaTeX Project Public License Distributed from CTAN + % archives in directory macros/latex/base/lppl.txt; either + % version 1 of the License, or any later version. + % =============================================================== + % Name and version information of the main mbs file: + % \ProvidesFile{merlin.mbs}[2007/04/24 4.20 (PWD, AO, DPC)] + % For use with BibTeX version 0.99a or later + %------------------------------------------------------------------- + % This bibliography style file is intended for texts in ENGLISH + % This is an author-year citation style bibliography. As such, it is + % non-standard LaTeX, and requires a special package file to function properly. + % Such a package is natbib.sty by Patrick W. Daly + % The form of the \bibitem entries is + % \bibitem[Jones et al.(1990)]{key}... + % \bibitem[Jones et al.(1990)Jones, Baker, and Smith]{key}... + % The essential feature is that the label (the part in brackets) consists + % of the author names, as they should appear in the citation, with the year + % in parentheses following. There must be no space before the opening + % parenthesis! + % With natbib v5.3, a full list of authors may also follow the year. + % In natbib.sty, it is possible to define the type of enclosures that is + % really wanted (brackets or parentheses), but in either case, there must + % be parentheses in the label. + % The \cite command functions as follows: + % \citet{key} ==>> Jones et al. (1990) + % \citet*{key} ==>> Jones, Baker, and Smith (1990) + % \citep{key} ==>> (Jones et al., 1990) + % \citep*{key} ==>> (Jones, Baker, and Smith, 1990) + % \citep[chap. 2]{key} ==>> (Jones et al., 1990, chap. 2) + % \citep[e.g.][]{key} ==>> (e.g. Jones et al., 1990) + % \citep[e.g.][p. 32]{key} ==>> (e.g. Jones et al., p. 32) + % \citeauthor{key} ==>> Jones et al. + % \citeauthor*{key} ==>> Jones, Baker, and Smith + % \citeyear{key} ==>> 1990 + %--------------------------------------------------------------------- + +ENTRY + { address + author + booktitle + chapter + doi + edition + editor + eid + howpublished + institution + isbn + issn + journal + key + month + note + number + organization + pages + publisher + school + series + title + type + volume + year + } + {} + { label extra.label sort.label short.list } +INTEGERS { output.state before.all mid.sentence after.sentence after.block } +FUNCTION {init.state.consts} +{ #0 'before.all := + #1 'mid.sentence := + #2 'after.sentence := + #3 'after.block := +} +STRINGS { s t} +FUNCTION {output.nonnull} +{ 's := + output.state mid.sentence = + { ", " * write$ } + { output.state after.block = + { add.period$ write$ + newline$ + "\newblock " write$ + } + { output.state before.all = + 'write$ + { add.period$ " " * write$ } + if$ + } + if$ + mid.sentence 'output.state := + } + if$ + s +} +FUNCTION {output} +{ duplicate$ empty$ + 'pop$ + 'output.nonnull + if$ +} +FUNCTION {output.check} +{ 't := + duplicate$ empty$ + { pop$ "empty " t * " in " * cite$ * warning$ } + 'output.nonnull + if$ +} +FUNCTION {fin.entry} +{ add.period$ + write$ + newline$ +} + +FUNCTION {new.block} +{ output.state before.all = + 'skip$ + { after.block 'output.state := } + if$ +} +FUNCTION {new.sentence} +{ output.state after.block = + 'skip$ + { output.state before.all = + 'skip$ + { after.sentence 'output.state := } + if$ + } + if$ +} +FUNCTION {add.blank} +{ " " * before.all 'output.state := +} + +FUNCTION {date.block} +{ + new.block +} + +FUNCTION {not} +{ { #0 } + { #1 } + if$ +} +FUNCTION {and} +{ 'skip$ + { pop$ #0 } + if$ +} +FUNCTION {or} +{ { pop$ #1 } + 'skip$ + if$ +} +FUNCTION {new.block.checkb} +{ empty$ + swap$ empty$ + and + 'skip$ + 'new.block + if$ +} +FUNCTION {field.or.null} +{ duplicate$ empty$ + { pop$ "" } + 'skip$ + if$ +} +FUNCTION {emphasize} +{ duplicate$ empty$ + { pop$ "" } + { "\emph{" swap$ * "}" * } + if$ +} +FUNCTION {tie.or.space.prefix} +{ duplicate$ text.length$ #3 < + { "~" } + { " " } + if$ + swap$ +} + +FUNCTION {capitalize} +{ "u" change.case$ "t" change.case$ } + +FUNCTION {space.word} +{ " " swap$ * " " * } + % Here are the language-specific definitions for explicit words. + % Each function has a name bbl.xxx where xxx is the English word. + % The language selected here is ENGLISH +FUNCTION {bbl.and} +{ "and"} + +FUNCTION {bbl.etal} +{ "et~al." } + +FUNCTION {bbl.editors} +{ "editors" } + +FUNCTION {bbl.editor} +{ "editor" } + +FUNCTION {bbl.edby} +{ "edited by" } + +FUNCTION {bbl.edition} +{ "edition" } + +FUNCTION {bbl.volume} +{ "volume" } + +FUNCTION {bbl.of} +{ "of" } + +FUNCTION {bbl.number} +{ "number" } + +FUNCTION {bbl.nr} +{ "no." } + +FUNCTION {bbl.in} +{ "in" } + +FUNCTION {bbl.pages} +{ "pages" } + +FUNCTION {bbl.page} +{ "page" } + +FUNCTION {bbl.chapter} +{ "chapter" } + +FUNCTION {bbl.techrep} +{ "Technical Report" } + +FUNCTION {bbl.mthesis} +{ "Master's thesis" } + +FUNCTION {bbl.phdthesis} +{ "Ph.D. thesis" } + +MACRO {jan} {"January"} + +MACRO {feb} {"February"} + +MACRO {mar} {"March"} + +MACRO {apr} {"April"} + +MACRO {may} {"May"} + +MACRO {jun} {"June"} + +MACRO {jul} {"July"} + +MACRO {aug} {"August"} + +MACRO {sep} {"September"} + +MACRO {oct} {"October"} + +MACRO {nov} {"November"} + +MACRO {dec} {"December"} + +MACRO {acmcs} {"ACM Computing Surveys"} + +MACRO {acta} {"Acta Informatica"} + +MACRO {cacm} {"Communications of the ACM"} + +MACRO {ibmjrd} {"IBM Journal of Research and Development"} + +MACRO {ibmsj} {"IBM Systems Journal"} + +MACRO {ieeese} {"IEEE Transactions on Software Engineering"} + +MACRO {ieeetc} {"IEEE Transactions on Computers"} + +MACRO {ieeetcad} + {"IEEE Transactions on Computer-Aided Design of Integrated Circuits"} + +MACRO {ipl} {"Information Processing Letters"} + +MACRO {jacm} {"Journal of the ACM"} + +MACRO {jcss} {"Journal of Computer and System Sciences"} + +MACRO {scp} {"Science of Computer Programming"} + +MACRO {sicomp} {"SIAM Journal on Computing"} + +MACRO {tocs} {"ACM Transactions on Computer Systems"} + +MACRO {tods} {"ACM Transactions on Database Systems"} + +MACRO {tog} {"ACM Transactions on Graphics"} + +MACRO {toms} {"ACM Transactions on Mathematical Software"} + +MACRO {toois} {"ACM Transactions on Office Information Systems"} + +MACRO {toplas} {"ACM Transactions on Programming Languages and Systems"} + +MACRO {tcs} {"Theoretical Computer Science"} +FUNCTION {bibinfo.check} +{ swap$ + duplicate$ missing$ + { + pop$ pop$ + "" + } + { duplicate$ empty$ + { + swap$ pop$ + } + { swap$ + pop$ + } + if$ + } + if$ +} +FUNCTION {bibinfo.warn} +{ swap$ + duplicate$ missing$ + { + swap$ "missing " swap$ * " in " * cite$ * warning$ pop$ + "" + } + { duplicate$ empty$ + { + swap$ "empty " swap$ * " in " * cite$ * warning$ + } + { swap$ + pop$ + } + if$ + } + if$ +} +INTEGERS { nameptr namesleft numnames } + + +STRINGS { bibinfo} + +FUNCTION {format.names} +{ 'bibinfo := + duplicate$ empty$ 'skip$ { + 's := + "" 't := + #1 'nameptr := + s num.names$ 'numnames := + numnames 'namesleft := + { namesleft #0 > } + { s nameptr + "{vv~}{ll}{, jj}{, f{.}.}" + format.name$ + bibinfo bibinfo.check + 't := + nameptr #1 > + { + namesleft #1 > + { ", " * t * } + { + s nameptr "{ll}" format.name$ duplicate$ "others" = + { 't := } + { pop$ } + if$ + numnames #2 > + { "," * } + 'skip$ + if$ + t "others" = + { + " " * bbl.etal * + } + { + bbl.and + space.word * t * + } + if$ + } + if$ + } + 't + if$ + nameptr #1 + 'nameptr := + namesleft #1 - 'namesleft := + } + while$ + } if$ +} +FUNCTION {format.names.ed} +{ + 'bibinfo := + duplicate$ empty$ 'skip$ { + 's := + "" 't := + #1 'nameptr := + s num.names$ 'numnames := + numnames 'namesleft := + { namesleft #0 > } + { s nameptr + "{f{.}.~}{vv~}{ll}{ jj}" + format.name$ + bibinfo bibinfo.check + 't := + nameptr #1 > + { + namesleft #1 > + { ", " * t * } + { + s nameptr "{ll}" format.name$ duplicate$ "others" = + { 't := } + { pop$ } + if$ + numnames #2 > + { "," * } + 'skip$ + if$ + t "others" = + { + + " " * bbl.etal * + } + { + bbl.and + space.word * t * + } + if$ + } + if$ + } + 't + if$ + nameptr #1 + 'nameptr := + namesleft #1 - 'namesleft := + } + while$ + } if$ +} +FUNCTION {format.key} +{ empty$ + { key field.or.null } + { "" } + if$ +} + +FUNCTION {format.authors} +{ author "author" format.names +} +FUNCTION {get.bbl.editor} +{ editor num.names$ #1 > 'bbl.editors 'bbl.editor if$ } + +FUNCTION {format.editors} +{ editor "editor" format.names duplicate$ empty$ 'skip$ + { + "," * + " " * + get.bbl.editor + * + } + if$ +} +FUNCTION {format.isbn} +{ isbn "isbn" bibinfo.check + duplicate$ empty$ 'skip$ + { + new.block + "ISBN " swap$ * + } + if$ +} + +FUNCTION {format.issn} +{ issn "issn" bibinfo.check + duplicate$ empty$ 'skip$ + { + new.block + "ISSN " swap$ * + } + if$ +} + +FUNCTION {format.doi} +{ doi "doi" bibinfo.check + duplicate$ empty$ 'skip$ + { + new.block + "\doi{" swap$ * "}" * + } + if$ +} +FUNCTION {format.note} +{ + note empty$ + { "" } + { note #1 #1 substring$ + duplicate$ "{" = + 'skip$ + { output.state mid.sentence = + { "l" } + { "u" } + if$ + change.case$ + } + if$ + note #2 global.max$ substring$ * "note" bibinfo.check + } + if$ +} + +FUNCTION {format.title} +{ title + "title" bibinfo.check +} +FUNCTION {format.full.names} +{'s := + "" 't := + #1 'nameptr := + s num.names$ 'numnames := + numnames 'namesleft := + { namesleft #0 > } + { s nameptr + "{vv~}{ll}" format.name$ + 't := + nameptr #1 > + { + namesleft #1 > + { ", " * t * } + { + s nameptr "{ll}" format.name$ duplicate$ "others" = + { 't := } + { pop$ } + if$ + t "others" = + { + " " * bbl.etal * + } + { + numnames #2 > + { "," * } + 'skip$ + if$ + bbl.and + space.word * t * + } + if$ + } + if$ + } + 't + if$ + nameptr #1 + 'nameptr := + namesleft #1 - 'namesleft := + } + while$ +} + +FUNCTION {author.editor.key.full} +{ author empty$ + { editor empty$ + { key empty$ + { cite$ #1 #3 substring$ } + 'key + if$ + } + { editor format.full.names } + if$ + } + { author format.full.names } + if$ +} + +FUNCTION {author.key.full} +{ author empty$ + { key empty$ + { cite$ #1 #3 substring$ } + 'key + if$ + } + { author format.full.names } + if$ +} + +FUNCTION {editor.key.full} +{ editor empty$ + { key empty$ + { cite$ #1 #3 substring$ } + 'key + if$ + } + { editor format.full.names } + if$ +} + +FUNCTION {make.full.names} +{ type$ "book" = + type$ "inbook" = + or + 'author.editor.key.full + { type$ "proceedings" = + 'editor.key.full + 'author.key.full + if$ + } + if$ +} + +FUNCTION {output.bibitem} +{ newline$ + "\bibitem[{" write$ + label write$ + ")" make.full.names duplicate$ short.list = + { pop$ } + { * } + if$ + "}]{" * write$ + cite$ write$ + "}" write$ + newline$ + "" + before.all 'output.state := +} + +FUNCTION {n.dashify} +{ + 't := + "" + { t empty$ not } + { t #1 #1 substring$ "-" = + { t #1 #2 substring$ "--" = not + { "--" * + t #2 global.max$ substring$ 't := + } + { { t #1 #1 substring$ "-" = } + { "-" * + t #2 global.max$ substring$ 't := + } + while$ + } + if$ + } + { t #1 #1 substring$ * + t #2 global.max$ substring$ 't := + } + if$ + } + while$ +} + +FUNCTION {word.in} +{ bbl.in capitalize + " " * } + +FUNCTION {format.date} +{ year "year" bibinfo.check duplicate$ empty$ + { + "empty year in " cite$ * "; set to ????" * warning$ + pop$ "????" + } + 'skip$ + if$ + extra.label * + before.all 'output.state := + " (" swap$ * ")" * +} +FUNCTION {format.btitle} +{ title "title" bibinfo.check + duplicate$ empty$ 'skip$ + { + emphasize + } + if$ +} +FUNCTION {either.or.check} +{ empty$ + 'pop$ + { "can't use both " swap$ * " fields in " * cite$ * warning$ } + if$ +} +FUNCTION {format.bvolume} +{ volume empty$ + { "" } + { bbl.volume volume tie.or.space.prefix + "volume" bibinfo.check * * + series "series" bibinfo.check + duplicate$ empty$ 'pop$ + { swap$ bbl.of space.word * swap$ + emphasize * } + if$ + "volume and number" number either.or.check + } + if$ +} +FUNCTION {format.number.series} +{ volume empty$ + { number empty$ + { series field.or.null } + { series empty$ + { number "number" bibinfo.check } + { output.state mid.sentence = + { bbl.number } + { bbl.number capitalize } + if$ + number tie.or.space.prefix "number" bibinfo.check * * + bbl.in space.word * + series "series" bibinfo.check * + } + if$ + } + if$ + } + { "" } + if$ +} + +FUNCTION {format.edition} +{ edition duplicate$ empty$ 'skip$ + { + output.state mid.sentence = + { "l" } + { "t" } + if$ change.case$ + "edition" bibinfo.check + " " * bbl.edition * + } + if$ +} +INTEGERS { multiresult } +FUNCTION {multi.page.check} +{ 't := + #0 'multiresult := + { multiresult not + t empty$ not + and + } + { t #1 #1 substring$ + duplicate$ "-" = + swap$ duplicate$ "," = + swap$ "+" = + or or + { #1 'multiresult := } + { t #2 global.max$ substring$ 't := } + if$ + } + while$ + multiresult +} +FUNCTION {format.pages} +{ pages duplicate$ empty$ 'skip$ + { duplicate$ multi.page.check + { + bbl.pages swap$ + n.dashify + } + { + bbl.page swap$ + } + if$ + tie.or.space.prefix + "pages" bibinfo.check + * * + } + if$ +} +FUNCTION {format.journal.pages} +{ pages duplicate$ empty$ 'pop$ + { swap$ duplicate$ empty$ + { pop$ pop$ format.pages } + { + ", " * % manualchangeCZ + swap$ + n.dashify + "pages" bibinfo.check + * + } + if$ + } + if$ +} +FUNCTION {format.journal.eid} +{ eid "eid" bibinfo.check + duplicate$ empty$ 'pop$ + { swap$ duplicate$ empty$ 'skip$ + { + ":" * + } + if$ + swap$ * + } + if$ +} +FUNCTION {format.vol.num.pages} +{ volume field.or.null + duplicate$ empty$ 'skip$ + { + "volume" bibinfo.check + } + if$ + number "number" bibinfo.check duplicate$ empty$ 'skip$ + { + swap$ duplicate$ empty$ + { "there's a number but no volume in " cite$ * warning$ } + 'skip$ + if$ + swap$ + "(" swap$ * ")" * + } + if$ * + eid empty$ + { format.journal.pages } + { format.journal.eid } + if$ +} + +FUNCTION {format.chapter.pages} +{ chapter empty$ + 'format.pages + { type empty$ + { bbl.chapter } + { type "l" change.case$ + "type" bibinfo.check + } + if$ + chapter tie.or.space.prefix + "chapter" bibinfo.check + * * + pages empty$ + 'skip$ + { ", " * format.pages * } + if$ + } + if$ +} + +FUNCTION {format.booktitle} +{ + booktitle "booktitle" bibinfo.check + emphasize +} +FUNCTION {format.in.ed.booktitle} +{ format.booktitle duplicate$ empty$ 'skip$ + { + editor "editor" format.names.ed duplicate$ empty$ 'pop$ + { + "," * + " " * + get.bbl.editor + ", " * + * swap$ + * } + if$ + word.in swap$ * + } + if$ +} +FUNCTION {format.thesis.type} +{ type duplicate$ empty$ + 'pop$ + { swap$ pop$ + "t" change.case$ "type" bibinfo.check + } + if$ +} +FUNCTION {format.tr.number} +{ number "number" bibinfo.check + type duplicate$ empty$ + { pop$ bbl.techrep } + 'skip$ + if$ + "type" bibinfo.check + swap$ duplicate$ empty$ + { pop$ "t" change.case$ } + { tie.or.space.prefix * * } + if$ +} +FUNCTION {format.article.crossref} +{ + word.in + " \cite{" * crossref * "}" * +} +FUNCTION {format.book.crossref} +{ volume duplicate$ empty$ + { "empty volume in " cite$ * "'s crossref of " * crossref * warning$ + pop$ word.in + } + { bbl.volume + capitalize + swap$ tie.or.space.prefix "volume" bibinfo.check * * bbl.of space.word * + } + if$ + " \cite{" * crossref * "}" * +} +FUNCTION {format.incoll.inproc.crossref} +{ + word.in + " \cite{" * crossref * "}" * +} +FUNCTION {format.org.or.pub} +{ 't := + "" + address empty$ t empty$ and + 'skip$ + { + t empty$ + { address "address" bibinfo.check * + } + { t * + address empty$ + 'skip$ + { ", " * address "address" bibinfo.check * } + if$ + } + if$ + } + if$ +} +FUNCTION {format.publisher.address} +{ publisher "publisher" bibinfo.warn format.org.or.pub +} + +FUNCTION {format.organization.address} +{ organization "organization" bibinfo.check format.org.or.pub +} + +FUNCTION {article} +{ output.bibitem + format.authors "author" output.check + author format.key output + new.block + format.title "title" output.check + new.block + crossref missing$ + { + journal + "journal" bibinfo.check + emphasize + "journal" output.check + format.vol.num.pages output + format.date "year" output.check + } + { format.article.crossref output.nonnull + format.pages output + } + if$ +% format.issn output % manualchangeCZ + format.doi output + new.block + format.note output + fin.entry +} +FUNCTION {book} +{ output.bibitem + author empty$ + { format.editors "author and editor" output.check + editor format.key output + } + { format.authors output.nonnull + crossref missing$ + { "author and editor" editor either.or.check } + 'skip$ + if$ + } + if$ + new.block + format.btitle "title" output.check + crossref missing$ + { format.bvolume output + new.block + format.number.series output + new.sentence + format.publisher.address output + } + { + new.block + format.book.crossref output.nonnull + } + if$ + format.edition output + format.date "year" output.check + format.isbn output + format.doi output + new.block + format.note output + fin.entry +} +FUNCTION {booklet} +{ output.bibitem + format.authors output + author format.key output + new.block + format.title "title" output.check + new.block + howpublished "howpublished" bibinfo.check output + address "address" bibinfo.check output + format.date "year" output.check + format.isbn output + format.doi output + new.block + format.note output + fin.entry +} + +FUNCTION {inbook} +{ output.bibitem + author empty$ + { format.editors "author and editor" output.check + editor format.key output + } + { format.authors output.nonnull + crossref missing$ + { "author and editor" editor either.or.check } + 'skip$ + if$ + } + if$ + new.block + format.btitle "title" output.check + crossref missing$ + { + format.bvolume output + format.chapter.pages "chapter and pages" output.check + new.block + format.number.series output + new.sentence + format.publisher.address output + } + { + format.chapter.pages "chapter and pages" output.check + new.block + format.book.crossref output.nonnull + } + if$ + format.edition output + format.date "year" output.check + crossref missing$ + { format.isbn output } + 'skip$ + if$ + format.doi output + new.block + format.note output + fin.entry +} + +FUNCTION {incollection} +{ output.bibitem + format.authors "author" output.check + author format.key output + new.block + format.title "title" output.check + new.block + crossref missing$ + { format.in.ed.booktitle "booktitle" output.check + format.bvolume output + format.number.series output + format.chapter.pages output + new.sentence + format.publisher.address output + format.edition output + format.date "year" output.check + format.isbn output + } + { format.incoll.inproc.crossref output.nonnull + format.chapter.pages output + } + if$ + format.doi output + new.block + format.note output + fin.entry +} +FUNCTION {inproceedings} +{ output.bibitem + format.authors "author" output.check + author format.key output + new.block + format.title "title" output.check + new.block + crossref missing$ + { format.in.ed.booktitle "booktitle" output.check + format.bvolume output + format.number.series output + format.pages output + new.sentence + publisher empty$ + { format.organization.address output } + { organization "organization" bibinfo.check output + format.publisher.address output + } + if$ + format.date "year" output.check + format.isbn output + format.issn output + } + { format.incoll.inproc.crossref output.nonnull + format.pages output + } + if$ + format.doi output + new.block + format.note output + fin.entry +} +FUNCTION {conference} { inproceedings } +FUNCTION {manual} +{ output.bibitem + format.authors output + author format.key output + new.block + format.btitle "title" output.check + organization address new.block.checkb + organization "organization" bibinfo.check output + address "address" bibinfo.check output + format.edition output + format.date "year" output.check + format.doi output + new.block + format.note output + fin.entry +} + +FUNCTION {mastersthesis} +{ output.bibitem + format.authors "author" output.check + author format.key output + new.block + format.btitle + "title" output.check + new.block + bbl.mthesis format.thesis.type output.nonnull + school "school" bibinfo.warn output + address "address" bibinfo.check output + format.date "year" output.check + format.doi output + new.block + format.note output + fin.entry +} + +FUNCTION {misc} +{ output.bibitem + format.authors output + author format.key output + new.block + format.title output + new.block + howpublished "howpublished" bibinfo.check output + format.date "year" output.check + format.doi output + new.block + format.note output + fin.entry +} +FUNCTION {phdthesis} +{ output.bibitem + format.authors "author" output.check + author format.key output + new.block + format.btitle + "title" output.check + new.block + bbl.phdthesis format.thesis.type output.nonnull + school "school" bibinfo.warn output + address "address" bibinfo.check output + format.date "year" output.check + format.doi output + new.block + format.note output + fin.entry +} + +FUNCTION {proceedings} +{ output.bibitem + format.editors output + editor format.key output + new.block + format.btitle "title" output.check + format.bvolume output + format.number.series output + new.sentence + publisher empty$ + { format.organization.address output } + { organization "organization" bibinfo.check output + format.publisher.address output + } + if$ + format.date "year" output.check + format.isbn output + format.issn output + format.doi output + new.block + format.note output + fin.entry +} + +FUNCTION {techreport} +{ output.bibitem + format.authors "author" output.check + author format.key output + new.block + format.title + "title" output.check + new.block + format.tr.number output.nonnull + institution "institution" bibinfo.warn output + address "address" bibinfo.check output + format.date "year" output.check + format.doi output + new.block + format.note output + fin.entry +} + +FUNCTION {unpublished} +{ output.bibitem + format.authors "author" output.check + author format.key output + new.block + format.title "title" output.check + format.date "year" output.check + format.doi output + new.block + format.note "note" output.check + fin.entry +} + +FUNCTION {default.type} { misc } +READ +FUNCTION {sortify} +{ purify$ + "l" change.case$ +} +INTEGERS { len } +FUNCTION {chop.word} +{ 's := + 'len := + s #1 len substring$ = + { s len #1 + global.max$ substring$ } + 's + if$ +} +FUNCTION {format.lab.names} +{ 's := + "" 't := + s #1 "{vv~}{ll}" format.name$ + s num.names$ duplicate$ + #2 > + { pop$ + " " * bbl.etal * + } + { #2 < + 'skip$ + { s #2 "{ff }{vv }{ll}{ jj}" format.name$ "others" = + { + " " * bbl.etal * + } + { bbl.and space.word * s #2 "{vv~}{ll}" format.name$ + * } + if$ + } + if$ + } + if$ +} + +FUNCTION {author.key.label} +{ author empty$ + { key empty$ + { cite$ #1 #3 substring$ } + 'key + if$ + } + { author format.lab.names } + if$ +} + +FUNCTION {author.editor.key.label} +{ author empty$ + { editor empty$ + { key empty$ + { cite$ #1 #3 substring$ } + 'key + if$ + } + { editor format.lab.names } + if$ + } + { author format.lab.names } + if$ +} + +FUNCTION {editor.key.label} +{ editor empty$ + { key empty$ + { cite$ #1 #3 substring$ } + 'key + if$ + } + { editor format.lab.names } + if$ +} + +FUNCTION {calc.short.authors} +{ type$ "book" = + type$ "inbook" = + or + 'author.editor.key.label + { type$ "proceedings" = + 'editor.key.label + 'author.key.label + if$ + } + if$ + 'short.list := +} + +FUNCTION {calc.label} +{ calc.short.authors + short.list + "(" + * + year duplicate$ empty$ + short.list key field.or.null = or + { pop$ "" } + 'skip$ + if$ + * + 'label := +} + +FUNCTION {sort.format.names} +{ 's := + #1 'nameptr := + "" + s num.names$ 'numnames := + numnames 'namesleft := + { namesleft #0 > } + { s nameptr + "{vv{ } }{ll{ }}{ ff{ }}{ jj{ }}" + format.name$ 't := + nameptr #1 > + { + " " * + namesleft #1 = t "others" = and + { "zzzzz" * } + { t sortify * } + if$ + } + { t sortify * } + if$ + nameptr #1 + 'nameptr := + namesleft #1 - 'namesleft := + } + while$ +} + +FUNCTION {sort.format.title} +{ 't := + "A " #2 + "An " #3 + "The " #4 t chop.word + chop.word + chop.word + sortify + #1 global.max$ substring$ +} +FUNCTION {author.sort} +{ author empty$ + { key empty$ + { "to sort, need author or key in " cite$ * warning$ + "" + } + { key sortify } + if$ + } + { author sort.format.names } + if$ +} +FUNCTION {author.editor.sort} +{ author empty$ + { editor empty$ + { key empty$ + { "to sort, need author, editor, or key in " cite$ * warning$ + "" + } + { key sortify } + if$ + } + { editor sort.format.names } + if$ + } + { author sort.format.names } + if$ +} +FUNCTION {editor.sort} +{ editor empty$ + { key empty$ + { "to sort, need editor or key in " cite$ * warning$ + "" + } + { key sortify } + if$ + } + { editor sort.format.names } + if$ +} +FUNCTION {presort} +{ calc.label + label sortify + " " + * + type$ "book" = + type$ "inbook" = + or + 'author.editor.sort + { type$ "proceedings" = + 'editor.sort + 'author.sort + if$ + } + if$ + #1 entry.max$ substring$ + 'sort.label := + sort.label + * + " " + * + title field.or.null + sort.format.title + * + #1 entry.max$ substring$ + 'sort.key$ := +} + +ITERATE {presort} +SORT +STRINGS { last.label next.extra } +INTEGERS { last.extra.num number.label } +FUNCTION {initialize.extra.label.stuff} +{ #0 int.to.chr$ 'last.label := + "" 'next.extra := + #0 'last.extra.num := + #0 'number.label := +} +FUNCTION {forward.pass} +{ last.label label = + { last.extra.num #1 + 'last.extra.num := + last.extra.num int.to.chr$ 'extra.label := + } + { "a" chr.to.int$ 'last.extra.num := + "" 'extra.label := + label 'last.label := + } + if$ + number.label #1 + 'number.label := +} +FUNCTION {reverse.pass} +{ next.extra "b" = + { "a" 'extra.label := } + 'skip$ + if$ + extra.label 'next.extra := + extra.label + duplicate$ empty$ + 'skip$ + { "{\natexlab{" swap$ * "}}" * } + if$ + 'extra.label := + label extra.label * 'label := +} +EXECUTE {initialize.extra.label.stuff} +ITERATE {forward.pass} +REVERSE {reverse.pass} +FUNCTION {bib.sort.order} +{ sort.label + " " + * + year field.or.null sortify + * + " " + * + title field.or.null + sort.format.title + * + #1 entry.max$ substring$ + 'sort.key$ := +} +ITERATE {bib.sort.order} +SORT +FUNCTION {begin.bib} +{ preamble$ empty$ + 'skip$ + { preamble$ write$ newline$ } + if$ + "\begin{thebibliography}{" number.label int.to.str$ * "}" * + write$ newline$ + "\providecommand{\natexlab}[1]{#1}" + write$ newline$ + "\expandafter\ifx\csname urlstyle\endcsname\relax" + write$ newline$ + " \providecommand{\doi}{doi\,\begingroup \urlstyle{rm}\Url}\else" + write$ newline$ +% " \providecommand{\doi}[1]{doi\,\href{http://dx.doi.org/#1}{\url#1}}\fi" + " \providecommand{\doi}[1]{\href{http://dx.doi.org/#1}{doi-link}}\fi" + write$ newline$ +} +EXECUTE {begin.bib} +EXECUTE {init.state.consts} +ITERATE {call.type$} +FUNCTION {end.bib} +{ newline$ + "\end{thebibliography}" write$ newline$ +} +EXECUTE {end.bib} +%% End of customized bst file +%% +%% End of file `test.bst'. diff --git a/documentation/euler_angles.tex b/documentation/euler_angles.tex new file mode 100644 index 000000000..937510c65 --- /dev/null +++ b/documentation/euler_angles.tex @@ -0,0 +1,20 @@ +\chapter{Crystallographic orientations} +\section{Bunge Euler angles} +\label{bunges} +Euler angles (\beaphiI, \beaPhi , \beaphiII) -- in Bunge convention -- rotate the sample coordinate system ($X$,~$Y$,~$Z$ or RD,~TD,~ND) into the crystal coordinate system ($x_c$, $y_c$, $z_c$). +Three successive rotations are carried out in the following way \citep[pg.\,4]{Bunge1982}: +\begin{enumerate} + \item Rotate by angle $\pI$ around Z, to bring X into the $x_c$--$y_c$-plane. The new intermediate axes are X', Y' and Z (Z is unchanged). + \item Now rotate $\beaPhi$ degrees around X', to make Z parallel with $z_c$. The intermediate axes are X', Y'', Z'. + \item A rotation by angle $\pII$ around Z' makes the rotated axes then identical to the crystal axes. +\end{enumerate} + +The rotation matrix can be calculated as +\[% Gottstein pg 55 +\bsym{g}=\left(\begin{array}{ccc} +\cos{\pI}\cos{\pII}-\sin{\pI}\sin{\pII}\cos{\beaPhi} & \sin{\pI}\cos{\pII}+\cos{\pI}\sin{\pII}\cos{\beaPhi}& \sin{\pII}\sin{\beaPhi}\\ +-\cos{\pI}\sin{\pII}-\sin{\pI}\cos{\pII}\cos{\beaPhi} & -\sin{\pI}\cos{\pII}+\cos{\pI}\cos{\pII}\cos{\beaPhi}& \cos{\pII}\sin{\beaPhi}\\ +\sin{\pI}\sin{\beaPhi} & -\cos{\pI}\sin{\beaPhi}& \cos{\beaPhi} +\end{array}\right) +\] + diff --git a/documentation/header.tex b/documentation/header.tex new file mode 100644 index 000000000..1ba9b539d --- /dev/null +++ b/documentation/header.tex @@ -0,0 +1,345 @@ +%\NeedsTeXFormat{LaTeX2e} +%%% check whether we are running pdflatex +% http://www.db.informatik.uni-bremen.de/~mr/pdflatex.html +% \newif\ifpdf +% \ifx\pdfoutput\undefined +% \pdffalse % we are not running pdflatex +% \else +% \pdfoutput=1 % we are running pdflatex +% \pdfcompresslevel=9 % compression level for text and image; +% \pdftrue +% \fi + +%%% choose global options depending on whether +%%% we are running under pdflatex + +% \ifpdf +%\ifx\pdfoutput +%\documentclass[pdftex,a4paper,10pt,makeidx]{article} +%\documentclass[pdftex,a4paper,10pt,makeidx]{book} +%\documentclass[pdftex,a4paper,12pt]{book} +%\documentclass[pdftex,a4paper,12pt]{report} +%\documentclass[pdftex,a5paper,9pt]{book} +%\documentclass[pdftex,a4paper,11pt]{book} +\documentclass[pdftex,a4paper,12pt]{book} % DISS +%\documentclass[pdftex,a4paper,12pt]{article} % List of publications +% \else +%\fi +%\ifx\pdfoutput\undefined +% \documentclass[dvips,a4paper,10pt,makeidx]{article} +%\fi + +% WINDOWS: use sumatra pdfviewer with TeXnicCenter to do inverse search +%http://www.wi.uni-muenster.de/qm/studieren/LaTeXVorlage.html +\usepackage{pdfsync} % comment out for final document + +\usepackage{ifpdf} % uses oberdiek, cannot be used before documentclass +\usepackage{etex} % Without there will be many "No room for a new \dimen" errors +\usepackage{a4} +\usepackage[T1]{fontenc} % EC-Schriften("richtige"Umlaute) +\usepackage[latin1]{inputenc} % Input coding +%\usepackage[utf8]{inputenc} % Input coding + +%\renewcommand\appendixname{}% " +\renewcommand\figurename{Fig.} +\renewcommand\tablename{Tab.} +%\usepackage{csquotes} % consistent quoting by \enquote{...}, without use \lq xyz\rq or \lqq xyz \rqq +% TABLES +%\usepackage{array,booktabs} +\usepackage{upgreek} +\usepackage{ulem} % provides \sout strikeout +\normalem % restore italics for emph +\usepackage{pifont} % checkmark = \ding{52} +\usepackage{textcomp} % provides \textnumero +\usepackage{txfonts} % gammaup, upright greek characters +\usepackage{booktabs} % Nicer Tables, provides \toprule, \midrule, \bottomrule +\usepackage{longtable} +\usepackage{multirow}% added090731, \multirow{3}{*}{content}, * for width +%\usepackage{ltablex} +%\usepackage{tabulary}% +%\usepackage{ltxtable}% longable meet tabularx +%\usepackage{tools} + +%\usepackage{sfheaders} % SansSerif Font für Überschriften / for headings +\usepackage{pictex} % Plot-Paket +\usepackage{anysize} % Uses full page, all of papersize, looks bad! +%\usepackage{fullpage} +\usepackage{xspace} % provides \xspace +%\usepackage[pdftex]{lscape} % Provides \begin{landscape} environment +\usepackage{pdflscape} % Provides \begin{landscape} environment +%%%%%%%%%%%%%%%%%%%%% +\usepackage{graphicx} % PS-diagram package of pictures merge +%\usepackage[draft]{graphicx} % PS-Grafikpaket nur Rahmen +%%%%%%%%%%%%%%%%%%%%% +\usepackage{psfrag} % PS-Text durch LaTeX-Code ersetzen +%\usepackage{draftstamp} %%%%%%%%%% Entwurfstempel; draftstamp.sty %%%%%%%%%%%%%%%%% +\usepackage{placeins} % definiert Floatsperre \FloatBarrier; placeins.sty +\usepackage[indent,bf]{caption} % Einstellen des caption-Stils, war caption2 +%\captionindent2em % Maß für Einzug +% Workaround for backcite problem +\usepackage{makerobust} +\makeatletter +\@ifundefined{caption@xref}{}{% + \MakeRobustCommand\caption@xref +} +\makeatother +%I have notified the author of the caption package. +%Yours sincerely +% Heiko + +% Workaround against double definition error by using amssymb and txfonts:iint +\let\iint\dadada +\let\iiint\dadadaa +\let\iiiint\dadadab +\let\idotsint\dadadac + +\usepackage{exscale} % richtig skalierte Operatoren in Formeln +\usepackage{amsmath} % Mathematik-Erweiterungen der AMS +\usepackage{amssymb} % Mathematik-Erweiterungen der AMS +%\usepackage{onlyamsmath} +% ftp://tug.ctan.org/pub/tex-archive/info/Free_Math_Font_Survey/survey.html +%\usepackage{concmath} % +%\usepackage{mathtime} +%\usepackage{mnsymbol} % incompatible with amssymb & amsfonts, pixelig, neswarrows +%\usepackage{cmbright} +%\usepackage{mathpazo} % funktioniert +\usepackage{times} % von elsart abgeschaut +%\usepackage[math]{anttor} +%\usepackage{millennial} +%\usepackage{fouriernc} % schöneres gamma +%\usepackage{yhmath} % +\usepackage{mathrsfs} % for mathscr (Schreibschrift) +%\usepackage[math]{isomath} + +%\ptexnoligatures%\textfont0 % bewirkt angebl. Unterdrückung von Ligaturen und kerning in pdftex + +\usepackage{afterpage} % Befehlsausführung erst am Seitenende +\usepackage{natbib} % ein natbib-Stil, der auch bei author-year eine +% biblabel Marke im Literaturverzeichnis aufweist! +% natbib.sty ruft eine eigene Konfiguration natbib.cfg auf + +\usepackage{xcolor} +\definecolor{lbcolor}{rgb}{0.9,0.9,0.9} +\definecolor{lightgrey}{rgb}{0.85,0.85,0.85} % +\definecolor{gray}{rgb}{0.5,0.5,0.5}% gray=AE, grey=BE +\definecolor{grey}{rgb}{0.5,0.5,0.5}% gray=AE, grey=BE + +\usepackage{upgreek} + +% KOPF- UND FUSSZEILEN +\usepackage{fancyhdr} % Erwieterte Optionen für +\pagestyle{fancy} % Kopf- und Fußzeilen +\fancyhf{} % Alle Felder leeren +%\fancyfoot{}\fancyhead{} %CZ clear all fields +%\fancyfoot[ro,le]{\footnotesize\thepage} % Seitenzahl außen +%\fancyfoot[l]{\footnotesize\today} +% NUR SEITENZAHL +\fancyfoot[ro,le]{\footnotesize\thepage}%\\\textcolor{gray}{C.\,Zambaldi, \today}} % Seitenzahl +% SEITENZAHL UND VERSION INFO +%\fancyfoot[ro,le]{\footnotesize\thepage\\\textcolor{gray}{C.\,Zambaldi, \today}} % Seitenzahl + +\fancyhead[ro]{\footnotesize{\leftmark} } % Kapitel rechts auf geraden Seiten +\fancyhead[le]{\footnotesize{\rightmark} } % Abschnitt links auf ungeraden Seiten% +%\fancyhead[ro]{\textsc{\small{\leftmark}}} %Zambaldi % Kapitel rechts auf geraden Seiten +%\fancyhead[le]{\textsc{}} %2005 % Abschnitt links auf ungeraden Seiten% +\setlength{\headheight}{15pt}% Höhe der Kopfzeile (def012pt) wg der Linie +\renewcommand{\headrulewidth}{0pt} %def0.4pt +\renewcommand{\footrulewidth}{0pt} %def0pt +\renewcommand\chaptername{} %fancyhdr: Kapitelüberschrift ohne "Kapitel" +%\renewcommand{\chaptermark}[1]{\markboth{\textsc{\chaptername\ \thechapter\ \ #1}}{}} +%\renewcommand{\chaptermark}[1]{\markboth{{\thepart-\thechapter\ \ #1}}{}} +\renewcommand{\chaptermark}[1]{\markboth{{\thechapter\ \ #1}}{}} +%\renewcommand{\chaptermark}[1]{\markboth{{\thechapter\ }}{}} +%\renewcommand{\chaptermark}{\empty} +%\markboth{Zambaldi} +\renewcommand{\sectionmark}[1]{\markright{{\thesection\ #1}}}% Kein Punkt hinter Kapitelnummern in Kopfzeile +%\renewcommand{\sectionmark}{\empty} +%\renewcommand{\chaptermark}[1]{} +%\renewcommand{\sectionmark}[1]{} +\fancypagestyle{plain}{% Redefine "plain" style (e.g. for 1st side of chapters) +\fancyhf{} % clear all header and footer fields +%\fancyfoot[l]{{\tiny \today}} +%\fancyfoot[ro,le]{\footnotesize\thepage} +} +% http://www-h.eng.cam.ac.uk/help/tpl/textprocessing/squeeze.html +%\usepackage[medium,compact]{titlesec} % fontsize sections... +\usepackage[small,compact]{titlesec} % fontsize sections... +%\usepackage{sectsty} % An alternative to titlesec + +%\titleformat{\subsection}{\normalfont\normalsize\bfseries}{\thesubsection}{1em}{} %bfseries to add bold style +%\titleformat{\subsubsection}%{\normalfont\normalsize\mdseries\itshape}{\thesubsubsection}{1em}{} +%\titleformat{\subsubsection}{\normalfont\normalsize\bfseries}{\thesubsubsection}{1em}{} + + +% TABELLENBESCHRIFTUNG +%\usepackage[tableposition=top]{caption} + +% EINHEITEN +\usepackage{units} +% \unit[]{} +% \unitfrac[]{}{} +% \nicefrac[]{}{} + +% MILLERSCHE INDICES +\usepackage{miller} % \hkl(123), \hkl<1 2 -3>, change spacing, with +%\renewcommand{\millerskip}{\,\,\,} + +% DOPPELTER ZEILENABSTAND mit \doublespace, weitere +\usepackage{setspace} +\singlespace % \singlespace, \onehalfspace, \doublespace + +% LISTINGS; Quellcode einbinden und formatieren. +\usepackage{listings} %[savemem]{listings} +\lstloadlanguages{fortran} %TeX %[LaTeX]TeX +\lstset{language={}, + frame=none, + xleftmargin=10mm, + xrightmargin=10mm, + numbers=left, + stepnumber=1, + numbersep=5pt, + numberstyle=\tiny, + breaklines=true, + breakautoindent=true, + postbreak=...,%\space, + tabsize=2, + basicstyle=\ttfamily\footnotesize, + showspaces=false, + showstringspaces=false, + extendedchars=true, + backgroundcolor=\color{white} +} + +% --------------------------------------------------------------------------- + +% BILDÜBERLAGERUNG +%\usepackage[abs]{overpic} % [percent] + +%\usepackage{calc} + +% PARAGRAPH INDENTATION AND VERTICAL SPACE +\setlength{\parindent}{0pt} % kein Einzug am Absatz +%\parskip 1.0ex plus 0.2ex minus 0.2ex % Abstand Absatz FR:1.5ex plus 0.5ex minus 0.5ex +\setlength\parskip{.5\baselineskip + plus .1\baselineskip + minus .4\baselineskip +} + +\sloppy % Seitenende "schlampig" +\setcounter{secnumdepth}{3} % Abschnitts-Num.tiefe(def=2) +\setcounter{tocdepth}{3} % Inhaltsverzeichnistiefe (def=2) +\setcounter{bottomnumber}{2} % Max. Gleitobjekte unten (def=1) +\setcounter{totalnumber}{4} % Max. Gleitobjekte insg. (def=3) +\renewcommand{\topfraction}{0.75} % Max. rel. Platz für Gleitobjekte +\renewcommand{\bottomfraction}{0.65} % oben bzw. unten (def=0.7 bzw. 0.3) +\newcommand{\versetzung}[1]{\rotatebox{#1}{\rule[-2mm]{0cm}{4mm}\tiny $\bot$}} % Versetzungssymbol{Winkel} +\newcommand{\vernull}{\tiny $\bot$} % Versetzungssymbol 0 Grad +\newcommand{\vereinsachtnull}{\tiny $\top$} % Versetzungssymbol 180 Grad +\newcommand{\verneunnullp}{\tiny $\dashv$} % Versetzungssymbol 90 Grad +\newcommand{\verneunnullm}{\tiny $\vdash$} % Versetzungssymbol -90 Grad +%\newcommand{\RX}{Rekristallisation} +%, als Dezimaltrennzeichen in Kommazahlen im Mathemodus +\mathchardef\CommaOrdinary="013B +\mathchardef\CommaPunct="613B +\mathcode`,="8000 %, im Math-Mode aktiv machen +{\catcode`\,=\active + \gdef,{\obeyspaces\futurelet\next\CommaCheck}} +\def\CommaCheck{\if\space\next\CommaPunct\else\CommaOrdinary\fi} + +%\def\figurename{} % Fig. oder Abb. +\makeatletter % @ define as normal letters +\def\cleardoublepage{\clearpage \if@twoside \ifodd\c@page % with CLEAR double PAGE second side empty + \else \hbox{} \thispagestyle{empty} \newpage + \if@twocolumn \hbox{} \newpage \fi \fi \fi} +%\renewcommand\part{% % with part first side empty +% \if@openright +% \cleardoublepage +% \else +% \clearpage +% \fi +% \thispagestyle{empty}% +% \if@twocolumn +% \onecolumn +% \@tempswatrue +% \else +% \@tempswafalse +% \fi +% \null\vfil + % \secdef\@part\@spart} +%\makeatother % @ again as other indication define + +% Upright greek characters: http://www.superstrate.net/useful/useful.html +\DeclareFontFamily{U}{euc}{}% I chose euc because the chart is called Euler cursive +\DeclareFontShape{U}{euc}{m}{n}{<-6>eurm5<6-8>eurm7<8->eurm10}{}% +\DeclareSymbolFont{AMSc}{U}{euc}{m}{n} % I chose AMSc because AMSa and AMSb are defined in the amsfonts-package +\DeclareMathSymbol{\umu}{\mathord}{AMSc}{"16} + + +% HYPERREF package definition +\usepackage{color} +\definecolor{lnkcol}{rgb}{0, .1, .5} +\definecolor{lnkcol}{rgb}{0, .1, .5} + + +%\ifpdf + +%\usepackage{pstricks, pst-plot} + +\ifpdf % IFPDF + %\usepackage[pdftex]{thumbpdf} %%% thumbnails for ps2pdf +%\usepackage[ps2pdf]{hyperref} + \usepackage[pdftex, %%% hyper-references for ps2pdf +%backref=section, %%% bibliographical backlinks +pagebackref=true, %%% links in bibliography to pages +bookmarks=true,% %%% generate bookmarks +bookmarksnumbered=false, %%% numbered bookmarks on/off +bookmarksopen=true, %%% bookmarkstree open/closed +hypertexnames=false,% %%% needed for correct links to figures! +breaklinks=true,% %%% break lines on/off, on => links can become very small +pdfborder=false, %%% Links mit Rahmen on/off +pdfpagelabels=true, %%% logische/physikalische Seitenzahlen true/false* +pdftoolbar=true, %%% Menüleisten true*/false +linkbordercolor={1 1 1},% %%% color of frames around links +citebordercolor={1 1 1}, +urlbordercolor={0.8 0.8 .8}, +colorlinks=true, +linkcolor=lnkcol, % black, blue, red, green, cyan, ... +urlcolor=lnkcol,%{.2 .2 1}, +citecolor=black, +]{hyperref} %HYPERREF + +% PDF METAINFORMATION + \hypersetup{ +pdfauthor = {}, +pdftitle = {}, +pdfsubject = {}, +pdfkeywords = {}, +pdfcreator = {}, +pdfproducer = {pdftex}%, +%pdfpagemode={FullScreen} +} + +% ATTACH ARBITRAY FILES TO THE RESULTING PDF. FILES ARE STORED INSIDE OF THE PDF-FILE. +%\usepackage{attachfile} % Only with pdftex. Makes use of "oberdiek" package +%\attachfilesetup{color=0 .1 .5} + + + \usepackage{pst-pdf} % pstricks for pdflatex + +\else + \usepackage{pstricks, pst-plot} + \usepackage[hypertex]{hyperref} +\fi + +\usepackage{textcomp} %Dieses Paket enthaelt die Befehle %\textdegree%\textcentigrade%und eine Menge anderer nuetzlicher Symbole. + + +% MULTIPLE BIBLIOGRAPHIES +%\usepackage{bibunits} + +%\usepackage{makeidx} +%\makeindex + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%% END OF HEADERFILE %%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \ No newline at end of file diff --git a/documentation/mpie_cpfem_macros.tex b/documentation/mpie_cpfem_macros.tex new file mode 100644 index 000000000..a9b1d845d --- /dev/null +++ b/documentation/mpie_cpfem_macros.tex @@ -0,0 +1,163 @@ +% LaTeX spezigfisch +\def\ctr{\centering } + +%Textmakros (Deutsch) +\def\bzw{bzw\. } + +%Textmakros (Englisch) +\def\eg{e.\,g.\@\xspace} +\def\ie{i.\,e.\@\xspace} +\def\cf{c.\,f.\@\xspace} + +%\renewcommand\lq{\lq\xspace} +%\renwecommand\rq{\rq\xspace} + +% TABELLEN +\def\midruleI{\midrule[\heavyrulewidth]} + +% Allgemein +\def\etal{et.~al.\xspace} +\newcommand{\superscript}[1]{\ensuremath{^\textrm{#1}}} +\newcommand{\subscript}[1]{\ensuremath{_\textrm{#1}}} +\def\verweis{$\uparrow$} + +% Track changes in a document +\definecolor{addColor}{rgb}{0, .5, .0} +\definecolor{delColor}{rgb}{.6, .0, .0} +\newcommand{\add}[1]{\cbstart{}\textcolor{addColor}{\uline{#1}}\cbend{}\xspace} +\newcommand{\del}[1]{\cbdelete{}\textcolor{delColor}{\sout{#1}}\xspace} +% Cannot be used in captions so far /!\ +%\newcommand{\add}[1]{#1\xspace} \newcommand{\del}[1]{#1\xspace} +\newcommand{\rep}[2]{\del{#1}\add{#2}} +\newcommand{\done}{\ding{52}\xspace} + + +% INDENTATION +\def\max{\subscript{max}} +\def\Pmax{$P$\hspace{-.3em}\subscript{max}} +\def\hmax{$h$\subscript{max}} +\def\projA{\ensuremath{A\hspace{-0.2em}_{\perp}}\xspace} + +% Figure and Table references +% see also the autoref command from hyperref package +\def\Chapref#1{Chapter~\ref{ch:#1}} +\def\chapref#1{chapter~\ref{ch:#1}} +\def\figref#1{figure~\ref{fig:#1}} +\def\tabref#1{table~\ref{tab:#1}} +\def\Figref#1{Figure~\ref{fig:#1}} +\def\Tabref#1{Table~\ref{tab:#1}} + +%\newcommand{\deg}{\ensuremath{^{\circ}}} + +% Mathe +% \upright +\newcommand{\bsym}[1]{\ensuremath{\boldsymbol{#1}}} % \boldsymbol,\mathbb (blackbord bold), mathsf +%\def\tens{\boldsymbol} +\newcommand{\bsymIV}[1]{\ensuremath{\boldsymbol{\mathbb{#1}}}} +%\newcommand{\bsymIV}[1]{\boldsymbol{\mathcal{#1}}} +%\newcommand{\bsymIV}[1]{\boldsymbol{\mathscr{#1}}} +\newcommand{\tensII}[1]{\bsym{#1}} % tensor of rank 2 +\newcommand{\tensIV}[1]{\bsymIV{#1}} % tensor of rank 4 +\def\kron{\delta} +\def\grad{\text{grad\,}} %gradient + +% Symbole +\def\paralleldir{\ensuremath{\nearrow\hspace{-.4em}\nearrow}\xspace} +\def\antiparalleldir{\ensuremath{\nearrow\hspace{-.4em}\swarrow}\xspace} + +% MECHANIK +\def\sig{\ensuremath{\sigmaup}} +\def\eps{\ensuremath{\varepsilonup}} +\def\strain{\ensuremath{\tensII{\varepsilonup}}} +\def\stress{\ensuremath{\tensII{\sigmaup}}} +\def\hpu{MPa\hspace{-.1em}\ensuremath{\sqrt{\text{m}}}\xspace}%$^{-0.5}$} % Hall-Petch unit for k (slope) + + +\def\PK2{\ensuremath{\bsym{T}}} + +%KRISTALLPLASTIZITAET +\def\burgers{\ensuremath{\bsym{b}}\xspace} +\def\bOD{\ensuremath{\burgers^{\text{O}}}\xspace} +\def\bSU{\ensuremath{\burgers^{\text{S}}}\xspace} +\def\bTW{\ensuremath{\burgers^{\text{T}}}\xspace} + +% MaWi +\def\atpct{at.\%\xspace} +\def\gmat{\ensuremath{\tensII{g}}\xspace} % orientation matrix + +% Kristallo +\newcommand{\angaxis}[2]{#1-around-#2\xspace} + +% Bunge Euler Angles +\def\beaphiI{\ensuremath{\varphi_1}} +\def\beaPhi{\ensuremath{\it{\Phi}}} +\def\beaphiII{\ensuremath{\varphi_2}} +\def\BEAs{\ensuremath{(\beaphiI, \beaPhi, \beaphiII)}\xspace} +% Euler winkel +\def\pI{\ensuremath{\beaphiI}} +\def\pII{\ensuremath{\beaphiII}} + +%\def\fcc{f.c.c.\xspace} +%\def\bcc{b.c.c.\xspace} +%\def\hcp{h.c.p.\xspace} +\def\fcc{fcc\xspace} +\def\bcc{bcc\xspace} +\def\hcp{hcp\xspace} +%\def\fcc{FCC\xspace} +%\def\bcc{BCC\xspace} +%\def\hcp{HCP\xspace} + +% Mikrometer, microns +\def\mum{\ensuremath{\muup}m\xspace} + + +% TiAl +%\def\gam{\ensuremath{\upgamma}} +\def\gam{\texorpdfstring{\ensuremath{\gammaup}}{gamma}\xspace} % requires txfonts package +\def\cgamma{\ensuremath{c_{\gam}}} +\def\agamma{\ensuremath{a_{\gam}}} + +\def\gTiAl{\texorpdfstring{\mbox{\gam-TiAl}}{gamma-TiAl}\xspace} +\def\gammaTiAl{\gTiAl} +\def\caratio{$c\hspace{-1.pt}/\hspace{-1.5pt}a$\;ratio\xspace} +%alpha_2-Ti_3Al +\def\alptwo{\texorpdfstring{\ensuremath{\upalpha_2}}{alpha2}\xspace} +%\def\tiala2{$\alpha_2$-Ti$_3$Al} +%\def\tiala2{$\alpha_2$-Ti$_3$Al} + +%\def\a2ti3al{$\alpha_2$-Ti$_3$Al} +%\def\a2Ti3Al{$\alpha_2$-Ti$_3$Al} +%\def\aIIti3al{$\alpha_2$-Ti$_3$Al} +%\providecommand{\aTi3Al}{\mbox{$\alpha$-Ti$_3$Al}} +\def\a2Ti3Al{\alptwo-Ti\texorpdfstring{$_3$}{3}Al\xspace} +%\providecommand{\a2ti3al}{{$\alpha_2$-Ti$_3$Al}} +%Ti_3Al +\def\Ti3Al{\a2Ti3Al} +\def\ti3al{\a2Ti3Al} +%\def\a2{$\alpha_2$} +%\def\taucO{\ensuremath{\tau_{c,O}}\xspace} +%\def\taucS{\ensuremath{\tau_{c,S}}\xspace} +%\def\taucT{\ensuremath{\tau_{c,T}}\xspace} +\def\taucO{\ensuremath{\tau_{c}^{O}}\xspace} +\def\taucS{\ensuremath{\tau_{c}^{S}}\xspace} +\def\taucT{\ensuremath{\tau_{c}^{T}}\xspace} + +\def\LamAng{\ensuremath{\varPhi_{\text{L}}}\xspace} +\def\MatrixI{M1\xspace} +\def\MatrixII{M2\xspace} +\def\MatrixIII{M3\xspace} +\def\TwinI{T1\xspace} +\def\TwinII{T2\xspace} +\def\TwinIII{T3\xspace} + + +%% Strukturbericht % http://cst-www.nrl.navy.mil/lattice/ +\def\L10{L1$_0$\xspace} +\def\D019{D0$_{19}$\xspace} % 0 (zero) not O + +\newcommand\half{\ensuremath{\nicefrac{1}{2}}} +\newcommand\sixth{\ensuremath{\nicefrac{1}{6}}} +\newcommand\nr{no.\,} + + + diff --git a/documentation/svn_guide.tex b/documentation/svn_guide.tex new file mode 100644 index 000000000..614f788d9 --- /dev/null +++ b/documentation/svn_guide.tex @@ -0,0 +1,37 @@ +\section{Accessing the version controlled subroutine} +% This section is copied from the msuwiki: http://msusrv4/msuwiki/Theory%20and%20Simulation/SVN +Before you start: Before you are able to access the version-controlled software, you need to get a valid login to the msuhp9 server. Please ask either Berthold Becksch\"afer (-922) or Achim Kuhl (-923) to set up your permissions accordingly. + +\subsection{Windows} +\subsubsection{Putty} +Get yourself PuTTY and PuTTYgen from http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html +Generate a RSA (SSH2) 2048 bit strong key pair with PuTTYgen. Save the private part of the key to a secure location (My Documents or such). Copy the public part from the PuTTYgen window, paste it into a text-editor and save. Append the contents of that file to \verb|~/.ssh/authorized_keys| on any workstation you can log on to. +Create a profile in PuTTY called "msuhp9" with host: msuhp9.mpie.de, your standard "MPIE\\myName" username and specify the above location of your private key file as means of authentication. +You should then be able to connect with this profile to msuhp9 WITHOUT password authentication! + +\subsubsection{Tortoise} +Install the subversion-client Tortoise at http://tortoisesvn.net/downloads +Create a directory to hold the CPFEM subroutine on your PC. + +Right-Click in this folder and select "SVN checkout" from the context menu. Specify +svn+ssh://msuhp9/home/svn/repos/cpfem + +as the URL of the desired repository. This will use the profile named "msuhp9" from PuTTY and should hence not ask for any authentication from your end. + +\subsection{Linux workstations} + +\subsubsection{Key authentication} +if not already done, generate a 2048 bit RSA key pair using +ssh-keygen -t rsa -b 2048 +and go for the standard options offered. This will create "id\_rsa" (private key) and "id\_rsa.pub" (public key) within your \verb|~/.ssh| folder. + +Append \verb|id_rsa.pub| to \verb|~/.ssh/authorized_keys| and try logging into another workstation with +ssh MPIE\\\\myName@msuwsX +(exchange X with 2...11). It should NOT require password authentication. + +\subsubsection{Checkout} +create a directory to hold the subversion-controlled CPFEM routine and change into this. +svn checkout svn+ssh://MPIE\\\\myName@msuhp9.mpie.de/home/svn/repos/cpfem +to copy the repository content to the current working directory -- done. + +familiarize yourself with svn: svn help \ No newline at end of file