nowcasting_dataset icon indicating copy to clipboard operation
nowcasting_dataset copied to clipboard

Document the contents & shapes of the NetCDF files that `nowcasting_dataset` outputs?

Open JackKelly opened this issue 2 years ago • 2 comments

The Pydantic models in the data_sources/<modality>/<modality>_model.py files (where <modality> is one of {datetime, metadata, gsp, nwp, pv, satellite, sun, topographic}) describe the contents of the batches (and, hence, the contents of the NetCDF files). (For example, see satellite_model.py).

But it might be nice to aggregate all that documentation together into a single human-readable page somewhere? So it's really quick and easy for users to get an overview (and to see the detail) of precisely what nowcasting_dataset outputs to disk?

I guess the ideal situation would be to automatically extract the description fields from the pydantic models? I wonder if sphinx can do that?!

Related to #222

JackKelly avatar Oct 13 '21 14:10 JackKelly