Skip to content
Snippets Groups Projects
Commit be566f60 authored by Lars Bilke's avatar Lars Bilke
Browse files

[web] Added instructions on prj-file checking with xmllint.

parent 775186f4
No related branches found
No related tags found
No related merge requests found
The OGS6 input file parameters are documented in the page hierarchy rooted here.
A project file has the ending `.prj` and is a valid
[XML](https://en.wikipedia.org/wiki/XML) document. To check proper formatting
you can use [`xmllint`](http://xmlsoft.org/xmllint.html), see
[usage instructions](https://www.opengeosys.org/docs/userguide/troubleshooting/project-file/)
in the documentation.
Depending on the type of the parameters the corresponding page titles have
different prefixes, namely:
......
......@@ -13,7 +13,7 @@ weight = 101
This section describes a possible general pre-processing workflow using some of the tools provided by OGS.
To set up a model domain, the project file `*.prj` requires additional input files for the mesh and geometry to apply the boundary conditions accordingly.
To set up a model domain, [the project file `*.prj`](https://doxygen.opengeosys.org/ogs_file_param__ProjectFile.html) requires additional input files for the mesh and geometry to apply the boundary conditions accordingly.
The mesh must be provided in VTK's `*.vtu` format, whereas the geometry can be provided either in OGS' internal `*.gml` file format (not to be confused with the Geography Markup Language) or as a `*.vtu` file as well, containing boundary elements only (Multiple `*.vtu` files can be provided in the project file using the `<meshes>` tag). We recommend the usage of the first method for simple 2D meshes with constant boundary conditions, whereas more complicated geometries and conditions might require the latter method. One general advantage in the utilization of `*.vtu` files is that they allow a definition of additional field variables at each mesh node/element in order to implement spatially varying boundary conditions in a similar manner as defining inhomogeneous material properties.
......
......@@ -27,7 +27,7 @@ Download the latest benchmark files from [GitHub as a .zip-package](https://gith
## Running
OGS is a command line application and requires the path to a `.prj`-file as an argument.
OGS is a command line application and requires the path to a [`.prj`-file](https://doxygen.opengeosys.org/ogs_file_param__ProjectFile.html) as an argument.
::: {.win}
To run it open a new command line shell (called *cmd.exe*). Now simply type `ogs` (if the executable is in your `PATH`-environment variable) or specify its full path (e.g.: `C:\Users\MyUserName\Downloads\ogs.exe`) and hit `ENTER`.
......
+++
date = "2018-11-14T11:00:13+01`:00"
title = "Troubleshooting"
title = "General"
author = "Lars Bilke"
weight = 99
weight = 1
toc = true
[menu]
......
+++
date = "2018-11-14T11:00:13+01`:00"
title = "Project file syntax"
author = "Lars Bilke"
weight = 2
[menu]
[menu.userguide]
parent = "troubleshooting"
+++
## Check project file syntax with `xmllint`
[Project files `.prj`](https://doxygen.opengeosys.org/ogs_file_param__ProjectFile.html) have to be valid XML documents. You can check the formatting with the [`xmllint`-tool](http://xmlsoft.org/xmllint.html):
```bash
xmllint --noout myproj.prj
```
### Install `xmllint`
::: {.win}
We recommend to install via [Chocolatey](https://chocolatey.org):
```powershell
choco install xsltproc
```
::: {.note}
### <i class="far fa-info-circle"></i> Alternative installation
Another method is to use the [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install-win10) where you can simply install Linux packages:
```bash
sudo apt-get install libxml2-utils
```
:::
:::
::: {.linux}
```bash
sudo apt-get install libxml2-utils
```
:::
::: {.mac}
`xmllint` is part of the Homebrew xmlstarlet package:
```bash
brew install xmlstarlet
```
:::
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment