Commit c94a38c2 authored by Aron Helser's avatar Aron Helser

Initial doc of 'Load No Chart Variables' setting, add build.md.

build.md contains a first pass at build instructions for the
LaTeX to pdf manual.

Also fixed a couple typos.
parent 48b46add
Pipeline #27461 passed with stage
......@@ -16,5 +16,6 @@
!ParaViewCatalyst/Images/*
!README.md
!CONTRIBUTING.md
!build.md
ParaView/Extras
.*
......@@ -30,18 +30,20 @@ is as follows:
$ git remote add gitlab https://gitlab.kitware.com/username/paraview-guide-ce.git
You can use configure the remote to use SSH access instead, if needed.
5. Edit files and create commits (repeat as needed):
5. Install dependencies and [build][build.md]
6. Edit files and create commits (repeat as needed):
$ git checkout -b my-topic origin/master
$ edit file1 file2 file3
$ git add file1 file2 file3
$ git commit
6. Push commits in your topic branch to your fork in GitLab:
7. Push commits in your topic branch to your fork in GitLab:
$ git push gitlab HEAD
7. Visit your fork in GitLab, browse to the "**Merge Requests**" link on the
8. Visit your fork in GitLab, browse to the "**Merge Requests**" link on the
left, and use the "**New Merge Request**" button in the upper right to
create a Merge Request.
......@@ -51,7 +53,6 @@ for the guide.
[merge requests]: https://gitlab.kitware.com/paraview/paraview-guide-ce/merge_requests
[GitLab]: https://gitlab.kitware.com/paraview/paraview-guide-ce/
[Mailing List]: http://www.paraview.org/mailing-lists/
[ParaView Git]: https://gitlab.kitware.com/paraview/paraview/blob/master/CONTRIBUTING.md
[ContributorNotes.tex]: ParaView/ContributorNotes.tex
[GitLab Access]: https://gitlab.kitware.com/users/sign_in
[Fork ParaViewGuide-CE]: https://gitlab.kitware.com/paraview/paraview-guide-ce/fork/new
......
......@@ -131,7 +131,7 @@ animation covers a particular time domain of your choosing.
\begin{didyouknow}
You can change the precision (number of significant digits) displayed by the animation clock
by selecting the \ui{Load All Variables} checkbox under
by changing the \ui{Animation Time Precision} value under
\ui{Settings/Properties Panel Options/Advanced}.
\begin{center}
......
......@@ -962,6 +962,17 @@ an existing view to \ui{Line Chart View}. \ui{Line Chart View} will also be
automatically created if you apply a filter that needs this view, e.g., the
\ui{Plot Over Line} filter.
\begin{didyouknow}
If you generate lengthy data for the \ui{Line Chart View}, the default variables
that are selected may be slow to adjust. You can change \paraview's default
behavior and load no variables at all by selecting the \ui{Load No Chart Variables}
checkbox under \ui{Settings/General/Properties Panel Options}.
\begin{center}
\includegraphics[width=0.4\linewidth]{Images/ChartNoVarSetting.png}
\end{center}
\end{didyouknow}
\subsubsection{Interactions}
Interactions with the chart view result in changing the plotted axes ranges.
......@@ -1175,7 +1186,7 @@ allows you to spot patterns in the small scatter plots, change focus to those
plots of interest, and perform basic selection. The principle is that, for all
selected arrays or series to be plotted, the view generates a scatter plot for
each pair. You can activate a particular scatter plot, in which case the active
plot is re-drawn at a bigger scale to make it easier to for inspection.
plot is re-drawn at a bigger scale to make it easier to inspect.
Additionally, the view shows a histogram for each plotted variable or series.
The view properties allow you to set colors to use for active plot, histograms,
......
Build ParaViewGuide
===================
The ParaView Guide Community Edition is a LaTeX document used to generate a final .pdf file. The Catalyst User's Guide can be built at the same time, in the same way.
## Prerequisites
You need CMake, LaTeX, and ImageMagick.
### CMake
* See the [ParaView docs][] for obtaining CMake.
### Windows
* To get LaTex, install [MikTeX][]
- First, run the MiKTex Update (Admin). You may have to run twice if it updates the updater binary.
- MikTex Package Manager (admin), search and install packages:
> adjustbox, bclogo, catoptions, cite, collectbox, colortbl, enumitem, etoolbox, fancyhdr, floatflt, fncychap, frankenstein, ifoddpage, l3kernel, l3packages, listings, mdframed, mptopdf, ms, paralist, pgf, setspace, subfigure, symbol, url, wrapfig, xcolor, xstring
+ Unfortunately MikTeX automatic install during build doesn't seem to work. If you discover a missing package during build, please add it to this list.
+ [mpm][] command line looks like a good option to do this all at once.
* Install [ImageMagick][], use the recommended download (Q16 precision is fine)
- In the installer, choose 'Install legacy utilities (convert)'
### Linux (Ubuntu)
* To get LaTeX, install a TeXLive package. I tried this, on Ubuntu:
`sudo apt install texlive-latex-base`
** This doesn't include the extra packages, same as those missing on Windows. ToDo: how to install missing packages.
* ImageMagick seems to be installed by default on Ubuntu.
## Run Cmake
If you created a ParaViewGuide/src and ParaViewGuide/build directory, and you cloned the repository into src, then:
* `cd build`
* `cmake-gui ../src` or `ccmake ../src`
- click 'configure'
- You may change whether to build the ParaView Guide and/or the Catalyst User's Guide.
- Generator: I chose the 'MSYS makefiles' generator, after I added MinGW binaries to the path in my Git Bash shell.
- Click 'Advanced'. MIKTEX_BINARY_PATH should be set to something like "C:/Program Files (x86)/MiKTeX 2.9/miktex/bin/" to allow all the LaTeX binaries to be found.
- You may have to manually set the IMAGEMAGICK_CONVERT path, to something like "C:/Program Files/ImageMagick-7.0.3-Q16/convert.exe", if it complains about finding Windows convert.exe instead.
## Build
* `make`
- If any packages are missing, MiKTex will offer to fetch them. However, this failed for me. Copy the package name from the missing .sty dialong, and then in the main MiKTex Package Manager, search for the package name and install it. Build again.
- You will have to build at least twice, so that references can be updated correctly. You will see many warnings during the build process.
[ImageMagick]: http://www.imagemagick.org/script/binary-releases.php
[MikTeX]: http://miktex.org/howto/install-miktex
[mpm]: http://docs.miktex.org/manual/mpm.html
[ParaView docs]: https://gitlab.kitware.com/paraview/paraview/blob/master/CONTRIBUTING.md
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment