Feat: Graph modal upgrade - flex-config integration

[joshuaunity]

Description

This PR adapts the new SensorsToShowSchema, which introduced the concept of plots and aset flex-config references.

Look & Feel

Before

After

How to test

1. Visit any asset with sensors
2. Navigate to the graph page
3. Click on the "Edit Graphs" button
4. Observe the new changes and test them out
5. Make sure both new and old features work as expected

Further Improvements

Related Items

This PR Closes #1881

Sign-off

• I agree to contribute to the project under Apache 2 License.
• To the best of my knowledge, the proposed patch is not based on code under GPL or other license that is incompatible with FlexMeasures

[read-the-docs-community]

Documentation build overview

📚 flexmeasures | 🛠️ Build #31301718 | 📁 Comparing 9b08119 against latest (e68e4a2)

🔍 Preview build

Show files changed (15 files in total): 📝 14 modified | ➕ 0 added | ➖ 1 deleted

File	Status
changelog.html	📝 modified
genindex.html	📝 modified
_autodoc/AGGREGATE_POWER.html	➖ deleted
_autosummary/flexmeasures.api.v3_0.assets.html	📝 modified
_autosummary/flexmeasures.api.v3_0.sensors.html	📝 modified
_autosummary/flexmeasures.cli.jobs.html	📝 modified
_autosummary/flexmeasures.data.models.generic_assets.html	📝 modified
_autosummary/flexmeasures.data.schemas.generic_assets.html	📝 modified
_autosummary/flexmeasures.data.schemas.utils.html	📝 modified
_autosummary/flexmeasures.utils.coding_utils.html	📝 modified
_autosummary/flexmeasures.utils.html	📝 modified
api/change_log.html	📝 modified
api/v3_0.html	📝 modified
cli/change_log.html	📝 modified
views/asset-data.html	📝 modified

[nhoening]

Good start!
I noticed these things when I tested:

Also, the "Asset Config" tab should be the first option: on the left, open per default. (I believe we want users to use those fields if possible, and use the sensor search if they need more than that). And I would call it "Flex Config".

When selecting an asset, I sometimes see "flex-model" twice under Config-Type.

When I select a different config-type, previously selected field & details should be emptied. Actually, it seems the list of available fields is not replaced, as well.

Some help texts.

• Next to "field" let's have an info icon, explaining that here, fields can be selected (Q: do you only show fields withUnder "Field Details", let's

I wanted to remove such a new field, but nothing happened, also no error.
Removing a traditional field got me "Uncaught ReferenceError: removeSensorFromGraph is not defined"

[nhoening]

Additions I'd like to see:

• Can we add the flex-config information to the plot legends? Now I see "sensor-name (asset-name)" in the legend. But if I selected a sensor for its function in the flex-model, we should make that information visible, as to make the UX clearer. So in the case I selected soc-min, I'd like to see "sensor-name (soc-min for asset-name)". I know this might be a bit tricky to accomplish. But it's important for users to see why a plot was added.
• On compontens.js, I asked for docstrings of the functions, but I believe you only added one.
• The form for flex config settings should have some info icons for help. E.g. which assets are shown in the dropdown? Will fields without value be hidden?

Some things that don't seem to work properly:

• I am actually confused which assets show up in the list - as I am testing it is a short list. I believe it is short because it is limited by pagination (&per_page=10). So that limitation is wrong. But also the set of assets being offered - the issue says: "assets are all assets in the same tree as the currently edited one". For this, the new root parameter of that asset endpoint can be used. On that issue, you discussed with us how to do this.
• Searching for sensors (old-fashioned) gives JS error: "Uncaught ReferenceError: filterSensors is not defined"
• Also, when I select a graph on the left, the button to add a sensor used to switch its text, but now it keeps saying "Add new Graph"

[joshuaunity]

Searching for sensors (old-fashioned) gives JS error: "Uncaught ReferenceError: filterSensors is not defined"

i caught this yesterday as well, i havent pushed my updates yet

Also, when I select a graph on the left, the button to add a sensor used to switch its text, but now it keeps saying "Add new Graph"

This is in progress

I am actually confused which assets show up in the list - as I am testing it is a short list. I belie...

Yes, you are correct, to speed up development on the initial phase, i just fetched the sensors. I will implement this feature now as i did forget

On compontens.js, I asked for docstrings of the functions, but I believe you only added one.

I thought you were referring to only the util function, i can add for the rest too.

[nhoening]

@joshuaunity let me know when this is ready for review

[joshuaunity]

@joshuaunity let me know when this is ready for review

You can go ahead and review, as I'm currently working on the fixed value graphs

[nhoening]

Actually, at least half of my previous review has not been addressed. So then you should not tell me it's okay to review.

Please address these open items from the last review:

• Can we add the flex-config information to the plot legends? Now I see "sensor-name (asset-name)" in the legend. But if I selected a sensor for its function in the flex-model, we should make that information visible, as to make the UX clearer. So in the case I selected soc-min, I'd like to see "sensor-name (soc-min for asset-name)". I know this might be a bit tricky to accomplish. But it's important for users to see why a plot was added.
• The form for flex config settings should have some info icons for help. E.g. which assets are shown in the dropdown? Will fields without value be hidden?
• Searching for sensors (old-fashioned) gives JS error: "Uncaught ReferenceError: filterSensors is not defined"

Also, I found some other things which should be improved:

• There are fields which are booleans (e.g. ' prefer-charging-sooner). Let's not offer those.
• I wanted to remove a field from a graph (clicking "x"), but that did not work. No error in the console.
• There is logs in the console which should go away:
  • "Rendering graph cards..."
  • "Rendering API sensors..."

[nhoening]

The root asset should be the one highest up in the asset tree, not the one that is being worked on. In my last review I pointed you to the issue clearly saying that and also to code which you can use to find it, which @Flix6x had looked up.

Read what the review says.

[joshuaunity]

The following are left

The form for flex config settings should have some info icons for help. E.g. which assets are shown in the dropdown? Will fields without value be hidden?

#1926 (comment)

[nhoening]

The following are left

The form for flex config settings should have some info icons for help. E.g. which assets are shown in the dropdown? Will fields without value be hidden?

#1926 (comment)

Okay, if you get them done by tomorrow I can probably still review.

And you said fixed values (e.g. "30 kW") are already worked on in this PR?

[joshuaunity]

And you said fixed values (e.g. "30 kW") are already worked on in this PR?

Yes, I just made the second phase of major changes, i think this would also be the last phase, so you can check out the feature.