What’s New#

release date PyPI

pypi dwn

v0.3.0 (25 Jan. 2023)#

By G. Maze and K. Balem.

This last release is a major one. It introduces new features and breaking changes in the API.

New features

  • New Argo float configuration manager. It was designed to make easier the access, management and backup of the virtual floats mission configuration parameters. All details are available on the API page FloatConfiguration and the documentation page “Argo floats mission parameters”.

cfg = FloatConfiguration('default')  # Internally defined
cfg = FloatConfiguration('cfg_file.json')  # From json file
cfg = FloatConfiguration([6902919, 132])  # From Euro-Argo Fleet API
cfg.update('parking_depth', 500)  # Update one parameter value
cfg.params  # Return the list of parameters
cfg.mission # Return the configuration as a dictionary, to be pass on a VirtualFleet instance
cfg.to_json("cfg_file.json") # Save to file for later re-use

  • New Argo virtual floats type: this new float type can change their mission parameters when they enter a specific geographic area (a rectangular domain). In order to use these floats, you can load a FloatConfiguration instance with the local-change name, like this:

cfg = FloatConfiguration('local-change')
cfg.update('area_cycle_duration', 120)  # Update default parameters for your own experiment

where you will note the added properties area_*:

<FloatConfiguration><local-change>
      - area_cycle_duration (Maximum length of float complete cycle in AREA): 120.0 [hours]
      - area_parking_depth (Drifting depth in AREA): 1000.0 [m]
      - area_xmax (AREA Eastern bound): -48.0 [deg_longitude]
      - area_xmin (AREA Western bound): -75.0 [deg_longitude]
      - area_ymax (AREA Northern bound): 45.5 [deg_latitude]
      - area_ymin (AREA Southern bound): 33.0 [deg_latitude]
      - cycle_duration (Maximum length of float complete cycle): 240.0 [hours]
      - life_expectancy (Maximum number of completed cycle): 200 [cycle]
      - parking_depth (Drifting depth): 1000.0 [m]
      - profile_depth (Maximum profile depth): 2000.0 [m]
      - vertical_speed (Vertical profiling speed): 0.09 [m/s]

Passing this specific FloatConfiguration instance to a VirtualFleet will automatically select the appropriate Argo float parcel kernels (app_parcels.ArgoFloatKernel_exp). This new float type was developed for the EA-RISE WP2.3 Gulf-Stream experiment.

  • All Argo float types (default and local-change) now come with a proper cycle number property. This makes much easier the tracking of the float profiles.

Utilities:

  • utilities.simu2index, utilities.simu2csv: An Argo profile index extractor from the simulation netcdf output. It is not trivial to extract the position of virtual float profiles from the trajectory file of the simulation output. We made this easier with these functions. It also comes bundled with the VirtualFleet.to_index method.

  • utilities.set_WMO: A function to identify virtual floats with their real WMO from the deployment plan. This could be handful if the deployment plan is actually based on real floats with WMO.

  • utilities.get_float_config: A function to retrieve Argo float cycle configuration using the Euro-Argo meta-data API: .

Breaking changes

v0.2.0 (30 Aug. 2021)#

By K. Balem

# Mission parameters
parking_depth = 1000. #in m
profile_depth = 2000.
vertical_speed = 0.09 #in m/s
cycle_duration = 10. # in days

mission = {'parking_depth':parking_depth, 'profile_depth':profile_depth, 'vertical_speed':vertical_speed, 'cycle_duration':cycle_duration}
VFleet = vaf.virtualfleet(lat=lat, lon=lon, depth=dpt, time=tim, vfield=VELfield, mission=mission)

v0.1.0 (29 Jun. 2020)#

By K. Balem

This is the first release of Virtual Fleet with a single kernel (type of virtual Argo float) available and all its parameters are set internally.