Python bindings

[HenryDane]

Maybe add python bindings to make this more useable?

[HenryDane]

Python API will probably look something like this:

glEBM.create(num_lat=64, num_lon=64)

• Function for creating model instances
• num_lat and num_lon must be powers of two and must both be >= 32.
• Returns instance of glEBM.Model

glEBM.Model

• class which contains no discernable data (and which does not permit alteration i.e. you cant say model.new_thingy = something)
• provides member functions for interacting with the model instance

glEBM.Model.run(num_years=1, num_days=0, num_mins=0)

• function begins execution of model for a total runtime of num_years + num_days + num_mins.
• the num_... arguments may be floats

glEBM.Model.run_to(num_years=1, num_days=0, num_mins=0)

• runs the model until it has been run for the cumulative amount of time given by num_years + num_days + num_mins.
• if the model's internal clock is already greater than num_years + num_days + num_mins, this function does nothing.

glEBM.Model.fetch(variable: str)

• returns the requested variable (if it exists) as a numpy array of shape (lat, lon)
• if the requested variable does not exist, the function raises a ValueError.

I'd also like to add some way to get/set parameters using dictionary-like syntax.

[HenryDane]

I think this is superseeded by the use of NetCDF files and the plan for feature switches.