Experimental Features

From OctopusWiki
Jump to navigation Jump to search

Why are some parts marked as experimental?

Some features of octopus are declared as experimental, when you try to use them the code will stop with an error. This is done to protect users from parts of Octopus that are not fully implemented or whose results have not been properly validated.

What can happen if I use an experimental feature?

If you are lucky the code might stop with an error or segmentation fault; if you are unlucky the code will run as usual but the results will be wrong.

All results obtained from an Octopus run that uses experimental features should be considered as possibly wrong and should not be used for publications or other scientific presentations.

What can I do if I want to use an experimental feature for my paper?

First, you should check that you really need that particular feature. If you do, you should contact the octopus developers through the octopus-users mailing list to know what the status of that feature is and why it is in experimental status.

When will a certain experimental feature be declared as non-experimental?

It depends. Contact the octopus developers through the octopus-users mailing list to inquire.

How do I use an experimental feature?

First, you have to understand what it means to use an experimental feature. Then, you need to set the input variable ExperimentalFeatures to yes.

Does this mean that non-experimental features of octopus will always work properly?

No. While the developers try to make sure that all octopus components work as they should and are constantly fixing problems, the code still has bugs that may appear. The user is responsible for validating the results for the particular system or property before using it for predictions.