This method should be the final call in a pipeline started with create_xml
and one or more calls to add_xml_data.
Please see the wiki for more details https://github.com/JGCRI/gcamdata/wiki/XML-Conversion
run_xml_conversion(dot)The current state of the pipeline started from create_xml
The argument passed in unmodified in case a user wanted run the conversion again at a later time.
Note that this method relies on Java to run the conversion. To avoid errors for
users who do not have Java installed it will check the global option
gcamdata.use_java before attempting to run the conversion. If the flag
is set to FALSE a warning will be issued and the conversion skipped.
To enable the use of Java a user can set options(gcamdata.use_java=TRUE)