Document special sensor/asset attributes

[Flix6x]

We use a few specifically named sensor attributes and asset attributes in various places of the code, which we'd like to document. Let's start a list here and decide where/how we document them.

[nhoening]

@victorgarcia98 any other attributes we use coming to mind?

[victorgarcia98]

Good idea!

I've looked into the code searching for attributes[ and get_attributes( strings and I found the following:

Asset attributes

• sensors_to_show: already described here. Issue 435 display sensor charts on asset page #449

Sensor attributes

• soc_datetime
• soc_in_mwh
• roundtrip_efficiency
• min_soc_in_mwh
• max_soc_in_mwh
• is_strictly_non_positive
• is_strictly_non_negative
• capacity_in_mw
• is_consumer
• is_producer
• sensor_type
• process-type
• consumption_is_positive
• market_id
• custom-scheduler
• interpolate Feat/interpolate instantaneous sensor charts #851

These fall back to using an asset column, rather than a field of the asset attributes column:

• latitude
• longitude

Data Source attributes

• data_generator

Note: I tried to put the attributes that are retrieved with the get_attributes method in the list that made most sense to me but without considering it deeply. Feel free to edit this comment to sort them out.