Read layers

[jamespanton93]

Pull Request Checklist. Please read and check each box with an X. Delete any part not applicable.

Adding routine for converting 'old' layer files into 'new' ones which include a depth dimension. Add TerraModelLayer subclass

Before your first pull request:

• [X] I have read the guidelines in our CONTRIBUTING.md document.

For all pull requests:

• [X] I have run the contrib/utilities/indent script from the main directory to indent my code.

For new features/models or changes of existing features:

• [X] I have tested my new feature locally to ensure it is correct.
• [X] I have created a testcase for the new feature/benchmark in the tests/ directory.

[anowacki]

Looks good, @jamespanton93. I'm happy to merge without, but it would be good to get some docs on this as well. I guess a sample model file at low resolution would also be good for the layer things. Without that it's a bit hard to test locally anyway.

[anowacki]

Looking a bit more, I think this still needs tests for the layer file IO and tests generally for the TerraModelLayer class.

[anowacki]

I've converted this to a draft due to the above and once it's ready (i.e., has tests, and example files have been uploaded) we can finish it off.

[jamespanton93]

@andreww How can I get an example layer file added to the figshare?

[andreww]

@jamespanton93 - I 'own' the figshare dataset, so you'll need to give me access to the file and I'll upload it. Otherwise you could create your own dataset, add it there, and add the resulting doi to the module with the example handling functions in. In either case, you'll need to modify that file.

[anowacki]

Looking good—thanks!

I fixed a couple of minor things.

Could we maybe add something to the website docs? I guess the layer file format needs specifying in docs/file_formats.md and a mention of the TerraModelLayer class in docs/model.md. If you want to do that in a separate PR, that's okay, or pull in my changes and update this one.