Add a panel to display % Submerged

[DianaTavares]

To add this panel, first #32 needs to be solved.

Preference to show/hide this feature in the Simulation Panel
Title: Percent submerged readout
Query Parameter: percentSubmergedReadout
Default true in Basics, Default false in full Buoyancy

Here are the mockups of its position in each screen:

Intro

Explore

Shapes

Bottle
Observe how, as this is the only object on the screen, the number is bigger and centered:

Boat
Observe that the name in the panel said "% Boat submerged" because in this case, we want to know the percentage of the boat and not the block.

[AgustinVallejo]

The above commit improves on this panel. Still missing:

• Create a visibleProperty and link it to the PreferencesModel
• Improve the API for Shapes Screen (Handled in Final items for ReadoutAccordionBox density-buoyancy-common#105)
• Create a parent class for shared functionality with DensityAccordionBox (Tentatively ReadoutListAccordionBox)
• Don't pass the entire model
• Create a SetMaterialObject: { material | mass, customName, customFormat }

[AgustinVallejo]

Added to the preferences dialog, noting to change the default to false in DensityBuoyancyCommonQueryParameters before moving on (or move on and remember way down the line, it's okay)

[zepumph]

I was just taking a look at the new and improved ReadoutListAccordionBox. I love it! I really like how much we can factor out with setReadout. I believe we can make things much simpler and more suave with a parametric type. If we have a list that can be typesafe, we may be able to move some of the implementation of setReadout to the supertype.

Basic outline:

• ReadoutListAccordionBox<T> uses CustomReadoutObject which has a list: T[].
• DensityAccordionBox extends ReadoutListAccordionBox<TReadOnlyProperty<Material>>
• SubmergedAccordionBox extends ReadoutListAccordionBox<Mass>
• Then setReadout just uses options.list and we have type safety about it. Not sure how helpful this will be, but let's chat.

I'd just like to think about if this would be helpful. Let's talk about it tomorrow.

[zepumph]

• I'm also wondering if we should have the accordion boxes float up when closed. Probably not, but this view here looks a little awkward:
  

[AgustinVallejo]

@zepumph this question comes up often and I think the answer is always to leave the other components floating there. The same happened multiple times in MSS and Keplers. I would check off that item.

[zepumph]

• (see Final items for ReadoutAccordionBox density-buoyancy-common#105 (comment)) We may want to do a bit of work to have them aligned left with a bit of leftMargin set when there is room for it. Otherwise it can be annoying to read as the submerged volume percent changes rapidly.

[zepumph]

Please note that I too am making changes to ReadoutAccordionBox over in #96 (AV and I have discussed this, but I'm adding a paper trail).

[AgustinVallejo]

This issue has been getting some commits that probably rather belong in phetsims/density-buoyancy-common#105

Assigning this issue back to @DianaTavares to check if the Submerged Accordion Box is ready. In that case, please close.

[zepumph]

• @AgustinVallejo, don't we need to change the default value of the preference for Buoyancy Basics? I see a hard coded value based on the query parameter in DensityBuoyancyCommonPreferences.percentageSubmergedVisibleProperty.

@DianaTavares I believe you can still rework on the review in Buoyancy.

[DianaTavares]

Cool!
I have some comments:

In the intro:

• I think is better if these panels are close to the ground (like the mockup)
  
  

• and that the panels to have the same size that in the other screens. This is the picture of Explore:
  

• where is the panel in the application screens? In the first message, I included the mockups

• In Buoyancy (not the basics), the %submerged needs to be by default in the preference as “hide”, and in basics need to be by default close.

[zepumph]

I believe that we are having trouble with the new Property for tracking submerged. On CT is seems like we are trying to set it NaN sometimes. Can you take a look?

[zepumph]

@DianaTavares Please note that this feature is not working when gravity is 0. See #124

[AgustinVallejo]

On our way to close this monster issue. Creating issues for the remaining work:

• Proper formatting in Intro Screen: Changes in the Intro screen  #96
• Adding this to Applications Screen Add submerged % panel to applications screen #125
• Splitting the preferences logic between the three sims of this suite: Updates to preference for percentageSubmergedVisible #126

[phet-dev]

Reopening because there is a TODO marked for this issue.

[zepumph]

Ha, we were so close! Unfortunately both of those TODOs seem good to discuss. @AgustinVallejo let's talk about them.

[AgustinVallejo]

Addressed the colorProperty TODO in the above commit, while improving the way those custom explore options were mapped. Left the other one open since I'd like to discuss: As we're returning that pattern conditionally, I'm not sure if creating a PatternStringProperty right there is the right way to go, or would cause memory leaks.