Class: Google::Cloud::Optimization::V1::InjectedSolutionConstraint

Inherits:

Object

• Object
• Google::Cloud::Optimization::V1::InjectedSolutionConstraint

Extended by:

Protobuf::MessageExts::ClassMethods

Includes:

Protobuf::MessageExts

Defined in:

proto_docs/google/cloud/optimization/v1/fleet_routing.rb

Overview

Solution injected in the request including information about which visits must be constrained and how they must be constrained.

Defined Under Namespace

Classes: ConstraintRelaxation

Instance Attribute Summary

• #constraint_relaxations ⇒ ::Array<::Google::Cloud::Optimization::V1::InjectedSolutionConstraint::ConstraintRelaxation>

  For zero or more groups of vehicles, specifies when and how much to relax constraints.

• #routes ⇒ ::Array<::Google::Cloud::Optimization::V1::ShipmentRoute>

  Routes of the solution to inject.

• #skipped_shipments ⇒ ::Array<::Google::Cloud::Optimization::V1::SkippedShipment>

  Skipped shipments of the solution to inject.

Instance Attribute Details

#constraint_relaxations ⇒ ::Array<::Google::Cloud::Optimization::V1::InjectedSolutionConstraint::ConstraintRelaxation>

Returns For zero or more groups of vehicles, specifies when and how much to relax constraints. If this field is empty, all non-empty vehicle routes are fully constrained.

Returns:

• (::Array<::Google::Cloud::Optimization::V1::InjectedSolutionConstraint::ConstraintRelaxation>) —

  For zero or more groups of vehicles, specifies when and how much to relax constraints. If this field is empty, all non-empty vehicle routes are fully constrained.

# File 'proto_docs/google/cloud/optimization/v1/fleet_routing.rb', line 2538

class InjectedSolutionConstraint
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # For a group of vehicles, specifies at what threshold(s) constraints on
  # visits will be relaxed and to which level. Shipments listed in
  # the `skipped_shipment` field are constrained to be skipped; i.e., they
  # cannot be performed.
  # @!attribute [rw] relaxations
  #   @return [::Array<::Google::Cloud::Optimization::V1::InjectedSolutionConstraint::ConstraintRelaxation::Relaxation>]
  #     All the visit constraint relaxations that will apply to visits on
  #     routes with vehicles in `vehicle_indices`.
  # @!attribute [rw] vehicle_indices
  #   @return [::Array<::Integer>]
  #     Specifies the vehicle indices to which the visit constraint
  #     `relaxations` apply. If empty, this is considered the default and the
  #     `relaxations` apply to all vehicles that are not specified in other
  #     `constraint_relaxations`. There can be at most one default, i.e., at
  #     most one constraint relaxation field is allowed empty
  #     `vehicle_indices`. A vehicle index can only be listed once, even within
  #     several `constraint_relaxations`.
  #
  #     A vehicle index is mapped the same as
  #     {::Google::Cloud::Optimization::V1::ShipmentRoute#vehicle_index ShipmentRoute.vehicle_index},
  #     if `interpret_injected_solutions_using_labels` is true (see `fields`
  #     comment).
  class ConstraintRelaxation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # If `relaxations` is empty, the start time and sequence of all visits
    # on `routes` are fully constrained and no new visits may be inserted or
    # added to those routes. Also, a vehicle's start and end time in
    # `routes` is fully constrained, unless the vehicle is empty (i.e., has no
    # visits and has `used_if_route_is_empty` set to false in the model).
    #
    # `relaxations(i).level` specifies the constraint relaxation level applied
    # to a visit #j that satisfies:
    #
    #   * `route.visits(j).start_time >= relaxations(i).threshold_time` AND
    #   * `j + 1 >= relaxations(i).threshold_visit_count`
    #
    # Similarly, the vehicle start is relaxed to `relaxations(i).level` if it
    # satisfies:
    #
    #   * `vehicle_start_time >= relaxations(i).threshold_time` AND
    #   * `relaxations(i).threshold_visit_count == 0`
    # and the vehicle end is relaxed to `relaxations(i).level` if it satisfies:
    #   * `vehicle_end_time >= relaxations(i).threshold_time` AND
    #   * `route.visits_size() + 1 >= relaxations(i).threshold_visit_count`
    #
    # To apply a relaxation level if a visit meets the `threshold_visit_count`
    # OR the `threshold_time` add two `relaxations` with the same `level`:
    # one with only `threshold_visit_count` set and the other with only
    # `threshold_time` set. If a visit satisfies the conditions of multiple
    # `relaxations`, the most relaxed level applies. As a result, from the
    # vehicle start through the route visits in order to the vehicle end, the
    # relaxation level becomes more relaxed: i.e., the relaxation level is
    # non-decreasing as the route progresses.
    #
    # The timing and sequence of route visits that do not satisfy the
    # threshold conditions of any `relaxations` are fully constrained
    # and no visits may be inserted into these sequences. Also, if a
    # vehicle start or end does not satisfy the conditions of any
    # relaxation the time is fixed, unless the vehicle is empty.
    # @!attribute [rw] level
    #   @return [::Google::Cloud::Optimization::V1::InjectedSolutionConstraint::ConstraintRelaxation::Relaxation::Level]
    #     The constraint relaxation level that applies when the conditions
    #     at or after `threshold_time` AND at least `threshold_visit_count` are
    #     satisfied.
    # @!attribute [rw] threshold_time
    #   @return [::Google::Protobuf::Timestamp]
    #     The time at or after which the relaxation `level` may be applied.
    # @!attribute [rw] threshold_visit_count
    #   @return [::Integer]
    #     The number of visits at or after which the relaxation `level` may be
    #     applied. If `threshold_visit_count` is 0 (or unset), the `level` may be
    #     applied directly at the vehicle start.
    #
    #     If it is `route.visits_size() + 1`, the `level` may only be applied to
    #     the vehicle end. If it is more than `route.visits_size() + 1`,
    #     `level` is not applied at all for that route.
    class Relaxation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Expresses the different constraint relaxation levels, which are
      # applied for a visit and those that follow when it satisfies the
      # threshold conditions.
      #
      # The enumeration below is in order of increasing relaxation.
      module Level
        # Implicit default relaxation level: no constraints are relaxed,
        # i.e., all visits are fully constrained.
        #
        # This value must not be explicitly used in `level`.
        LEVEL_UNSPECIFIED = 0

        # Visit start times and vehicle start/end times will be relaxed, but
        # each visit remains bound to the same vehicle and the visit sequence
        # must be observed: no visit can be inserted between them or before
        # them.
        RELAX_VISIT_TIMES_AFTER_THRESHOLD = 1

        # Same as `RELAX_VISIT_TIMES_AFTER_THRESHOLD`, but the visit sequence
        # is also relaxed: visits can only be performed by this vehicle, but
        # can potentially become unperformed.
        RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD = 2

        # Same as `RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD`, but the
        # vehicle is also relaxed: visits are completely free at or after the
        # threshold time and can potentially become unperformed.
        RELAX_ALL_AFTER_THRESHOLD = 3
      end
    end
  end
