Skip to content
Snippets Groups Projects
Commit 4bd5f428 authored by Powers, Peter M.'s avatar Powers, Peter M.
Browse files

Merge branch 'update-docs-unicode-windows' into 'main'

add note about unicode error and work around for windows users

Closes #558

See merge request !711
parents a1170b7c 741db4e1
No related branches found
No related tags found
2 merge requests!714Production Release | nshmp-haz,!711add note about unicode error and work around for windows users
Pipeline #247068 passed
......@@ -90,6 +90,10 @@ Disaggregations build on and output `HazardCalc` results along with other disagg
files. Disaggregations also have some independent
[configuration](./Calculation-Configuration.md#calculation-configuration-parameters) options.
Windows users may run into errors caused by unicode characters in the disaggregation configuration
options. As a work around, add `-Dfile.encoding="UTF-8"` to the java call (see
[example 7](../../etc/examples/7-disaggregation/README.md) for more details).
## Customizing Code
Whereas *nshmp-haz* contains code to run command line applications and web services, model
......
......@@ -11,6 +11,12 @@ to create a second system alias:
alias disagg='java -Xms4g -Xmx8g -cp /path/to/nshmp-haz/build/libs/nshmp-haz.jar gov.usgs.earthquake.nshmp.DisaggCalc'
```
Note for Windows users: running `nshmp-haz` in command prompt, Power Shell, or GitBash may
result in errors caused by the unicode characters in the disaggregation configuration parameters.
For example: `java.lang.IllegalArgumentException: Invalid ? [0.0]`. To avoid this, try adding
'`-Dfile.encoding="UTF-8"`' before `-cp` in the disagg alias shown above. This error does not
seem to occur if `nshmp-haz` is built and run in the Windows Subsystem for Linux (WSL).
The command line arguments for `DisaggCalc` are the same as those for `HazardCalc`. The target
return period for a disaggregation is specified in the config
[`disagg.returnPeriod`](../../../docs/pages/Calculation-Configuration.md#calculation-configuration-parameters)
......
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