After a long discussion with CoPilot

Its mostly telling me what it thinks I want to hear, and not offering so much objective perspective - but it helped me go through the use cases. I suggest the following interface:

style.sensor.pixel.field=None

• allow None, "B", "Hxy", "Hx", etc..
• If None all pixels are displayed the same (uniform mode), else we are in the variable mode where all pixel are displayed trying to visualize the given field

style.sensor.pixel.symbol="box" - sets the pixel shape in uniform mode

• allow 2D marker like "o", "*", ... and 3D primitives like "box", "cone", ...

style.sensor.pixel.fieldsymbol="arrow3d" - sets the pixel shape in variable mode

• allow 2D marker like "o", "*", ... and 3D primitives like "box", "cone", ...
• Note: some symbols can display orientation, some cannot, the ones that cannot should not be oriented (like eg. "box")

style.sensor.pixel.size=1.0

• allow all numbers >0.
• Multiplicative factor on default pixel size which is not always optimal

style.sensor.pixel.sizescaling="uniform"

• options: "uniform", "linear", "log", "loglog"
• as already implemented

style.sensor.pixel.color='k'

• allow any valid color "k", (.1,.2,.3), ...
• sets the uniform mode pixel color

style.sensor.pixel.colormap='Viridis'

• allow standard color maps "Jet", "RgYnBl", ...
• sets the variable mode pixel color

style.sensor.pixel.colorscaling="linear"

• options: "uniform", "linear", "log", "loglog"
• when "uniform" display pixel in style.sensor.pixel.color

@OrtnerMichael Ready for final review!

As discussed in our latest meeting, we are still going to keep the nested structure with the following parameters:

• source (default=None):
  Defines the field source of the vector field representation.

  • None: No field representation is shown
  • "B", "Hxy", "Jxyz", etc.: Colors are mapped to the magnitude of the specified field.

• symbol (default="cone"):
  Specifies the rendering symbol for field values.

  • "none": pixel.symbol representation takes precedence of pixel.field.symbol.
  • "cone": 3D cone representation.
  • "arrow3d": 3D arrow representation.
  • "arrow": 2D line-based arrow.

• shownull (default=True):
  Toggles the visibility of pixel with zero and invalid field vectors.

  • True: Null vectors are displayed.
  • False: Null vectors are hidden.

• sizescaling (default="uniform"):
  Determines how arrow size relates to the source magnitude.

  • "uniform": Uniform arrow size.
  • "linear": Size proportional to magnitude.
  • "log": Size proportional to the normalized logarithm of the magnitude.
  • "log^n": Size proportional to the normalized nth (2 to 9) logarithm of the magnitude.

• sizemin (default=0.1)
  Minimum relative size of field symbols. A float between 0 and 1.
  When displaying field vectors this controls how small the symbols
  can become relative to their maximum size. A value of 0 allows symbols to shrink to zero size,
  while 0.5 ensures symbols are at least 50% of their maximum size.

• colorscaling (default="uniform"):
  Determines how arrow color relates to the source magnitude.

  • "uniform": Uniform color for all arrows.
  • "linear": Color scaling proportional to magnitude.
  • "log": Color scaling proportional to the normalized logarithm of the magnitude.
  • "log^n": Color scaling proportional to the normalized nth (2 to 9) logarithm of the magnitude.

• colormap (default="Viridis"):
  Specifies the colormap used for color mapping. Supports standard color maps (e.g., "Viridis", "Inferno", "Magma", etc.) compatible with both Plotly and Matplotlib.