apply phase to FieldData and SimulationData.plot_field

[tylerflex]

#1261

Adds

• FieldData.apply_phase(phase :float) -> FieldData
• phase argument to SimulationData.plot_field that either
  • applies a phase to the field data being plotted (if complex-valued)
  • warns the user that it will be ignored (if real-valued and phase is non-zero)

[e-g-melo]

@tylerflex, I am using the code below to generate a sequence of field images from a FieldMonitor and I am getting that warning about real-valued data. What should I do to get complex-valued data?

phi_range = np.linspace(0, 2*np.pi, 36)
for phi, i in zip(phi_range, range(0,len(phi_range))):  
    fig, ax = plt.subplots(1,1, figsize=(5,5), tight_layout=True)

    sim_data.plot_field("field_xy", "Ey", f=freq_c, ax=ax, phase=phi)
    
    ax.set_aspect('equal')       
    plt.savefig(f'DipAnim/dip_{i:03d}.png', bbox_inches='tight')
    plt.close()

[tylerflex]

My bad, there was a bug, It should be fixed now.

[e-g-melo]

@tylerflex, thank you for this feature! It will help a lot in promoting Tidy3D within the teaching program context.

Both apply_field() and plot_field functions are working. However, the warning message still shows up when using plot_field.

[e-g-melo]

[tylerflex]

great!

[tylerflex]

made all recommend changes