end

#routes ⇒ ::Array<::Google::Cloud::Optimization::V1::ShipmentRoute>

Returns Routes of the solution to inject. Some routes may be omitted from the original solution. The routes and skipped shipments must satisfy the basic validity assumptions listed for injected_first_solution_routes.

Returns:

• (::Array<::Google::Cloud::Optimization::V1::ShipmentRoute>) —

  Routes of the solution to inject. Some routes may be omitted from the original solution. The routes and skipped shipments must satisfy the basic validity assumptions listed for injected_first_solution_routes.

# File 'proto_docs/google/cloud/optimization/v1/fleet_routing.rb', line 2538

class InjectedSolutionConstraint
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # For a group of vehicles, specifies at what threshold(s) constraints on
  # visits will be relaxed and to which level. Shipments listed in
  # the `skipped_shipment` field are constrained to be skipped; i.e., they
  # cannot be performed.
  # @!attribute [rw] relaxations
  #   @return [::Array<::Google::Cloud::Optimization::V1::InjectedSolutionConstraint::ConstraintRelaxation::Relaxation>]
  #     All the visit constraint relaxations that will apply to visits on
  #     routes with vehicles in `vehicle_indices`.
  # @!attribute [rw] vehicle_indices
  #   @return [::Array<::Integer>]
  #     Specifies the vehicle indices to which the visit constraint
  #     `relaxations` apply. If empty, this is considered the default and the
  #     `relaxations` apply to all vehicles that are not specified in other
  #     `constraint_relaxations`. There can be at most one default, i.e., at
  #     most one constraint relaxation field is allowed empty
  #     `vehicle_indices`. A vehicle index can only be listed once, even within
  #     several `constraint_relaxations`.
  #
  #     A vehicle index is mapped the same as
  #     {::Google::Cloud::Optimization::V1::ShipmentRoute#vehicle_index ShipmentRoute.vehicle_index},
  #     if `interpret_injected_solutions_using_labels` is true (see `fields`
  #     comment).
  class ConstraintRelaxation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # If `relaxations` is empty, the start time and sequence of all visits
    # on `routes` are fully constrained and no new visits may be inserted or
    # added to those routes. Also, a vehicle's start and end time in
    # `routes` is fully constrained, unless the vehicle is empty (i.e., has no
    # visits and has `used_if_route_is_empty` set to false in the model).
    #
    # `relaxations(i).level` specifies the constraint relaxation level applied
    # to a visit #j that satisfies:
    #
    #   * `route.visits(j).start_time >= relaxations(i).threshold_time` AND
    #   * `j + 1 >= relaxations(i).threshold_visit_count`
    #
    # Similarly, the vehicle start is relaxed to `relaxations(i).level` if it
    # satisfies:
    #
    #   * `vehicle_start_time >= relaxations(i).threshold_time` AND
    #   * `relaxations(i).threshold_visit_count == 0`
    # and the vehicle end is relaxed to `relaxations(i).level` if it satisfies:
    #   * `vehicle_end_time >= relaxations(i).threshold_time` AND
    #   * `route.visits_size() + 1 >= relaxations(i).threshold_visit_count`
    #
    # To apply a relaxation level if a visit meets the `threshold_visit_count`
    # OR the `threshold_time` add two `relaxations` with the same `level`:
    # one with only `threshold_visit_count` set and the other with only
    # `threshold_time` set. If a visit satisfies the conditions of multiple
    # `relaxations`, the most relaxed level applies. As a result, from the
    # vehicle start through the route visits in order to the vehicle end, the
    # relaxation level becomes more relaxed: i.e., the relaxation level is
    # non-decreasing as the route progresses.
    #
    # The timing and sequence of route visits that do not satisfy the
    # threshold conditions of any `relaxations` are fully constrained
    # and no visits may be inserted into these sequences. Also, if a
    # vehicle start or end does not satisfy the conditions of any
    # relaxation the time is fixed, unless the vehicle is empty.
    # @!attribute [rw] level
    #   @return [::Google::Cloud::Optimization::V1::InjectedSolutionConstraint::ConstraintRelaxation::Relaxation::Level]
    #     The constraint relaxation level that applies when the conditions
    #     at or after `threshold_time` AND at least `threshold_visit_count` are
    #     satisfied.
    # @!attribute [rw] threshold_time
    #   @return [::Google::Protobuf::Timestamp]
    #     The time at or after which the relaxation `level` may be applied.
    # @!attribute [rw] threshold_visit_count
    #   @return [::Integer]
    #     The number of visits at or after which the relaxation `level` may be
    #     applied. If `threshold_visit_count` is 0 (or unset), the `level` may be
    #     applied directly at the vehicle start.
    #
    #     If it is `route.visits_size() + 1`, the `level` may only be applied to
    #     the vehicle end. If it is more than `route.visits_size() + 1`,
    #     `level` is not applied at all for that route.
    class Relaxation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Expresses the different constraint relaxation levels, which are
      # applied for a visit and those that follow when it satisfies the
      # threshold conditions.
      #
      # The enumeration below is in order of increasing relaxation.
      module Level
        # Implicit default relaxation level: no constraints are relaxed,
        # i.e., all visits are fully constrained.
        #
        # This value must not be explicitly used in `level`.
        LEVEL_UNSPECIFIED = 0

        # Visit start times and vehicle start/end times will be relaxed, but
        # each visit remains bound to the same vehicle and the visit sequence
        # must be observed: no visit can be inserted between them or before
        # them.
        RELAX_VISIT_TIMES_AFTER_THRESHOLD = 1

        # Same as `RELAX_VISIT_TIMES_AFTER_THRESHOLD`, but the visit sequence
        # is also relaxed: visits can only be performed by this vehicle, but
        # can potentially become unperformed.
        RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD = 2

        # Same as `RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD`, but the
        # vehicle is also relaxed: visits are completely free at or after the
        # threshold time and can potentially become unperformed.
        RELAX_ALL_AFTER_THRESHOLD = 3
      end
    end
  end
end

#skipped_shipments ⇒ ::Array<::Google::Cloud::Optimization::V1::SkippedShipment>

Returns Skipped shipments of the solution to inject. Some may be omitted from the original solution. See the routes field.

Returns:

• (::Array<::Google::Cloud::Optimization::V1::SkippedShipment>) —

  Skipped shipments of the solution to inject. Some may be omitted from the original solution. See the routes field.

# File 'proto_docs/google/cloud/optimization/v1/fleet_routing.rb', line 2538

class InjectedSolutionConstraint
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # For a group of vehicles, specifies at what threshold(s) constraints on
  # visits will be relaxed and to which level. Shipments listed in
  # the `skipped_shipment` field are constrained to be skipped; i.e., they
  # cannot be performed.
  # @!attribute [rw] relaxations
  #   @return [::Array<::Google::Cloud::Optimization::V1::InjectedSolutionConstraint::ConstraintRelaxation::Relaxation>]
  #     All the visit constraint relaxations that will apply to visits on
  #     routes with vehicles in `vehicle_indices`.
  # @!attribute [rw] vehicle_indices
  #   @return [::Array<::Integer>]
  #     Specifies the vehicle indices to which the visit constraint
  #     `relaxations` apply. If empty, this is considered the default and the
  #     `relaxations` apply to all vehicles that are not specified in other
  #     `constraint_relaxations`. There can be at most one default, i.e., at
  #     most one constraint relaxation field is allowed empty
  #     `vehicle_indices`. A vehicle index can only be listed once, even within
  #     several `constraint_relaxations`.
  #
  #     A vehicle index is mapped the same as
  #     {::Google::Cloud::Optimization::V1::ShipmentRoute#vehicle_index ShipmentRoute.vehicle_index},
  #     if `interpret_injected_solutions_using_labels` is true (see `fields`
  #     comment).
  class ConstraintRelaxation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # If `relaxations` is empty, the start time and sequence of all visits
    # on `routes` are fully constrained and no new visits may be inserted or
    # added to those routes. Also, a vehicle's start and end time in
    # `routes` is fully constrained, unless the vehicle is empty (i.e., has no
    # visits and has `used_if_route_is_empty` set to false in the model).
    #
    # `relaxations(i).level` specifies the constraint relaxation level applied
    # to a visit #j that satisfies:
    #
    #   * `route.visits(j).start_time >= relaxations(i).threshold_time` AND
    #   * `j + 1 >= relaxations(i).threshold_visit_count`
    #
    # Similarly, the vehicle start is relaxed to `relaxations(i).level` if it
    # satisfies:
    #
    #   * `vehicle_start_time >= relaxations(i).threshold_time` AND
    #   * `relaxations(i).threshold_visit_count == 0`
    # and the vehicle end is relaxed to `relaxations(i).level` if it satisfies:
    #   * `vehicle_end_time >= relaxations(i).threshold_time` AND
    #   * `route.visits_size() + 1 >= relaxations(i).threshold_visit_count`
    #
    # To apply a relaxation level if a visit meets the `threshold_visit_count`
    # OR the `threshold_time` add two `relaxations` with the same `level`:
    # one with only `threshold_visit_count` set and the other with only
    # `threshold_time` set. If a visit satisfies the conditions of multiple
    # `relaxations`, the most relaxed level applies. As a result, from the
    # vehicle start through the route visits in order to the vehicle end, the
    # relaxation level becomes more relaxed: i.e., the relaxation level is
    # non-decreasing as the route progresses.
    #
    # The timing and sequence of route visits that do not satisfy the
    # threshold conditions of any `relaxations` are fully constrained
    # and no visits may be inserted into these sequences. Also, if a
    # vehicle start or end does not satisfy the conditions of any
    # relaxation the time is fixed, unless the vehicle is empty.
    # @!attribute [rw] level
    #   @return [::Google::Cloud::Optimization::V1::InjectedSolutionConstraint::ConstraintRelaxation::Relaxation::Level]
    #     The constraint relaxation level that applies when the conditions
    #     at or after `threshold_time` AND at least `threshold_visit_count` are
    #     satisfied.
    # @!attribute [rw] threshold_time
    #   @return [::Google::Protobuf::Timestamp]
    #     The time at or after which the relaxation `level` may be applied.
    # @!attribute [rw] threshold_visit_count
    #   @return [::Integer]
    #     The number of visits at or after which the relaxation `level` may be
    #     applied. If `threshold_visit_count` is 0 (or unset), the `level` may be
    #     applied directly at the vehicle start.
    #
    #     If it is `route.visits_size() + 1`, the `level` may only be applied to
    #     the vehicle end. If it is more than `route.visits_size() + 1`,
    #     `level` is not applied at all for that route.
    class Relaxation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Expresses the different constraint relaxation levels, which are
      # applied for a visit and those that follow when it satisfies the
      # threshold conditions.
      #
      # The enumeration below is in order of increasing relaxation.
      module Level
        # Implicit default relaxation level: no constraints are relaxed,
        # i.e., all visits are fully constrained.
        #
        # This value must not be explicitly used in `level`.
        LEVEL_UNSPECIFIED = 0

        # Visit start times and vehicle start/end times will be relaxed, but
        # each visit remains bound to the same vehicle and the visit sequence
        # must be observed: no visit can be inserted between them or before
        # them.
        RELAX_VISIT_TIMES_AFTER_THRESHOLD = 1

        # Same as `RELAX_VISIT_TIMES_AFTER_THRESHOLD`, but the visit sequence
        # is also relaxed: visits can only be performed by this vehicle, but
        # can potentially become unperformed.
        RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD = 2

        # Same as `RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD`, but the
        # vehicle is also relaxed: visits are completely free at or after the
        # threshold time and can potentially become unperformed.
        RELAX_ALL_AFTER_THRESHOLD = 3
      end
    end
  end
end