From 85fe2453f3ef4a7e1f2a5c90f2e0edf41e2f16ba Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sat, 3 Aug 2024 14:18:10 -0600 Subject: [PATCH 01/24] (doc) max chars aprox 80 per line --- doc/general/concepts.rst | 31 ++++++++++++++------- doc/general/vroom-category.rst | 40 +++++++++++++++++++-------- doc/vroom/vrp_vroomJobsPlain.rst | 3 +- doc/vroom/vrp_vroomPlain.rst | 3 +- doc/vroom/vrp_vroomShipmentsPlain.rst | 3 +- 5 files changed, 55 insertions(+), 25 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index 965383eb0..ccf49a77e 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -22,7 +22,8 @@ Concepts General documentation ------------------------------------------------------------------------------- -Vehicle Routing Problems `VRP` are **NP-hard** optimization problem, it generalises the travelling salesman problem (TSP). +Vehicle Routing Problems `VRP` are **NP-hard** optimization problem, it +generalises the travelling salesman problem (TSP). - The objective of the VRP is to minimize the total route cost. - There are several variants of the VRP problem, @@ -33,9 +34,13 @@ Vehicle Routing Problems `VRP` are **NP-hard** optimization problem, it generali Characteristics ------------------------------------------------------------------------------- -- Capacitated Vehicle Routing Problem `CVRP` where The vehicles have limited carrying capacity of the goods. -- Vehicle Routing Problem with Time Windows `VRPTW` where the locations have time windows within which the vehicle's visits must be made. -- Vehicle Routing Problem with Pickup and Delivery `VRPPD` where a number of goods need to be moved from certain pickup locations to other delivery locations. +- Capacitated Vehicle Routing Problem `CVRP` where The vehicles have limited + carrying capacity of the goods. +- Vehicle Routing Problem with Time Windows `VRPTW` where the locations have + time windows within which the vehicle's visits must be made. +- Vehicle Routing Problem with Pickup and Delivery `VRPPD` where a number of + goods need to be moved from certain pickup locations to other delivery + locations. .. Rubric:: Limitations @@ -49,7 +54,8 @@ Characteristics Pick & Delivery ............................................................................... -Problem: `CVRPPDTW` Capacitated Pick and Delivery Vehicle Routing problem with Time Windows +Problem: `CVRPPDTW` Capacitated Pick and Delivery Vehicle Routing problem with +Time Windows - Times are relative to `0` - The vehicles @@ -63,7 +69,8 @@ Problem: `CVRPPDTW` Capacitated Pick and Delivery Vehicle Routing problem with T - Have pick up and delivery locations. - Have opening and closing times for the pickup and delivery locations. - Have pickup and delivery duration service times. - - have a demand request for moving goods from the pickup location to the delivery location. + - have a demand request for moving goods from the pickup location to the + delivery location. - Time based calculations: @@ -130,12 +137,16 @@ The `capacity` of a vehicle, can be measured in: - Number of boxes that fit in the vehicle. - Number of seats in the vehicle -The `demand` request of the pickup-deliver orders must use the same units as the units used in the vehicle's `capacity`. +The `demand` request of the pickup-deliver orders must use the same units as the +units used in the vehicle's `capacity`. -To handle problems like: 10 (equal dimension) boxes of apples and 5 kg of feathers that are to be transported (not packed in boxes). +To handle problems like: 10 (equal dimension) boxes of apples and 5 kg of +feathers that are to be transported (not packed in boxes). -If the vehicle's `capacity` is measured by `boxes`, a conversion of `kg of feathers` to `equivalent number of boxes` is needed. -If the vehicle's `capacity` is measured by `kg`, a conversion of `box of apples` to `equivalent number of kg` is needed. +If the vehicle's `capacity` is measured by `boxes`, a conversion of `kg of +feathers` to `equivalent number of boxes` is needed. +If the vehicle's `capacity` is measured by `kg`, a conversion of `box of apples` +to `equivalent number of kg` is needed. Showing how the 2 possible conversions can be done diff --git a/doc/general/vroom-category.rst b/doc/general/vroom-category.rst index 31675eebb..a3ff44f80 100644 --- a/doc/general/vroom-category.rst +++ b/doc/general/vroom-category.rst @@ -85,19 +85,35 @@ Terminologies ............................................................................... - **Tasks**: Either jobs or shipments are referred to as tasks. -- **Skills**: Every task and vehicle may have some set of skills. A task can be served by only that vehicle which has all the skills of the task. -- **Priority**: Tasks may have some priority assigned, which is useful when all tasks cannot be performed due to constraints, so the tasks with low priority are left unassigned. -- **Amount (for shipment), Pickup and delivery (for job)**: They denote the multidimensional quantities such as number of items, weights, volume, etc. -- **Capacity (for vehicle)**: Every vehicle may have some capacity, denoting the multidimensional quantities. A vehicle can serve only those sets of tasks such that the total sum of the quantity does not exceed the vehicle capacity, at any point of the route. -- **Time Window**: An interval of time during which some activity can be performed, such as working hours of the vehicle, break of the vehicle, or service start time for a task. -- **Break**: Array of time windows, denoting valid slots for the break start of a vehicle. -- **Setup time**: Setup times serve as a mean to describe the time it takes to get started for a task at a given location. - This models a duration that should not be re-applied for other tasks following at the same place. - So the total "action time" for a task is ``setup + service`` upon arriving at a new location or - ``service`` only if performing a new task at the previous vehicle location. -- **Service time**: The additional time to be spent by a vehicle while serving a task. +- **Skills**: Every task and vehicle may have some set of skills. A task can be + served by only that vehicle which has all the skills of the task. +- **Priority**: Tasks may have some priority assigned, which is useful when all + tasks cannot be performed due to constraints, so the tasks with low priority + are left unassigned. +- **Amount (for shipment), Pickup and delivery (for job)**: They denote the + multidimensional quantities such as number of items, weights, volume, etc. +- **Capacity (for vehicle)**: Every vehicle may have some capacity, denoting the + multidimensional quantities. A vehicle can serve only those sets of tasks such + that the total sum of the quantity does not exceed the vehicle capacity, at + any point of the route. +- **Time Window**: An interval of time during which some activity can be + performed, such as working hours of the vehicle, break of the vehicle, or + service start time for a task. +- **Break**: Array of time windows, denoting valid slots for the break start of + a vehicle. +- **Setup time**: Setup times serve as a mean to describe the time it takes to + get started for a task at a given location. + This models a duration that should not be re-applied for other tasks following + at the same place. + So the total "action time" for a task is ``setup + service`` upon arriving at + a new location or ``service`` only if performing a new task at the previous + vehicle location. +- **Service time**: The additional time to be spent by a vehicle while serving a + task. - **Travel time**: The total time the vehicle travels during its route. -- **Waiting time**: The total time the vehicle is idle, i.e. it is neither traveling nor servicing any task. It is generally the time spent by a vehicle waiting for a task service to open. +- **Waiting time**: The total time the vehicle is idle, i.e. it is neither + traveling nor servicing any task. It is generally the time spent by a vehicle + waiting for a task service to open. .. |timestamp| replace:: ``TIMESTAMP`` or ``INTEGER`` .. |interval| replace:: ``INTERVAL`` or ``INTEGER`` diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index 88aa8dc5a..a596467a9 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -18,7 +18,8 @@ vrp_vroomJobsPlain - Experimental =============================================================================== -``vrp_vroomJobsPlain`` - Vehicle Routing Problem with VROOM, involving only jobs, with plain integer values instead of TIMESTAMP or INTERVAL. +``vrp_vroomJobsPlain`` - Vehicle Routing Problem with VROOM, involving only +jobs, with plain integer values instead of TIMESTAMP or INTERVAL. .. include:: experimental.rst :start-after: begin-warn-expr diff --git a/doc/vroom/vrp_vroomPlain.rst b/doc/vroom/vrp_vroomPlain.rst index dff8e5043..ae2c193ff 100644 --- a/doc/vroom/vrp_vroomPlain.rst +++ b/doc/vroom/vrp_vroomPlain.rst @@ -18,7 +18,8 @@ vrp_vroomPlain - Experimental =============================================================================== -``vrp_vroomPlain`` - Vehicle Routing Problem with VROOM, involving both jobs and shipments, with plain integer values instead of TIMESTAMP or INTERVAL. +``vrp_vroomPlain`` - Vehicle Routing Problem with VROOM, involving both jobs and +shipments, with plain integer values instead of TIMESTAMP or INTERVAL. .. include:: experimental.rst :start-after: begin-warn-expr diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index 21723131f..4981b6a9c 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -18,7 +18,8 @@ vrp_vroomShipmentsPlain - Experimental =============================================================================== -``vrp_vroomShipmentsPlain`` - Vehicle Routing Problem with VROOM, involving only shipments, with plain integer values instead of TIMESTAMP or INTERVAL. +``vrp_vroomShipmentsPlain`` - Vehicle Routing Problem with VROOM, involving only +shipments, with plain integer values instead of TIMESTAMP or INTERVAL. .. include:: experimental.rst :start-after: begin-warn-expr From a4158ec8d0488a22dda4bc152e24877840e8168d Mon Sep 17 00:00:00 2001 From: cvvergara Date: Tue, 30 Jul 2024 09:49:26 -0600 Subject: [PATCH 02/24] (doc) jobs_input.c -> concepts.rst --- doc/conf.py.in | 3 + doc/general/concepts.rst | 88 ++++++++++++++++++++++++++- doc/general/vroom-category.rst | 19 +++--- doc/vroom/vrp_vroom.rst | 19 +++--- doc/vroom/vrp_vroomJobs.rst | 19 +++--- doc/vroom/vrp_vroomJobsPlain.rst | 20 +++--- doc/vroom/vrp_vroomPlain.rst | 20 +++--- doc/vroom/vrp_vroomShipments.rst | 13 ++-- doc/vroom/vrp_vroomShipmentsPlain.rst | 13 ++-- src/common/vroom/jobs_input.c | 53 ---------------- 10 files changed, 156 insertions(+), 111 deletions(-) diff --git a/doc/conf.py.in b/doc/conf.py.in index b110ca402..1aec7c66f 100644 --- a/doc/conf.py.in +++ b/doc/conf.py.in @@ -330,4 +330,7 @@ linkcheck_anchors = False rst_epilog=""" .. |ANY-INTEGER| replace:: :abbr:`ANY-INTEGER(SMALLINT, INTEGER, BIGINT)` .. |ANY-NUMERICAL| replace:: :abbr:`ANY-NUMERICAL(SMALLINT, INTEGER, BIGINT, REAL, FLOAT)` +.. |br| raw:: html + +

  • """ diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index ccf49a77e..0cda31add 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -218,7 +218,87 @@ TBD Inner Queries ------------------------------------------------------------------------------- -TBD +Vroom Inner Queries +............................................................................... + +Jobs SQL +******************************************************************************* + +.. jobs_start + +A ``SELECT`` statement that returns the following columns: + +| ``id, location_id`` +| ``[setup, service, delivery, pickup, skills, priority, data]`` + +Maximum values apply from vroom + +``setup`` and ``service`` + +- |intervalmax| + +``skills`` + +- :math:`2147483647` + +``priority`` + +- :math:`100` + +.. list-table:: + :width: 81 + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Default + - Description + - - ``id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the job. + - - ``location_id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the location of the job. + - - ``setup`` + - |interval| + - |interval0| + - The Job setup duration. + + - - ``service`` + - |interval| + - |interval0| + - The Job service duration. Max value: + - - ``pickup`` + - ``ARRAY[ANY-INTEGER]`` + - ``[]`` + - Array of non-negative integers describing multidimensional quantities for + pickup such as number of items, weight, volume etc. + + - All jobs must have the same value of :code:`array_length(pickup, 1)` + - - ``delivery`` + - ``ARRAY[ANY-INTEGER]`` + - ``[]`` + - Array of non-negative integers describing multidimensional quantities for + delivery such as number of items, weight, volume etc. + + - All jobs must have the same value of :code:`array_length(delivery, 1)` + - - ``skills`` + - ``ARRAY[ANY-INTEGER]`` + - ``[]`` + - Array of non-negative integers defining mandatory skills. + - - ``priority`` + - ``INTEGER`` + - :math:`0` + - Value range: :math:`[0, 100]` + - - ``data`` + - ``JSONB`` + - ``'{}'::JSONB`` + - Any metadata information of the job. + +.. jobs_end Return columns & values @@ -250,3 +330,9 @@ Consult the `developer's documentation 0), 0)` +.. |intervalmax| replace:: **INTERVAL**: ``make_interval(secs => 4294967295)`` and |br| |ANY-INTEGER|: :math:`4294967295` +.. |timestamp| replace:: :abbr:`ANY-TIMESTAMP(TIMESTAMP, SMALLINT, INTEGER, BIGINT)` +.. |tw_open_default| replace:: :abbr:`TW-OPEN-DEFAULT(to_timestamp(0), 0)` +.. |tw_close_default| replace:: :abbr:`TW-CLOSE-DEFAULT(to_timestamp(4294967295), 4294967295)` diff --git a/doc/general/vroom-category.rst b/doc/general/vroom-category.rst index a3ff44f80..847c948e0 100644 --- a/doc/general/vroom-category.rst +++ b/doc/general/vroom-category.rst @@ -115,21 +115,15 @@ Terminologies traveling nor servicing any task. It is generally the time spent by a vehicle waiting for a task service to open. -.. |timestamp| replace:: ``TIMESTAMP`` or ``INTEGER`` -.. |interval| replace:: ``INTERVAL`` or ``INTEGER`` -.. |interval0| replace:: '00:00:00'::INTERVAL or :math:`0` -.. |tw_open_default| replace:: '1970-01-01 00:00:00'::TIMESTAMP or :math:`0` -.. |tw_close_default| replace:: '2106-02-07 06:28:15'::TIMESTAMP or :math:`4294967295` - Inner Queries ------------------------------------------------------------------------------- Jobs SQL ............................................................................... -.. include:: ../../src/common/vroom/jobs_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: jobs_start + :end-before: jobs_end Shipments SQL ............................................................................... @@ -196,3 +190,10 @@ See Also * :ref:`genindex` * :ref:`search` + +.. |interval| replace:: :abbr:`ANY-INTERVAL(INTERVAL, SMALLINT, INTEGER, BIGINT)` +.. |interval0| replace:: :abbr:`INTERVAL 0('make_interval(secs => 0), 0)` +.. |intervalmax| replace:: **INTERVAL**: ``make_interval(secs => 4294967295)`` and |br| |ANY-INTEGER|: :math:`4294967295` +.. |timestamp| replace:: :abbr:`ANY-TIMESTAMP(TIMESTAMP, SMALLINT, INTEGER, BIGINT)` +.. |tw_open_default| replace:: :abbr:`TW-OPEN-DEFAULT(to_timestamp(0), 0)` +.. |tw_close_default| replace:: :abbr:`TW-CLOSE-DEFAULT(to_timestamp(4294967295), 4294967295)` diff --git a/doc/vroom/vrp_vroom.rst b/doc/vroom/vrp_vroom.rst index 472336916..cf0537e7a 100644 --- a/doc/vroom/vrp_vroom.rst +++ b/doc/vroom/vrp_vroom.rst @@ -70,12 +70,6 @@ The modification in the tables is mentioned at the end of the :doc:`sampledata`. :start-after: -- q1 :end-before: -- q2 -.. |timestamp| replace:: ``TIMESTAMP`` -.. |interval| replace:: ``INTERVAL`` -.. |interval0| replace:: '00:00:00'::INTERVAL -.. |tw_open_default| replace:: '1970-01-01 00:00:00'::TIMESTAMP -.. |tw_close_default| replace:: '2106-02-07 06:28:15'::TIMESTAMP - Parameters ------------------------------------------------------------------------------- @@ -96,9 +90,9 @@ Inner Queries Jobs SQL ............................................................................... -.. include:: ../../src/common/vroom/jobs_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: jobs_start + :end-before: jobs_end Shipments SQL ............................................................................... @@ -142,3 +136,10 @@ See Also * :ref:`genindex` * :ref:`search` + +.. |interval| replace:: ``INTERVAL`` +.. |interval0| replace:: ``make_interval(secs => 0)`` +.. |intervalmax| replace:: ``make_interval(secs => 4294967295)`` +.. |timestamp| replace:: ``TIMESTAMP`` +.. |tw_open_default| replace:: ``to_timestamp(0)`` +.. |tw_close_default| replace:: ``to_timestamp(4294967295)`` diff --git a/doc/vroom/vrp_vroomJobs.rst b/doc/vroom/vrp_vroomJobs.rst index 26b9a9ffe..34ebcd412 100644 --- a/doc/vroom/vrp_vroomJobs.rst +++ b/doc/vroom/vrp_vroomJobs.rst @@ -69,12 +69,6 @@ The modification in the tables is mentioned at the end of the :doc:`sampledata`. :start-after: -- q1 :end-before: -- q2 -.. |timestamp| replace:: ``TIMESTAMP`` -.. |interval| replace:: ``INTERVAL`` -.. |interval0| replace:: '00:00:00'::INTERVAL -.. |tw_open_default| replace:: '1970-01-01 00:00:00'::TIMESTAMP -.. |tw_close_default| replace:: '2106-02-07 06:28:15'::TIMESTAMP - Parameters ------------------------------------------------------------------------------- @@ -95,9 +89,9 @@ Inner Queries Jobs SQL ............................................................................... -.. include:: ../../src/common/vroom/jobs_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: jobs_start + :end-before: jobs_end .. include:: vroom-category.rst :start-after: inner_queries_start @@ -134,3 +128,10 @@ See Also * :ref:`genindex` * :ref:`search` + +.. |interval| replace:: ``INTERVAL`` +.. |interval0| replace:: ``make_interval(secs => 0)`` +.. |intervalmax| replace:: ``make_interval(secs => 4294967295)`` +.. |timestamp| replace:: ``TIMESTAMP`` +.. |tw_open_default| replace:: ``to_timestamp(0)`` +.. |tw_close_default| replace:: ``to_timestamp(4294967295)`` diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index a596467a9..13965e8f6 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -69,12 +69,6 @@ Optional parameters are `named parameters` and have a default value. :start-after: -- q1 :end-before: -- q2 -.. |timestamp| replace:: ``INTEGER`` -.. |interval| replace:: ``INTEGER`` -.. |interval0| replace:: :math:`0` -.. |tw_open_default| replace:: :math:`0` -.. |tw_close_default| replace:: :math:`4294967295` - Parameters ------------------------------------------------------------------------------- @@ -95,9 +89,9 @@ Inner Queries Jobs SQL ............................................................................... -.. include:: ../../src/common/vroom/jobs_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: jobs_start + :end-before: jobs_end .. include:: vroom-category.rst :start-after: inner_queries_start @@ -134,3 +128,11 @@ See Also * :ref:`genindex` * :ref:`search` + +.. |interval| replace:: |ANY-INTEGER| +.. |interval0| replace:: :math:`0` +.. |intervalmax| replace:: :math:`4294967295` +.. |timestamp| replace:: |ANY-INTEGER| +.. |tw_open_default| replace:: :math:`0` +.. |tw_close_default| replace:: :math:`4294967295` + diff --git a/doc/vroom/vrp_vroomPlain.rst b/doc/vroom/vrp_vroomPlain.rst index ae2c193ff..480d454d2 100644 --- a/doc/vroom/vrp_vroomPlain.rst +++ b/doc/vroom/vrp_vroomPlain.rst @@ -70,12 +70,6 @@ Optional parameters are `named parameters` and have a default value. :start-after: -- q1 :end-before: -- q2 -.. |timestamp| replace:: ``INTEGER`` -.. |interval| replace:: ``INTEGER`` -.. |interval0| replace:: :math:`0` -.. |tw_open_default| replace:: :math:`0` -.. |tw_close_default| replace:: :math:`4294967295` - Parameters ------------------------------------------------------------------------------- @@ -96,9 +90,10 @@ Inner Queries Jobs SQL ............................................................................... -.. include:: ../../src/common/vroom/jobs_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end + +.. include:: concepts.rst + :start-after: jobs_start + :end-before: jobs_end Shipments SQL ............................................................................... @@ -142,3 +137,10 @@ See Also * :ref:`genindex` * :ref:`search` + +.. |interval| replace:: |ANY-INTEGER| +.. |interval0| replace:: :math:`0` +.. |intervalmax| replace:: :math:`4294967295` +.. |timestamp| replace:: |ANY-INTEGER| +.. |tw_open_default| replace:: :math:`0` +.. |tw_close_default| replace:: :math:`4294967295` diff --git a/doc/vroom/vrp_vroomShipments.rst b/doc/vroom/vrp_vroomShipments.rst index 45bf7693a..ea05c8cc2 100644 --- a/doc/vroom/vrp_vroomShipments.rst +++ b/doc/vroom/vrp_vroomShipments.rst @@ -69,12 +69,6 @@ The modification in the tables is mentioned at the end of the :doc:`sampledata`. :start-after: -- q1 :end-before: -- q2 -.. |timestamp| replace:: ``TIMESTAMP`` -.. |interval| replace:: ``INTERVAL`` -.. |interval0| replace:: '00:00:00'::INTERVAL -.. |tw_open_default| replace:: '1970-01-01 00:00:00'::TIMESTAMP -.. |tw_close_default| replace:: '2106-02-07 06:28:15'::TIMESTAMP - Parameters ------------------------------------------------------------------------------- @@ -135,3 +129,10 @@ See Also * :ref:`genindex` * :ref:`search` + +.. |interval| replace:: ``INTERVAL`` +.. |interval0| replace:: ``make_interval(secs => 0)`` +.. |intervalmax| replace:: ``make_interval(secs => 4294967295)`` +.. |timestamp| replace:: ``TIMESTAMP`` +.. |tw_open_default| replace:: ``to_timestamp(0)`` +.. |tw_close_default| replace:: ``to_timestamp(4294967295)`` diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index 4981b6a9c..10e06f614 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -69,12 +69,6 @@ Optional parameters are `named parameters` and have a default value. :start-after: -- q1 :end-before: -- q2 -.. |timestamp| replace:: ``INTEGER`` -.. |interval| replace:: ``INTEGER`` -.. |interval0| replace:: :math:`0` -.. |tw_open_default| replace:: :math:`0` -.. |tw_close_default| replace:: :math:`4294967295` - Parameters ------------------------------------------------------------------------------- @@ -135,3 +129,10 @@ See Also * :ref:`genindex` * :ref:`search` + +.. |interval| replace:: |ANY-INTEGER| +.. |interval0| replace:: :math:`0` +.. |intervalmax| replace:: :math:`4294967295` +.. |timestamp| replace:: |ANY-INTEGER| +.. |tw_open_default| replace:: :math:`0` +.. |tw_close_default| replace:: :math:`4294967295` diff --git a/src/common/vroom/jobs_input.c b/src/common/vroom/jobs_input.c index 431676c57..0ff3b5186 100644 --- a/src/common/vroom/jobs_input.c +++ b/src/common/vroom/jobs_input.c @@ -28,59 +28,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. #include "c_common/vroom/jobs_input.h" -/* -.. vrp_vroom start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, location_id - [, setup, service, delivery, pickup, skills, priority, data] - - -==================== ========================= =========== ================================================ -Column Type Default Description -==================== ========================= =========== ================================================ -**id** ``ANY-INTEGER`` Positive unique identifier of the job. - -**location_id** ``ANY-INTEGER`` Positive identifier of the job location. - -**setup** |interval| |interval0| Job setup duration. - -**service** |interval| |interval0| Job service duration. - -**delivery** ``ARRAY[ANY-INTEGER]`` Empty Array Array of non-negative integers describing - multidimensional quantities for delivery such - as number of items, weight, volume etc. - - - All jobs must have the same value of - :code:`array_length(delivery, 1)` - -**pickup** ``ARRAY[ANY-INTEGER]`` Empty Array Array of non-negative integers describing - multidimensional quantities for pickup such as - number of items, weight, volume etc. - - - All jobs must have the same value of - :code:`array_length(pickup, 1)` - -**skills** ``ARRAY[INTEGER]`` Empty Array Array of non-negative integers defining - mandatory skills. - -**priority** ``INTEGER`` 0 Priority level of the job - - - Ranges from ``[0, 100]`` - -**data** ``JSONB`` '{}'::JSONB Any metadata information of the job. -==================== ========================= =========== ================================================ - -Where: - -:ANY-INTEGER: SMALLINT, INTEGER, BIGINT - -.. vrp_vroom end -*/ - static void fetch_jobs( HeapTuple *tuple, From 0d0e6faad7ba19a382348cc1f6c6ecf6c6f0c9dd Mon Sep 17 00:00:00 2001 From: cvvergara Date: Tue, 30 Jul 2024 10:09:06 -0600 Subject: [PATCH 03/24] (doc) shipments_input.c -> concepts.rst --- doc/general/concepts.rst | 93 +++++++++++++++++++++++++++ doc/general/vroom-category.rst | 6 +- doc/vroom/vrp_vroom.rst | 6 +- doc/vroom/vrp_vroomPlain.rst | 7 +- doc/vroom/vrp_vroomShipments.rst | 6 +- doc/vroom/vrp_vroomShipmentsPlain.rst | 6 +- src/common/vroom/shipments_input.c | 54 ---------------- 7 files changed, 108 insertions(+), 70 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index 0cda31add..40c61d7f1 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -300,6 +300,99 @@ Maximum values apply from vroom .. jobs_end +Shipments SQL +******************************************************************************* + +.. shipments_start + +A ``SELECT`` statement that returns the following columns: + +| ``id`` +| ``p_location_id, [p_setup, p_service, p_data]`` +| ``d_location_id, [d_setup, d_service, d_data]`` +| ``[amount, skills, priority]`` + +Maximum values apply from vroom + +``p_setup``, ``p_service``, ``d_setup``, ``d_service`` + +- |intervalmax| + +``skills`` + +- :math:`2147483647` + +``priority`` + +- :math:`100` + + +.. list-table:: + :width: 81 + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Default + - Description + - - ``id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the shipment. + - - ``p_location_id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the pickup location. + - - ``p_setup`` + - |interval| + - |interval0| + - The pickup setup duration + - - ``p_service`` + - |interval| + - |interval0| + - The pickup service duration + - - ``p_data`` + - ``JSONB`` + - ``'{}'::JSONB`` + - Any metadata information of the pickup. + - - ``d_location_id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the pickup location. + - - ``d_setup`` + - |interval| + - |interval0| + - The pickup setup duration + - - ``d_service`` + - |interval| + - |interval0| + - The pickup service duration + - - ``d_data`` + - ``JSONB`` + - ``'{}'::JSONB`` + - Any metadata information of the delivery. + - - ``amount`` + - ``ARRAY[ANY-INTEGER]`` + - ``[]`` + - Array of non-negative integers describing multidimensional quantities + such as number of items, weight, volume etc. + + - All shipments must have the same value of :code:`array_length(amount, + 1)` + + - - ``skills`` + - ``ARRAY[ANY-INTEGER]`` + - ``[]`` + - Array of non-negative integers defining mandatory skills. + + - :math:`values \leq 2147483647` + - - ``priority`` + - ``INTEGER`` + - :math:`0` + - Value range: :math:`[0, 100]` + +.. shipments_end Return columns & values -------------------------------------------------------------------------------- diff --git a/doc/general/vroom-category.rst b/doc/general/vroom-category.rst index 847c948e0..16bf7c425 100644 --- a/doc/general/vroom-category.rst +++ b/doc/general/vroom-category.rst @@ -128,9 +128,9 @@ Jobs SQL Shipments SQL ............................................................................... -.. include:: ../../src/common/vroom/shipments_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: shipments_start + :end-before: shipments_end .. inner_queries_start diff --git a/doc/vroom/vrp_vroom.rst b/doc/vroom/vrp_vroom.rst index cf0537e7a..76903d38f 100644 --- a/doc/vroom/vrp_vroom.rst +++ b/doc/vroom/vrp_vroom.rst @@ -97,9 +97,9 @@ Jobs SQL Shipments SQL ............................................................................... -.. include:: ../../src/common/vroom/shipments_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: shipments_start + :end-before: shipments_end .. include:: vroom-category.rst :start-after: inner_queries_start diff --git a/doc/vroom/vrp_vroomPlain.rst b/doc/vroom/vrp_vroomPlain.rst index 480d454d2..d437fc9d4 100644 --- a/doc/vroom/vrp_vroomPlain.rst +++ b/doc/vroom/vrp_vroomPlain.rst @@ -90,7 +90,6 @@ Inner Queries Jobs SQL ............................................................................... - .. include:: concepts.rst :start-after: jobs_start :end-before: jobs_end @@ -98,9 +97,9 @@ Jobs SQL Shipments SQL ............................................................................... -.. include:: ../../src/common/vroom/shipments_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: shipments_start + :end-before: shipments_end .. include:: vroom-category.rst :start-after: inner_queries_start diff --git a/doc/vroom/vrp_vroomShipments.rst b/doc/vroom/vrp_vroomShipments.rst index ea05c8cc2..2f5dea6e3 100644 --- a/doc/vroom/vrp_vroomShipments.rst +++ b/doc/vroom/vrp_vroomShipments.rst @@ -89,9 +89,9 @@ Inner Queries Shipments SQL ............................................................................... -.. include:: ../../src/common/vroom/shipments_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: shipments_start + :end-before: shipments_end .. include:: vroom-category.rst :start-after: inner_queries_start diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index 10e06f614..73d34cd41 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -89,9 +89,9 @@ Inner Queries Shipments SQL ............................................................................... -.. include:: ../../src/common/vroom/shipments_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: shipments_start + :end-before: shipments_end .. include:: vroom-category.rst :start-after: inner_queries_start diff --git a/src/common/vroom/shipments_input.c b/src/common/vroom/shipments_input.c index 700e66e2c..9d3df4a88 100644 --- a/src/common/vroom/shipments_input.c +++ b/src/common/vroom/shipments_input.c @@ -28,60 +28,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. #include "c_common/vroom/shipments_input.h" -/* -.. vrp_vroom start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, p_location_id [, p_setup, p_service], d_location_id [, d_setup, d_service] - [, amount, skills, priority, p_data, d_data] - - -====================== ========================= =========== ================================================ -Column Type Default Description -====================== ========================= =========== ================================================ -**id** ``ANY-INTEGER`` Positive unique identifier of the shipment. - -**p_location_id** ``ANY-INTEGER`` Positive identifier of the pickup location. - -**p_setup** |interval| |interval0| Pickup setup duration. - -**p_service** |interval| |interval0| Pickup service duration. - -**d_location_id** ``ANY-INTEGER`` Positive identifier of the delivery location. - -**d_setup** |interval| |interval0| Delivery setup duration. - -**d_service** |interval| |interval0| Delivery service duration. - -**amount** ``ARRAY[ANY-INTEGER]`` Empty Array Array of non-negative integers describing - multidimensional quantities such as number - of items, weight, volume etc. - - - All shipments must have the same value of - :code:`array_length(amount, 1)` - -**skills** ``ARRAY[INTEGER]`` Empty Array Array of non-negative integers defining - mandatory skills. - -**priority** ``INTEGER`` 0 Priority level of the shipment. - - - Ranges from ``[0, 100]`` - -**p_data** ``JSONB`` '{}'::JSONB Any metadata information of the pickup shipment. - -**d_data** ``JSONB`` '{}'::JSONB Any metadata information of the delivery shipment. -====================== ========================= =========== ================================================ - -Where: - -:ANY-INTEGER: SMALLINT, INTEGER, BIGINT - -.. vrp_vroom end -*/ - static void fetch_shipments( HeapTuple *tuple, From 8ca797cd51471de939b20f27a1556397bd6448bf Mon Sep 17 00:00:00 2001 From: cvvergara Date: Tue, 30 Jul 2024 09:17:01 -0600 Subject: [PATCH 04/24] (doc) breaks_input.c -> concepts.rst --- doc/general/concepts.rst | 57 ++++++++++++++++++++++++++++++--- doc/general/vroom-category.rst | 6 ++-- src/common/vroom/breaks_input.c | 25 --------------- 3 files changed, 56 insertions(+), 32 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index 40c61d7f1..b7c72d6d2 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -80,10 +80,6 @@ Time Windows .. note To be defined - - -.. _Getting_started: - Getting Started ------------------------------------------------------------------------------- @@ -221,6 +217,21 @@ Inner Queries Vroom Inner Queries ............................................................................... +Vroom, because of the data types used internally, some maximum values apply. + +For ``TIMESTAMP``: + +.. literalinclude:: concepts.queries + :start-after: q1 + :end-before: q2 + +For ``INTERVAL``: + +.. literalinclude:: concepts.queries + :start-after: q2 + :end-before: q3 + + Jobs SQL ******************************************************************************* @@ -394,6 +405,44 @@ Maximum values apply from vroom .. shipments_end +Breaks SQL +******************************************************************************* + +.. breaks_start + +A ``SELECT`` statement that returns the following columns: + +| ``id, vehicle_id`` +| ``[service, data]`` + +.. list-table:: + :width: 81 + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Default + - Description + - - ``id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the break. Unique for the same vehicle. + - - ``vehicle_id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the vehicle. + - - ``service`` + - |interval| + - |interval0| + - The break duration + - - ``data`` + - ``JSONB`` + - ``'{}'::JSONB`` + - Any metadata information of the break. + +.. breaks_end + Return columns & values -------------------------------------------------------------------------------- diff --git a/doc/general/vroom-category.rst b/doc/general/vroom-category.rst index 16bf7c425..31c1fed98 100644 --- a/doc/general/vroom-category.rst +++ b/doc/general/vroom-category.rst @@ -144,9 +144,9 @@ Vehicles SQL Breaks SQL ............................................................................... -.. include:: ../../src/common/vroom/breaks_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: breaks_start + :end-before: breaks_end Time Windows SQL ............................................................................... diff --git a/src/common/vroom/breaks_input.c b/src/common/vroom/breaks_input.c index bc53cbf1b..e4042d87e 100644 --- a/src/common/vroom/breaks_input.c +++ b/src/common/vroom/breaks_input.c @@ -28,31 +28,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. #include "c_common/vroom/breaks_input.h" -/* -.. vrp_vroom start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, vehicle_id [, service, data] - -==================== ========================= =========== ================================================ -Column Type Default Description -==================== ========================= =========== ================================================ -**id** ``ANY-INTEGER`` Positive unique identifier of the break. - (unique for the same vehicle). - -**vehicle_id** ``ANY-INTEGER`` Positive unique identifier of the vehicle. - -**service** |interval| |interval0| The break duration. - -**data** ``JSONB`` '{}'::JSONB Any metadata information of the break. -==================== ========================= =========== ================================================ - -.. vrp_vroom end -*/ - static void fetch_breaks( HeapTuple *tuple, From e6304962021aa37a97aad31e10741a8055a7ddd1 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 02:32:08 -0600 Subject: [PATCH 05/24] (doc) breaks_input.c -> concepts.rst --- doc/vroom/vrp_vroom.rst | 9 ++++++--- doc/vroom/vrp_vroomJobs.rst | 9 ++++++--- doc/vroom/vrp_vroomJobsPlain.rst | 9 ++++++--- doc/vroom/vrp_vroomPlain.rst | 9 ++++++--- doc/vroom/vrp_vroomShipments.rst | 9 ++++++--- doc/vroom/vrp_vroomShipmentsPlain.rst | 9 ++++++--- 6 files changed, 36 insertions(+), 18 deletions(-) diff --git a/doc/vroom/vrp_vroom.rst b/doc/vroom/vrp_vroom.rst index 76903d38f..24ff4657a 100644 --- a/doc/vroom/vrp_vroom.rst +++ b/doc/vroom/vrp_vroom.rst @@ -101,9 +101,12 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end -.. include:: vroom-category.rst - :start-after: inner_queries_start - :end-before: inner_queries_end +Breaks SQL +............................................................................... + +.. include:: concepts.rst + :start-after: breaks_start + :end-before: breaks_end Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomJobs.rst b/doc/vroom/vrp_vroomJobs.rst index 34ebcd412..ca41bcd36 100644 --- a/doc/vroom/vrp_vroomJobs.rst +++ b/doc/vroom/vrp_vroomJobs.rst @@ -93,9 +93,12 @@ Jobs SQL :start-after: jobs_start :end-before: jobs_end -.. include:: vroom-category.rst - :start-after: inner_queries_start - :end-before: inner_queries_end +Breaks SQL +............................................................................... + +.. include:: concepts.rst + :start-after: breaks_start + :end-before: breaks_end Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index 13965e8f6..6353cdc93 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -93,9 +93,12 @@ Jobs SQL :start-after: jobs_start :end-before: jobs_end -.. include:: vroom-category.rst - :start-after: inner_queries_start - :end-before: inner_queries_end +Breaks SQL +............................................................................... + +.. include:: concepts.rst + :start-after: breaks_start + :end-before: breaks_end Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomPlain.rst b/doc/vroom/vrp_vroomPlain.rst index d437fc9d4..18dfd242a 100644 --- a/doc/vroom/vrp_vroomPlain.rst +++ b/doc/vroom/vrp_vroomPlain.rst @@ -101,9 +101,12 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end -.. include:: vroom-category.rst - :start-after: inner_queries_start - :end-before: inner_queries_end +Breaks SQL +............................................................................... + +.. include:: concepts.rst + :start-after: breaks_start + :end-before: breaks_end Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomShipments.rst b/doc/vroom/vrp_vroomShipments.rst index 2f5dea6e3..404ae2372 100644 --- a/doc/vroom/vrp_vroomShipments.rst +++ b/doc/vroom/vrp_vroomShipments.rst @@ -93,9 +93,12 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end -.. include:: vroom-category.rst - :start-after: inner_queries_start - :end-before: inner_queries_end +Breaks SQL +............................................................................... + +.. include:: concepts.rst + :start-after: breaks_start + :end-before: breaks_end Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index 73d34cd41..32bb9037a 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -93,9 +93,12 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end -.. include:: vroom-category.rst - :start-after: inner_queries_start - :end-before: inner_queries_end +Breaks SQL +............................................................................... + +.. include:: concepts.rst + :start-after: breaks_start + :end-before: breaks_end Result Columns ------------------------------------------------------------------------------- From 5758ceeea2fd4c35ca0e333aeb212883c64138d6 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Tue, 30 Jul 2024 10:52:25 -0600 Subject: [PATCH 06/24] (doc) vehicles_input.c -> concepts.rst --- doc/general/concepts.rst | 103 +++++++++++++++++++++++++- doc/general/vroom-category.rst | 6 +- doc/vroom/vrp_vroom.rst | 7 ++ doc/vroom/vrp_vroomJobs.rst | 7 ++ doc/vroom/vrp_vroomJobsPlain.rst | 7 ++ doc/vroom/vrp_vroomPlain.rst | 7 ++ doc/vroom/vrp_vroomShipments.rst | 7 ++ doc/vroom/vrp_vroomShipmentsPlain.rst | 7 ++ src/common/vroom/vehicles_input.c | 59 --------------- 9 files changed, 147 insertions(+), 63 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index b7c72d6d2..bcf737d8d 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -337,7 +337,6 @@ Maximum values apply from vroom - :math:`100` - .. list-table:: :width: 81 :widths: auto @@ -405,6 +404,108 @@ Maximum values apply from vroom .. shipments_end +Vehicles SQL +******************************************************************************* + +.. vroom_vehicles_start + +A ``SELECT`` statement that returns the following columns: + +| ``id, start_id, end_id`` +| ``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]`` + +Maximum values apply from vroom + +``skills`` + +- :math:`2147483647` + +``priority`` + +- :math:`100` + +.. list-table:: + :width: 81 + :widths: 14,20,10,37 + :header-rows: 1 + + - - Column + - Type + - Default + - Description + - - ``id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the vehicle. + - - ``start_id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the start location. + - - ``end_id`` + - |ANY-INTEGER| + - + - Positive unique identifier of the end location. + - - ``capacity`` + - ``ARRAY[ANY-INTEGER]`` + - ``[]`` + - Array of non-negative integers describing multidimensional quantities + such as number of items, weight, volume etc. + + - All vehicles must have the same value of :code:`array_length(capacity, + 1)` + - - ``skills`` + - ``ARRAY[ANY-INTEGER]`` + - ``[]`` + - Array of non-negative integers defining mandatory skills. + - - ``tw_open`` + - |timestamp| + - |tw_open_default| + - Time window opening time. + + - :code:`tw_open \leq tw_close` + - - ``tw_close`` + - |timestamp| + - |tw_close_default| + - Time window closing time. + + - :code:`tw_open \leq tw_close` + - - ``speed_factor`` + - |ANY-NUMERICAL| + - :math:`1.0` + - Vehicle travel time multiplier. + + - Max value of speed factor for a vehicle shall not be greater than 5 + times the speed factor of any other vehicle. + - - ``max_tasks`` + - ``INTEGER`` + - :math:`2147483647` + - Maximum number of tasks in a route for the vehicle. + + - A job, pickup, or delivery is counted as a single task. + - - ``data`` + - ``JSONB`` + - ``'{}'::JSONB`` + - Any metadata information of the vehicle. + +**Note**: + +- At least one of the ``start_id`` or ``end_id`` shall be present. +- If ``end_id`` is omitted, the resulting route will stop at the last visited + task, whose choice is determined by the optimization process. +- If ``start_id`` is omitted, the resulting route will start at the first + visited task, whose choice is determined by the optimization process. +- To request a round trip, specify both ``start_id`` and ``end_id`` as the same + index. +- A vehicle is only allowed to serve a set of tasks if the resulting load at + each route step is lower than the matching value in capacity for each metric. + When using multiple components for amounts, it is recommended to put the most + important/limiting metrics first. +- It is assumed that all delivery-related amounts for jobs are loaded at vehicle + start, while all pickup-related amounts for jobs are brought back at vehicle + end. + +.. vroom_vehicles_end + Breaks SQL ******************************************************************************* diff --git a/doc/general/vroom-category.rst b/doc/general/vroom-category.rst index 31c1fed98..a121596ff 100644 --- a/doc/general/vroom-category.rst +++ b/doc/general/vroom-category.rst @@ -137,9 +137,9 @@ Shipments SQL Vehicles SQL ............................................................................... -.. include:: ../../src/common/vroom/vehicles_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: vroom_vehicles_start + :end-before: vroom_vehicles_end Breaks SQL ............................................................................... diff --git a/doc/vroom/vrp_vroom.rst b/doc/vroom/vrp_vroom.rst index 24ff4657a..07b646201 100644 --- a/doc/vroom/vrp_vroom.rst +++ b/doc/vroom/vrp_vroom.rst @@ -101,6 +101,13 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end +Vehicles SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_vehicles_start + :end-before: vroom_vehicles_end + Breaks SQL ............................................................................... diff --git a/doc/vroom/vrp_vroomJobs.rst b/doc/vroom/vrp_vroomJobs.rst index ca41bcd36..c9c406d29 100644 --- a/doc/vroom/vrp_vroomJobs.rst +++ b/doc/vroom/vrp_vroomJobs.rst @@ -93,6 +93,13 @@ Jobs SQL :start-after: jobs_start :end-before: jobs_end +Vehicles SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_vehicles_start + :end-before: vroom_vehicles_end + Breaks SQL ............................................................................... diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index 6353cdc93..df3ac5d38 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -93,6 +93,13 @@ Jobs SQL :start-after: jobs_start :end-before: jobs_end +Vehicles SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_vehicles_start + :end-before: vroom_vehicles_end + Breaks SQL ............................................................................... diff --git a/doc/vroom/vrp_vroomPlain.rst b/doc/vroom/vrp_vroomPlain.rst index 18dfd242a..f11997cf8 100644 --- a/doc/vroom/vrp_vroomPlain.rst +++ b/doc/vroom/vrp_vroomPlain.rst @@ -101,6 +101,13 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end +Vehicles SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_vehicles_start + :end-before: vroom_vehicles_end + Breaks SQL ............................................................................... diff --git a/doc/vroom/vrp_vroomShipments.rst b/doc/vroom/vrp_vroomShipments.rst index 404ae2372..6d9888a85 100644 --- a/doc/vroom/vrp_vroomShipments.rst +++ b/doc/vroom/vrp_vroomShipments.rst @@ -93,6 +93,13 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end +Vehicles SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_vehicles_start + :end-before: vroom_vehicles_end + Breaks SQL ............................................................................... diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index 32bb9037a..baee24d1b 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -93,6 +93,13 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end +Vehicles SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_vehicles_start + :end-before: vroom_vehicles_end + Breaks SQL ............................................................................... diff --git a/src/common/vroom/vehicles_input.c b/src/common/vroom/vehicles_input.c index dd6affbf1..05b80d500 100644 --- a/src/common/vroom/vehicles_input.c +++ b/src/common/vroom/vehicles_input.c @@ -28,65 +28,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. #include "c_common/vroom/vehicles_input.h" -/* -.. vrp_vroom start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, start_id, end_id - [, capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data] - - -====================== ======================== =================== ================================================ -Column Type Default Description -====================== ======================== =================== ================================================ -**id** ``ANY-INTEGER`` Positive unique identifier of the vehicle. - -**start_id** ``ANY-INTEGER`` Positive identifier of the vehicle start location. - -**end_id** ``ANY-INTEGER`` Positive identifier of the vehicle end location. - -**capacity** ``ARRAY[ANY-INTEGER]`` Empty Array Array of non-negative integers describing - multidimensional quantities such as - number of items, weight, volume etc. - - - All vehicles must have the same value of - :code:`array_length(capacity, 1)` - -**skills** ``ARRAY[INTEGER]`` Empty Array Array of non-negative integers defining - mandatory skills. - -**tw_open** |timestamp| |tw_open_default| Time window opening time. - -**tw_close** |timestamp| |tw_close_default| Time window closing time. - -**speed_factor** ``ANY-NUMERICAL`` :math:`1.0` Vehicle travel time multiplier. - - - Max value of speed factor for a vehicle shall not be - greater than 5 times the speed factor of any other vehicle. - -**max_tasks** ``INTEGER`` :math:`2147483647` Maximum number of tasks in a route for the vehicle. - - - A job, pickup, or delivery is counted as a single task. - -**data** ``JSONB`` '{}'::JSONB Any metadata information of the vehicle. -====================== ======================== =================== ================================================ - -**Note**: - -- At least one of the ``start_id`` or ``end_id`` shall be present. -- If ``end_id`` is omitted, the resulting route will stop at the last visited task, whose choice is determined by the optimization process. -- If ``start_id`` is omitted, the resulting route will start at the first visited task, whose choice is determined by the optimization process. -- To request a round trip, specify both ``start_id`` and ``end_id`` as the same index. -- A vehicle is only allowed to serve a set of tasks if the resulting load at each route step is lower than the matching value in capacity for each metric. When using multiple components for amounts, it is recommended to put the most important/limiting metrics first. -- It is assumed that all delivery-related amounts for jobs are loaded at vehicle start, while all pickup-related amounts for jobs are brought back at vehicle end. -- :code:`tw_open ≤ tw_close` - -.. vrp_vroom end -*/ - static void fetch_vehicles( HeapTuple *tuple, From 67c6b3d961fdbf7cf2aa0a0104c81e763bbc5257 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sat, 3 Aug 2024 14:33:25 -0600 Subject: [PATCH 07/24] (doc) time_windows_input.c -> concepts.rst --- doc/general/concepts.rst | 3 --- doc/general/vroom-category.rst | 6 ++--- doc/vroom/vrp_vroom.rst | 21 +++++++++++++++ doc/vroom/vrp_vroomJobs.rst | 14 ++++++++++ doc/vroom/vrp_vroomJobsPlain.rst | 14 ++++++++++ doc/vroom/vrp_vroomPlain.rst | 21 +++++++++++++++ doc/vroom/vrp_vroomShipments.rst | 14 ++++++++++ doc/vroom/vrp_vroomShipmentsPlain.rst | 14 ++++++++++ src/common/vroom/time_windows_input.c | 39 --------------------------- 9 files changed, 101 insertions(+), 45 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index bcf737d8d..b260ed982 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -89,9 +89,6 @@ with vrpRouting. In this guide we will cover: .. contents:: :local: - -.. _create_database: - Create a routing Database ............................................................................... diff --git a/doc/general/vroom-category.rst b/doc/general/vroom-category.rst index a121596ff..3cc19c85b 100644 --- a/doc/general/vroom-category.rst +++ b/doc/general/vroom-category.rst @@ -151,9 +151,9 @@ Breaks SQL Time Windows SQL ............................................................................... -.. include:: ../../src/common/vroom/time_windows_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: time_windows_start + :end-before: time_windows_end Time Matrix SQL ............................................................................... diff --git a/doc/vroom/vrp_vroom.rst b/doc/vroom/vrp_vroom.rst index 07b646201..3fdb167fd 100644 --- a/doc/vroom/vrp_vroom.rst +++ b/doc/vroom/vrp_vroom.rst @@ -94,6 +94,13 @@ Jobs SQL :start-after: jobs_start :end-before: jobs_end +Jobs Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Shipments SQL ............................................................................... @@ -101,6 +108,13 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end +Shipments Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: shipments_time_windows_start + :end-before: shipments_time_windows_end + Vehicles SQL ............................................................................... @@ -115,6 +129,13 @@ Breaks SQL :start-after: breaks_start :end-before: breaks_end +Breaks Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomJobs.rst b/doc/vroom/vrp_vroomJobs.rst index c9c406d29..b2580fa74 100644 --- a/doc/vroom/vrp_vroomJobs.rst +++ b/doc/vroom/vrp_vroomJobs.rst @@ -93,6 +93,13 @@ Jobs SQL :start-after: jobs_start :end-before: jobs_end +Jobs Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Vehicles SQL ............................................................................... @@ -107,6 +114,13 @@ Breaks SQL :start-after: breaks_start :end-before: breaks_end +Breaks Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index df3ac5d38..c47f9988c 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -93,6 +93,13 @@ Jobs SQL :start-after: jobs_start :end-before: jobs_end +Jobs Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Vehicles SQL ............................................................................... @@ -107,6 +114,13 @@ Breaks SQL :start-after: breaks_start :end-before: breaks_end +Breaks Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomPlain.rst b/doc/vroom/vrp_vroomPlain.rst index f11997cf8..eadea5a65 100644 --- a/doc/vroom/vrp_vroomPlain.rst +++ b/doc/vroom/vrp_vroomPlain.rst @@ -94,6 +94,13 @@ Jobs SQL :start-after: jobs_start :end-before: jobs_end +Jobs Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Shipments SQL ............................................................................... @@ -101,6 +108,13 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end +Shipments Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: shipments_time_windows_start + :end-before: shipments_time_windows_end + Vehicles SQL ............................................................................... @@ -115,6 +129,13 @@ Breaks SQL :start-after: breaks_start :end-before: breaks_end +Breaks Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomShipments.rst b/doc/vroom/vrp_vroomShipments.rst index 6d9888a85..071e78d7f 100644 --- a/doc/vroom/vrp_vroomShipments.rst +++ b/doc/vroom/vrp_vroomShipments.rst @@ -93,6 +93,13 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end +Shipments Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: shipments_time_windows_start + :end-before: shipments_time_windows_end + Vehicles SQL ............................................................................... @@ -107,6 +114,13 @@ Breaks SQL :start-after: breaks_start :end-before: breaks_end +Breaks Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index baee24d1b..3bb2dfd5e 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -93,6 +93,13 @@ Shipments SQL :start-after: shipments_start :end-before: shipments_end +Shipments Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: shipments_time_windows_start + :end-before: shipments_time_windows_end + Vehicles SQL ............................................................................... @@ -107,6 +114,13 @@ Breaks SQL :start-after: breaks_start :end-before: breaks_end +Breaks Time Windows SQL +............................................................................... + +.. include:: concepts.rst + :start-after: general_time_windows_start + :end-before: general_time_windows_end + Result Columns ------------------------------------------------------------------------------- diff --git a/src/common/vroom/time_windows_input.c b/src/common/vroom/time_windows_input.c index eba90acfa..b753b42c0 100644 --- a/src/common/vroom/time_windows_input.c +++ b/src/common/vroom/time_windows_input.c @@ -28,45 +28,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. #include "c_common/vroom/time_windows_input.h" -/* -.. vrp_vroom start - -A ``SELECT`` statement that returns the following columns: - -:: - - id [, kind], tw_open, tw_close - -==================== ====================================== ===================================================== -Column Type Description -==================== ====================================== ===================================================== -**id** ``ANY-INTEGER`` Positive unique identifier of the job, - pickup/delivery shipment, or break. - -**kind** ``CHAR`` **Only required for shipments time windows**. - Value in ['p', 'd'] indicating whether - the time window is for: - - - Pickup shipment, or - - Delivery shipment. - -**tw_open** |timestamp| Time window opening time. - -**tw_close** |timestamp| Time window closing time. -==================== ====================================== ===================================================== - -**Note**: - -- All timings are in **seconds** when represented as an ``INTEGER``. -- Every row must satisfy the condition: :code:`tw_open ≤ tw_close`. -- It is up to users to decide how to describe time windows: - - - **Relative values**, e.g. [0, 14400] for a 4 hours time window starting at the beginning of the planning horizon. In that case all times reported in output with the arrival column are relative to the start of the planning horizon. - - **Absolute values**, "real" timestamps. In that case all times reported in output with the arrival column can be interpreted as timestamps. - -.. vrp_vroom end -*/ - static void fetch_time_windows( HeapTuple *tuple, From 99833506d4878103265fa08705b7a94a880616b8 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Tue, 30 Jul 2024 11:14:48 -0600 Subject: [PATCH 08/24] (doc) matrix_input.c -> concepts.rst --- doc/general/concepts.rst | 138 ++++++++++++++++++++++++++ doc/general/vroom-category.rst | 6 +- doc/vroom/vrp_vroom.rst | 7 ++ doc/vroom/vrp_vroomJobs.rst | 7 ++ doc/vroom/vrp_vroomJobsPlain.rst | 7 ++ doc/vroom/vrp_vroomPlain.rst | 6 ++ doc/vroom/vrp_vroomShipments.rst | 7 ++ doc/vroom/vrp_vroomShipmentsPlain.rst | 7 ++ src/common/vroom/matrix_input.c | 25 ----- 9 files changed, 182 insertions(+), 28 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index b260ed982..3cc6579d9 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -503,6 +503,44 @@ Maximum values apply from vroom .. vroom_vehicles_end +Vroom Matrix SQL +******************************************************************************* + +.. vroom_matrix_start + +A ``SELECT`` statement that returns the following columns: + +| ``start_id, end_id, duration`` +| ``[ cost]`` + +.. list-table:: + :width: 81 + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Default + - Description + - - ``start_id`` + - |ANY-INTEGER| + - + - Identifier of the start node. + - - ``end_id`` + - |ANY-INTEGER| + - + - Identifier of the end node. + - - ``duration`` + - |interval| + - + - Time to travel from ``start_id`` to ``end_id`` + - - ``cost`` + - |interval| + - ``duration`` + - Cost of travel from ``start_id`` to ``end_id`` + +.. vroom_matrix_end + Breaks SQL ******************************************************************************* @@ -541,6 +579,106 @@ A ``SELECT`` statement that returns the following columns: .. breaks_end + +Time Windows SQL +******************************************************************************* + +.. rubric:: Shipment Time Windows SQL + +.. shipments_time_windows_start + +A ``SELECT`` statement that returns the following columns: + +| ``id, tw_open, tw_close`` +| ``[kind]`` + +.. list-table:: + :width: 81 + :widths: 14 14 44 + :header-rows: 1 + + - - Column + - Type + - Description + - - ``id`` + - |ANY-INTEGER| + - Positive unique identifier of the: job, pickup/delivery shipment, or + break. + - - ``tw_open`` + - |timestamp| + - Time window opening time. + - - ``tw_close`` + - |timestamp| + - Time window closing time. + - - ``kind`` + - ``CHAR`` + - Value in ['p', 'd'] indicating whether the time window is for: + + - Pickup shipment, or + - Delivery shipment. + +.. shipments_time_windows_end + +.. rubric:: General Time Windows SQL + +.. general_time_windows_start + +A ``SELECT`` statement that returns the following columns: + +``id, tw_open, tw_close`` + +.. list-table:: + :width: 81 + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Description + - - ``id`` + - |ANY-INTEGER| + - Positive unique identifier of the: job, pickup/delivery shipment, or + break. + - - ``tw_open`` + - |timestamp| + - Time window opening time. + - - ``tw_close`` + - |timestamp| + - Time window closing time. + +.. general_time_windows_end + +.. time_windows_note_start + +**Note**: + +- All timings are in **seconds** when represented as an ``INTEGER``. +- Every row must satisfy the condition: :code:`tw_open ≤ tw_close`. +- Time windows can be interpreted by the users: + + - **Relative values**, e.g. + + - Let the beginning of the planning horizon :math:`0`. + - for a 4 hour time window (:math:`4 * 3600 = 14400` seconds) starting from + the planning horizon + + - ``tw_open`` = :math:`0` + - ``tw_close`` = :math:`14400` + + - Times reported in output relative to the start of the planning horizon. + + - **Absolute values**, + + - Let the beginning of the planning horizon ``2019-07-30 08:00:00`` + - for a 4 hour time window starting from the planning horizon + + - ``tw_open`` = ``2019-07-30 08:00:00`` + - ``tw_close`` = ``2019-07-30 12:00:00`` + + - Times reported in output can be interpreted as ``TIMESTAMP``. + +.. time_windows_end + Return columns & values -------------------------------------------------------------------------------- diff --git a/doc/general/vroom-category.rst b/doc/general/vroom-category.rst index 3cc19c85b..77c33c249 100644 --- a/doc/general/vroom-category.rst +++ b/doc/general/vroom-category.rst @@ -158,9 +158,9 @@ Time Windows SQL Time Matrix SQL ............................................................................... -.. include:: ../../src/common/vroom/matrix_input.c - :start-after: vrp_vroom start - :end-before: vrp_vroom end +.. include:: concepts.rst + :start-after: vroom_matrix_start + :end-before: vroom_matrix_end .. inner_queries_end diff --git a/doc/vroom/vrp_vroom.rst b/doc/vroom/vrp_vroom.rst index 3fdb167fd..0ff461413 100644 --- a/doc/vroom/vrp_vroom.rst +++ b/doc/vroom/vrp_vroom.rst @@ -136,6 +136,13 @@ Breaks Time Windows SQL :start-after: general_time_windows_start :end-before: general_time_windows_end +Time Matrix SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_matrix_start + :end-before: vroom_matrix_end + Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomJobs.rst b/doc/vroom/vrp_vroomJobs.rst index b2580fa74..57092e254 100644 --- a/doc/vroom/vrp_vroomJobs.rst +++ b/doc/vroom/vrp_vroomJobs.rst @@ -121,6 +121,13 @@ Breaks Time Windows SQL :start-after: general_time_windows_start :end-before: general_time_windows_end +Time Matrix SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_matrix_start + :end-before: vroom_matrix_end + Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index c47f9988c..379545fc2 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -121,6 +121,13 @@ Breaks Time Windows SQL :start-after: general_time_windows_start :end-before: general_time_windows_end +Time Matrix SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_matrix_start + :end-before: vroom_matrix_end + Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomPlain.rst b/doc/vroom/vrp_vroomPlain.rst index eadea5a65..9ea85172e 100644 --- a/doc/vroom/vrp_vroomPlain.rst +++ b/doc/vroom/vrp_vroomPlain.rst @@ -136,6 +136,12 @@ Breaks Time Windows SQL :start-after: general_time_windows_start :end-before: general_time_windows_end +Time Matrix SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_matrix_start + :end-before: vroom_matrix_end Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomShipments.rst b/doc/vroom/vrp_vroomShipments.rst index 071e78d7f..9087e494d 100644 --- a/doc/vroom/vrp_vroomShipments.rst +++ b/doc/vroom/vrp_vroomShipments.rst @@ -121,6 +121,13 @@ Breaks Time Windows SQL :start-after: general_time_windows_start :end-before: general_time_windows_end +Time Matrix SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_matrix_start + :end-before: vroom_matrix_end + Result Columns ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index 3bb2dfd5e..65296b63b 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -121,6 +121,13 @@ Breaks Time Windows SQL :start-after: general_time_windows_start :end-before: general_time_windows_end +Time Matrix SQL +............................................................................... + +.. include:: concepts.rst + :start-after: vroom_matrix_start + :end-before: vroom_matrix_end + Result Columns ------------------------------------------------------------------------------- diff --git a/src/common/vroom/matrix_input.c b/src/common/vroom/matrix_input.c index b190c3e39..fafbead30 100644 --- a/src/common/vroom/matrix_input.c +++ b/src/common/vroom/matrix_input.c @@ -28,31 +28,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. #include "c_common/vroom/matrix_input.h" -/* -.. vrp_vroom start - -A ``SELECT`` statement that returns the following columns: - -:: - - start_id, end_id, duration [, cost] - -=============== ================= ============== ================================================== -Column Type Default Description -=============== ================= ============== ================================================== -**start_id** ``ANY-INTEGER`` Identifier of the start node. - -**end_id** ``ANY-INTEGER`` Identifier of the end node. - -**duration** |interval| Time to travel from ``start_id`` to ``end_id`` - -**cost** ``INTEGER`` *duration* Cost to travel from ``start_id`` to ``end_id`` -=============== ================= ============== ================================================== - -.. vrp_vroom end -*/ - -static void fetch_matrix( HeapTuple *tuple, TupleDesc *tupdesc, From 058a73b32f3909ad32ea9bc046abe296d6b7f712 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 03:11:14 -0600 Subject: [PATCH 09/24] (docq) Adding query for timestamp and interval values --- configuration.conf | 1 + doc/CMakeLists.txt | 2 -- docqueries/general/CMakeLists.txt | 11 +++++++++++ docqueries/general/concepts.pg | 8 ++++++++ docqueries/general/concepts.result | 24 ++++++++++++++++++++++++ docqueries/general/test.conf | 16 ++++++++++++++++ 6 files changed, 60 insertions(+), 2 deletions(-) create mode 100644 docqueries/general/CMakeLists.txt create mode 100644 docqueries/general/concepts.pg create mode 100644 docqueries/general/concepts.result create mode 100644 docqueries/general/test.conf diff --git a/configuration.conf b/configuration.conf index 4ee413dba..ba1e3bcad 100644 --- a/configuration.conf +++ b/configuration.conf @@ -29,3 +29,4 @@ optimizers | Y | N | N initialsol | Y | N | N vroom | Y | Y | Y or_tools | N | Y | Y +general | N | N | Y diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 5e05383f8..0083df686 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -187,8 +187,6 @@ set(PGR_DOCUMENTATION_SOURCE_DIR "${CMAKE_CURRENT_BINARY_DIR}") message(STATUS "PGR_DOCUMENTATION_BUILD_DIR = ${PGR_DOCUMENTATION_BUILD_DIR}") -add_subdirectory(general) - #--------------------------------------------- # Adding documentation directories #--------------------------------------------- diff --git a/docqueries/general/CMakeLists.txt b/docqueries/general/CMakeLists.txt new file mode 100644 index 000000000..08a2ef786 --- /dev/null +++ b/docqueries/general/CMakeLists.txt @@ -0,0 +1,11 @@ +# Do not use extensions +SET(LOCAL_FILES + concepts + ) + +foreach (f ${LOCAL_FILES}) + configure_file("${f}.result" "${PGR_DOCUMENTATION_SOURCE_DIR}/${f}.queries") + list(APPEND LOCAL_DOC_FILES "${PGR_DOCUMENTATION_SOURCE_DIR}/${f}.queries") +endforeach() + +set(PROJECT_DOC_FILES ${PROJECT_DOC_FILES} ${LOCAL_DOC_FILES} PARENT_SCOPE) diff --git a/docqueries/general/concepts.pg b/docqueries/general/concepts.pg new file mode 100644 index 000000000..e766b8d23 --- /dev/null +++ b/docqueries/general/concepts.pg @@ -0,0 +1,8 @@ +/* q1 */ +SELECT to_timestamp(0)::timestamp without time zone as ZERO_TIMESTAMP, +to_timestamp(4294967295)::timestamp without time zone AS MAX_TIMESTAMP; +/* q2 */ +SELECT make_interval(secs => 0) AS ZERO_INTERVAL, +make_interval(years => 136, months => 1, days => 6, hours=>6, mins => 28, secs => 15) AS MAX_INTERVAL1, +make_interval(secs => 4294967295) AS MAX_INTERVAL2; +/* q3 */ diff --git a/docqueries/general/concepts.result b/docqueries/general/concepts.result new file mode 100644 index 000000000..66a8824cc --- /dev/null +++ b/docqueries/general/concepts.result @@ -0,0 +1,24 @@ +BEGIN; +BEGIN +SET client_min_messages TO NOTICE; +SET +/* q1 */ +SELECT to_timestamp(0)::timestamp without time zone as ZERO_TIMESTAMP, +to_timestamp(4294967295)::timestamp without time zone AS MAX_TIMESTAMP; + zero_timestamp | max_timestamp +---------------------+--------------------- + 1969-12-31 18:00:00 | 2106-02-07 00:28:15 +(1 row) + +/* q2 */ +SELECT make_interval(secs => 0) AS ZERO_INTERVAL, +make_interval(years => 136, months => 1, days => 6, hours=>6, mins => 28, secs => 15) AS MAX_INTERVAL1, +make_interval(secs => 4294967295) AS MAX_INTERVAL2; + zero_interval | max_interval1 | max_interval2 +---------------+---------------------------------+--------------- + 00:00:00 | 136 years 1 mon 6 days 06:28:15 | 1193046:28:15 +(1 row) + +/* q3 */ +ROLLBACK; +ROLLBACK diff --git a/docqueries/general/test.conf b/docqueries/general/test.conf new file mode 100644 index 000000000..1910c8d78 --- /dev/null +++ b/docqueries/general/test.conf @@ -0,0 +1,16 @@ +#!/usr/bin/perl -w + +%main::tests = ( + 'any' => { + 'comment' => 'VRP with VROOM tests.', + 'tests' => [qw( + concepts + )], + 'documentation' => [qw( + concepts + )] + }, + +); + +1; From 5399277b40c6a03e2cc265731f69d5bd2269f308 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 03:40:32 -0600 Subject: [PATCH 10/24] (doc) vrp_vroom.sql -> *.rst --- doc/general/concepts.rst | 109 +++++++++++++++++- doc/general/vroom-category.rst | 10 +- doc/vroom/vrp_vroom.rst | 97 ++++++++++++---- doc/vroom/vrp_vroomJobs.rst | 12 +- doc/vroom/vrp_vroomJobsPlain.rst | 6 +- doc/vroom/vrp_vroomPlain.rst | 12 +- doc/vroom/vrp_vroomShipments.rst | 12 +- doc/vroom/vrp_vroomShipmentsPlain.rst | 6 +- sql/vroom/vrp_vroom.sql | 157 -------------------------- 9 files changed, 211 insertions(+), 210 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index 3cc6579d9..59374cd74 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -677,12 +677,117 @@ A ``SELECT`` statement that returns the following columns: - Times reported in output can be interpreted as ``TIMESTAMP``. -.. time_windows_end +.. time_windows_note_end + Return columns & values -------------------------------------------------------------------------------- -TBD +VROOM result columns +............................................................................... + +.. vroom_result_start + +Returns set of + +.. code-block:: none + + (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, + task_data, arrival, travel_time, service_time, waiting_time, load) + +.. list-table:: + :width: 81 + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Description + - - ``seq`` + - ``BIGINT`` + - Sequential value starting from **1**. + - - ``vehicle_seq`` + - ``BIGINT`` + - Sequential value starting from **1** for current vehicles. The + :math:`n^{th}` vehicle in the solution. + - - ``vehicle_id`` + - ``BIGINT`` + - Current vehicle identifier. + + - ``-1``: Vehicle denoting all the unallocated tasks. + - ``0``: Summary row for the complete problem + - - ``vehicle_data`` + - ``JSONB`` + - Metadata information of the vehicle. + - - ``step_seq`` + - ``BIGINT`` + - Sequential value starting from **1** for the stops made by the current + vehicle. The :math:`m^{th}` stop of the current vehicle. + + - ``0``: Summary row + - - ``step_type`` + - ``BIGINT`` + - Kind of the step location the vehicle is at: + + - ``0``: Summary row + - ``1``: Starting location + - ``2``: Job location + - ``3``: Pickup location + - ``4``: Delivery location + - ``5``: Break location + - ``6``: Ending location + + - - ``task_id`` + - ``BIGINT`` + - Identifier of the task performed at this step. + + - ``0``: Summary row + - ``-1``: If the step is starting/ending location. + - - ``location_id`` + - ``BIGINT`` + - Identifier of the task location. + + - ``0``: Summary row + - - ``task_data`` + - ``JSONB`` + - Metadata information of the task. + - - ``arrival`` + - |timestamp| + - Estimated time of arrival at this step. + - - ``travel_time`` + - |interval| + - Travel time from previous ``step_seq`` to current ``step_seq``. + + - ``0``: When ``step_type = 1`` + - - ``setup_time`` + - |interval| + - Setup time at this step. + - - ``service_time`` + - |interval| + - Service time at this step. + - - ``waiting_time`` + - |interval| + - Waiting time at this step. + - - ``departure`` + - |timestamp| + - Estimated time of departure at this step. + + - :math:`arrival + service\_time + waiting\_time`. + - - ``load`` + - ``BIGINT`` + - Vehicle load after step completion (with capacity constraints) + +**Note**: + +- Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`. +- The last step of every vehicle denotes the summary row, where the columns + ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time + for the corresponding vehicle, +- The last row denotes the summary for the complete problem, where the columns + ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time + for the complete problem, + +.. vroom_result_end Performance diff --git a/doc/general/vroom-category.rst b/doc/general/vroom-category.rst index 77c33c249..4f87b59cd 100644 --- a/doc/general/vroom-category.rst +++ b/doc/general/vroom-category.rst @@ -167,13 +167,9 @@ Time Matrix SQL Result Columns ------------------------------------------------------------------------------- -.. result_columns_start - -.. include:: ../sql/vroom/vrp_vroom.sql - :start-after: result start - :end-before: result end - -.. result_columns_end +.. include:: concepts.rst + :start-after: vroom_result_start + :end-before: vroom_result_end See Also ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroom.rst b/doc/vroom/vrp_vroom.rst index 0ff461413..282dbaa75 100644 --- a/doc/vroom/vrp_vroom.rst +++ b/doc/vroom/vrp_vroom.rst @@ -49,19 +49,20 @@ shipments. Signature ------------------------------------------------------------------------------- -.. rubric:: Summary +.. admonition:: \ \ + :class: signatures -.. include:: ../sql/vroom/vrp_vroom.sql - :start-after: signature start - :end-before: signature end + | vrp_vroom( + | `Jobs SQL`_, `Jobs Time Windows SQL`_, + | `Shipments SQL`_, `Shipments Time Windows SQL`_, + | `Vehicles SQL`_, + | `Breaks SQL`_, `Breaks Time Windows SQL`_, + | `Time Matrix SQL`_ + | [, exploration_level] [, timeout]) -- Experimental on v0.2 + | RETURNS SET OF + | (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, + | task_data, arrival, travel_time, service_time, waiting_time, departure, load) -Optional parameters are `named parameters` and have a default value. - -.. rubric:: Using defaults - -.. include:: ../sql/vroom/vrp_vroom.sql - :start-after: default signature start - :end-before: default signature end **Example**: This example is based on the modified VROOM Data of the :doc:`sampledata` network. The modification in the tables is mentioned at the end of the :doc:`sampledata`. @@ -73,16 +74,72 @@ The modification in the tables is mentioned at the end of the :doc:`sampledata`. Parameters ------------------------------------------------------------------------------- -.. include:: ../sql/vroom/vrp_vroom.sql - :start-after: parameters start - :end-before: parameters end +.. vroom_parameters_start + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Parameter + - Type + - Description + - - `Jobs SQL`_ + - ``TEXT`` + - Query describing the single-location pickup and/or delivery + - - `Jobs Time Windows SQL`_ + - ``TEXT`` + - Query describing valid slots for job service start. + - - `Shipments SQL`_ + - ``TEXT`` + - Query describing pickup and delivery tasks that should happen within same route. + - - `Shipments Time Windows SQL`_ + - ``TEXT`` + - Query describing valid slots for pickup and delivery service start. + - - `Vehicles SQL`_ + - ``TEXT`` + - Query describing the available vehicles. + - - `Breaks SQL`_ + - ``TEXT`` + - Query describing the driver breaks. + - - `Breaks Time Windows SQL`_ + - ``TEXT`` + - Query describing valid slots for break start. + - - `Time Matrix SQL`_ + - ``TEXT`` + - Query containing the distance or travel times between the locations. + +.. vroom_parameters_end Optional Parameters ............................................................................... -.. include:: ../sql/vroom/vrp_vroom.sql - :start-after: optional parameters start - :end-before: optional parameters end +.. vroom_optionals_start + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Parameter + - Type + - Default + - Description + - - ``exploration_level`` + - ``INTEGER`` + - :math:`5` + - Exploration level to use while solving. + + - Ranges from ``[0, 5]`` + - A smaller exploration level gives faster result. + - - ``timeout`` + - ``INTERVAL`` + - '-00:00:01'::INTERVAL + - Timeout value to stop the solving process. + + - Gives the best possible solution within a time limit. Note that some + additional seconds may be required to return back the data. + - Any negative timeout value is ignored. + +.. vroom_optionals_end Inner Queries ------------------------------------------------------------------------------- @@ -146,9 +203,9 @@ Time Matrix SQL Result Columns ------------------------------------------------------------------------------- -.. include:: vroom-category.rst - :start-after: result_columns_start - :end-before: result_columns_end +.. include:: concepts.rst + :start-after: vroom_result_start + :end-before: vroom_result_end Additional Example ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomJobs.rst b/doc/vroom/vrp_vroomJobs.rst index 57092e254..1731b2160 100644 --- a/doc/vroom/vrp_vroomJobs.rst +++ b/doc/vroom/vrp_vroomJobs.rst @@ -79,9 +79,9 @@ Parameters Optional Parameters ............................................................................... -.. include:: ../sql/vroom/vrp_vroom.sql - :start-after: optional parameters start - :end-before: optional parameters end +.. include:: vrp_vroom.rst + :start-after: vroom_optionals_start + :end-before: vroom_optionals_end Inner Queries ------------------------------------------------------------------------------- @@ -131,9 +131,9 @@ Time Matrix SQL Result Columns ------------------------------------------------------------------------------- -.. include:: vroom-category.rst - :start-after: result_columns_start - :end-before: result_columns_end +.. include:: concepts.rst + :start-after: vroom_result_start + :end-before: vroom_result_end Additional Example ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index 379545fc2..958e6248b 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -131,9 +131,9 @@ Time Matrix SQL Result Columns ------------------------------------------------------------------------------- -.. include:: vroom-category.rst - :start-after: result_columns_start - :end-before: result_columns_end +.. include:: concepts.rst + :start-after: vroom_result_start + :end-before: vroom_result_end Additional Example ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomPlain.rst b/doc/vroom/vrp_vroomPlain.rst index 9ea85172e..1f529a2ad 100644 --- a/doc/vroom/vrp_vroomPlain.rst +++ b/doc/vroom/vrp_vroomPlain.rst @@ -73,9 +73,9 @@ Optional parameters are `named parameters` and have a default value. Parameters ------------------------------------------------------------------------------- -.. include:: ../sql/vroom/vrp_vroom.sql - :start-after: parameters start - :end-before: parameters end +.. include:: vrp_vroom.rst + :start-after: vroom_parameters_start + :end-before: vroom_parameters_end Optional Parameters ............................................................................... @@ -145,9 +145,9 @@ Time Matrix SQL Result Columns ------------------------------------------------------------------------------- -.. include:: vroom-category.rst - :start-after: result_columns_start - :end-before: result_columns_end +.. include:: concepts.rst + :start-after: vroom_result_start + :end-before: vroom_result_end Additional Example ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomShipments.rst b/doc/vroom/vrp_vroomShipments.rst index 9087e494d..3e7e2abf5 100644 --- a/doc/vroom/vrp_vroomShipments.rst +++ b/doc/vroom/vrp_vroomShipments.rst @@ -79,9 +79,9 @@ Parameters Optional Parameters ............................................................................... -.. include:: ../sql/vroom/vrp_vroom.sql - :start-after: optional parameters start - :end-before: optional parameters end +.. include:: vrp_vroom.rst + :start-after: vroom_optionals_start + :end-before: vroom_optionals_end Inner Queries ------------------------------------------------------------------------------- @@ -131,9 +131,9 @@ Time Matrix SQL Result Columns ------------------------------------------------------------------------------- -.. include:: vroom-category.rst - :start-after: result_columns_start - :end-before: result_columns_end +.. include:: concepts.rst + :start-after: vroom_result_start + :end-before: vroom_result_end Additional Example ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index 65296b63b..7dfd0da81 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -131,9 +131,9 @@ Time Matrix SQL Result Columns ------------------------------------------------------------------------------- -.. include:: vroom-category.rst - :start-after: result_columns_start - :end-before: result_columns_end +.. include:: concepts.rst + :start-after: vroom_result_start + :end-before: vroom_result_end Additional Example ------------------------------------------------------------------------------- diff --git a/sql/vroom/vrp_vroom.sql b/sql/vroom/vrp_vroom.sql index e8ad4eec0..b6d292e89 100644 --- a/sql/vroom/vrp_vroom.sql +++ b/sql/vroom/vrp_vroom.sql @@ -26,163 +26,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ********************************************************************PGR-GNU*/ -/* -signature start - -.. code-block:: none - - vrp_vroom( - Jobs SQL, Jobs Time Windows SQL, - Shipments SQL, Shipments Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL [, exploration_level] [, timeout]) -- Experimental on v0.2 - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -signature end - -default signature start - -.. code-block:: none - - vrp_vroom( - Jobs SQL, Jobs Time Windows SQL, - Shipments SQL, Shipments Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL) - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -default signature end - -parameters start - -============================== =========== ========================================================= -Parameter Type Description -============================== =========== ========================================================= -**Jobs SQL** ``TEXT`` `Jobs SQL`_ query describing the single-location - pickup and/or delivery tasks. -**Jobs Time Windows SQL** ``TEXT`` `Time Windows SQL`_ query describing valid slots - for job service start. -**Shipments SQL** ``TEXT`` `Shipments SQL`_ query describing pickup and delivery - tasks that should happen within same route. -**Shipments Time Windows SQL** ``TEXT`` `Time Windows SQL`_ query describing valid slots - for pickup and delivery service start. -**Vehicles SQL** ``TEXT`` `Vehicles SQL`_ query describing the available vehicles. -**Breaks SQL** ``TEXT`` `Breaks SQL`_ query describing the driver breaks. -**Breaks Time Windows SQL** ``TEXT`` `Time Windows SQL`_ query describing valid slots for - break start. -**Matrix SQL** ``TEXT`` `Time Matrix SQL`_ query containing the distance or - travel times between the locations. -============================== =========== ========================================================= - -parameters end - -optional parameters start - -===================== ============ ============================= ================================================= -Parameter Type Default Description -===================== ============ ============================= ================================================= -**exploration_level** ``INTEGER`` :math:`5` Exploration level to use while solving. - - - Ranges from ``[0, 5]`` - - A smaller exploration level gives faster result. - -**timeout** ``INTERVAL`` '-00:00:01'::INTERVAL Timeout value to stop the solving process. - - - Gives the best possible solution within a time - limit. Note that some additional seconds may be - required to return back the data. - - Any negative timeout value is ignored. -===================== ============ ============================= ================================================= - -optional parameters end - -result start - -Returns set of - -.. code-block:: none - - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, load) - -=================== ================= ================================================= -Column Type Description -=================== ================= ================================================= -**seq** ``BIGINT`` Sequential value starting from **1**. - -**vehicle_seq** ``BIGINT`` Sequential value starting from **1** for current vehicles. - The :math:`n^{th}` vehicle in the solution. - - - ``0``: Summary row for the complete problem - -**vehicle_id** ``BIGINT`` Current vehicle identifier. - - - ``-1``: Vehicle denoting all the unallocated tasks. - - ``0``: Summary row for the complete problem - -**vehicle_data** ``JSONB`` Metadata information of the vehicle - -**step_seq** ``BIGINT`` Sequential value starting from **1** for the stops - made by the current vehicle. The :math:`m^{th}` stop - of the current vehicle. - - - ``0``: Summary row - -**step_type** ``INTEGER`` Kind of the step location the vehicle is at: - - - ``0``: Summary row - - ``1``: Starting location - - ``2``: Job location - - ``3``: Pickup location - - ``4``: Delivery location - - ``5``: Break location - - ``6``: Ending location - -**task_id** ``BIGINT`` Identifier of the task performed at this step. - - - ``0``: Summary row - - ``-1``: If the step is starting/ending location. - -**location_id** ``BIGINT`` Identifier of the task location. - - - ``0``: Summary row - -**task_data** ``JSONB`` Metadata information of the task - -**arrival** |timestamp| Estimated time of arrival at this step. - -**travel_time** |interval| Travel time from previous ``step_seq`` to current ``step_seq``. - - - ``0``: When ``step_type = 1`` - -**setup_time** |interval| Setup time at this step. - -**service_time** |interval| Service time at this step. - -**waiting_time** |interval| Waiting time upon arrival at this step. - -**departure** |timestamp| Estimated time of arrival at this step. - - - :math:`arrival + service\_time + waiting\_time`. - -**load** ``BIGINT`` Vehicle load after step completion (with capacity constraints) -=================== ================= ================================================= - -**Note**: - -- Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`. -- The last step of every vehicle denotes the summary row, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the corresponding vehicle, -- The last row denotes the summary for the complete problem, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the complete problem, - -result end -*/ - -- v0.2 CREATE FUNCTION vrp_vroom( TEXT, -- jobs_sql (required) From 023cf7db27926a09de551ac8df4a58f1aa5df58b Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 03:47:22 -0600 Subject: [PATCH 11/24] (doc) vrp_vroomPlain.sql -> *.rst --- doc/vroom/vrp_vroomJobsPlain.rst | 6 +-- doc/vroom/vrp_vroomPlain.rst | 53 +++++++++++++++++++------- doc/vroom/vrp_vroomShipmentsPlain.rst | 6 +-- sql/vroom/vrp_vroomPlain.sql | 54 --------------------------- 4 files changed, 45 insertions(+), 74 deletions(-) diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index 958e6248b..617f4e5e9 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -79,9 +79,9 @@ Parameters Optional Parameters ............................................................................... -.. include:: ../sql/vroom/vrp_vroomPlain.sql - :start-after: optional parameters start - :end-before: optional parameters end +.. include:: vrp_vroomPlain.rst + :start-after: vroom_plain_optionals_start + :end-before: vroom_plain_optionals_end Inner Queries ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomPlain.rst b/doc/vroom/vrp_vroomPlain.rst index 1f529a2ad..b5478d627 100644 --- a/doc/vroom/vrp_vroomPlain.rst +++ b/doc/vroom/vrp_vroomPlain.rst @@ -50,19 +50,20 @@ shipments. Signature ------------------------------------------------------------------------------- -.. rubric:: Summary +.. admonition:: \ \ + :class: signatures -.. include:: ../sql/vroom/vrp_vroomPlain.sql - :start-after: signature start - :end-before: signature end + | vrp_vroom( + | `Jobs SQL`_, `Jobs Time Windows SQL`_, + | `Shipments SQL`_, `Shipments Time Windows SQL`_, + | `Vehicles SQL`_, + | `Breaks SQL`_, `Breaks Time Windows SQL`_, + | `Time Matrix SQL`_ + | [, exploration_level] [, timeout]) -- Experimental on v0.2 + | RETURNS SET OF + | (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, + | task_data, arrival, travel_time, service_time, waiting_time, departure, load) -Optional parameters are `named parameters` and have a default value. - -.. rubric:: Using defaults - -.. include:: ../sql/vroom/vrp_vroomPlain.sql - :start-after: default signature start - :end-before: default signature end **Example**: This example is based on the VROOM Data of the :doc:`sampledata` network: @@ -80,9 +81,33 @@ Parameters Optional Parameters ............................................................................... -.. include:: ../sql/vroom/vrp_vroomPlain.sql - :start-after: optional parameters start - :end-before: optional parameters end +.. vroom_plain_optionals_start + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Parameter + - Type + - Default + - Description + - - ``exploration_level`` + - ``INTEGER`` + - :math:`5` + - Exploration level to use while solving. + + - Ranges from ``[0, 5]`` + - A smaller exploration level gives faster result. + - - ``timeout`` + - ``INTEGER`` + - :math:`-1` + - Timeout value to stop the solving process. + + - Gives the best possible solution within a time limit. Note that some + additional seconds may be required to return back the data. + - Any negative timeout value is ignored. + +.. vroom_plain_optionals_end Inner Queries ------------------------------------------------------------------------------- diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index 7dfd0da81..fe57c5950 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -79,9 +79,9 @@ Parameters Optional Parameters ............................................................................... -.. include:: ../sql/vroom/vrp_vroomPlain.sql - :start-after: optional parameters start - :end-before: optional parameters end +.. include:: vrp_vroomPlain.rst + :start-after: vroom_plain_optionals_start + :end-before: vroom_plain_optionals_end Inner Queries ------------------------------------------------------------------------------- diff --git a/sql/vroom/vrp_vroomPlain.sql b/sql/vroom/vrp_vroomPlain.sql index 9baf23712..b13a1e3b6 100644 --- a/sql/vroom/vrp_vroomPlain.sql +++ b/sql/vroom/vrp_vroomPlain.sql @@ -26,60 +26,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ********************************************************************PGR-GNU*/ -/* -signature start - -.. code-block:: none - - vrp_vroomPlain( - Jobs SQL, Jobs Time Windows SQL, - Shipments SQL, Shipments Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL [, exploration_level] [, timeout]) -- Experimental on v0.2 - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -signature end - -default signature start - -.. code-block:: none - - vrp_vroomPlain( - Jobs SQL, Jobs Time Windows SQL, - Shipments SQL, Shipments Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL) - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -default signature end - -optional parameters start - -===================== ============ ============================= ================================================= -Parameter Type Default Description -===================== ============ ============================= ================================================= -**exploration_level** ``INTEGER`` :math:`5` Exploration level to use while solving. - - - Ranges from ``[0, 5]`` - - A smaller exploration level gives faster result. - -**timeout** ``INTEGER`` :math:`-1` Timeout value to stop the solving process. - - - Gives the best possible solution within a time - limit. Note that some additional seconds may be - required to return back the data. - - Any negative timeout value is ignored. -===================== ============ ============================= ================================================= - -optional parameters end -*/ - -- v0.2 CREATE FUNCTION vrp_vroomPlain( TEXT, -- jobs_sql (required) From 7b77d6605b990c3151bd9342aef7bc011cd05385 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 03:51:22 -0600 Subject: [PATCH 12/24] (doc) vrp_vroomJobs.sql -> *.rst --- doc/vroom/vrp_vroomJobs.rst | 57 +++++++++++++++++++++++--------- doc/vroom/vrp_vroomJobsPlain.rst | 6 ++-- sql/vroom/vrp_vroomJobs.sql | 52 ----------------------------- 3 files changed, 44 insertions(+), 71 deletions(-) diff --git a/doc/vroom/vrp_vroomJobs.rst b/doc/vroom/vrp_vroomJobs.rst index 1731b2160..8dcb54cae 100644 --- a/doc/vroom/vrp_vroomJobs.rst +++ b/doc/vroom/vrp_vroomJobs.rst @@ -48,19 +48,18 @@ This function can be used to get the solution to a problem involving only jobs. Signature ------------------------------------------------------------------------------- -.. rubric:: Summary - -.. include:: ../sql/vroom/vrp_vroomJobs.sql - :start-after: signature start - :end-before: signature end - -Optional parameters are `named parameters` and have a default value. - -.. rubric:: Using defaults - -.. include:: ../sql/vroom/vrp_vroomJobs.sql - :start-after: default signature start - :end-before: default signature end +.. admonition:: \ \ + :class: signatures + + | vrp_vroom( + | `Jobs SQL`_, `Jobs Time Windows SQL`_, + | `Vehicles SQL`_, + | `Breaks SQL`_, `Breaks Time Windows SQL`_, + | `Time Matrix SQL`_ + | [, exploration_level] [, timeout]) -- Experimental on v0.2 + | RETURNS SET OF + | (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, + | task_data, arrival, travel_time, service_time, waiting_time, departure, load) **Example**: This example is based on the modified VROOM Data of the :doc:`sampledata` network. The modification in the tables is mentioned at the end of the :doc:`sampledata`. @@ -72,9 +71,35 @@ The modification in the tables is mentioned at the end of the :doc:`sampledata`. Parameters ------------------------------------------------------------------------------- -.. include:: ../sql/vroom/vrp_vroomJobs.sql - :start-after: parameters start - :end-before: parameters end +.. vjobs_parameter_start + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Parameter + - Type + - Description + - - `Jobs SQL`_ + - ``TEXT`` + - Query describing the single-location pickup and/or delivery + - - `Jobs Time Windows SQL`_ + - ``TEXT`` + - Query describing valid slots for job service start. + - - `Vehicles SQL`_ + - ``TEXT`` + - Query describing the available vehicles. + - - `Breaks SQL`_ + - ``TEXT`` + - Query describing the driver breaks. + - - `Breaks Time Windows SQL`_ + - ``TEXT`` + - Query describing valid slots for break start. + - - `Time Matrix SQL`_ + - ``TEXT`` + - Query containing the distance or travel times between the locations. + +.. vjobs_parameter_end Optional Parameters ............................................................................... diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index 617f4e5e9..beefd0896 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -72,9 +72,9 @@ Optional parameters are `named parameters` and have a default value. Parameters ------------------------------------------------------------------------------- -.. include:: ../sql/vroom/vrp_vroomJobs.sql - :start-after: parameters start - :end-before: parameters end +.. include:: vrp_vroomJobs.rst + :start-after: vjobs_parameter_start + :end-before: vjobs_parameter_end Optional Parameters ............................................................................... diff --git a/sql/vroom/vrp_vroomJobs.sql b/sql/vroom/vrp_vroomJobs.sql index 573a36f90..0bafc3dc0 100644 --- a/sql/vroom/vrp_vroomJobs.sql +++ b/sql/vroom/vrp_vroomJobs.sql @@ -26,58 +26,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ********************************************************************PGR-GNU*/ -/* -signature start - -.. code-block:: none - - vrp_vroomJobs( - Jobs SQL, Jobs Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL [, exploration_level] [, timeout]) -- Experimental on v0.2 - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -signature end - -default signature start - -.. code-block:: none - - vrp_vroomJobs( - Jobs SQL, Jobs Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL) - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -default signature end - -parameters start - -============================== =========== ========================================================= -Parameter Type Description -============================== =========== ========================================================= -**Jobs SQL** ``TEXT`` `Jobs SQL`_ query describing the single-location - pickup and/or delivery tasks. -**Jobs Time Windows SQL** ``TEXT`` `Time Windows SQL`_ query describing valid slots - for job service start. -**Vehicles SQL** ``TEXT`` `Vehicles SQL`_ query describing the available vehicles. -**Breaks SQL** ``TEXT`` `Breaks SQL`_ query describing the driver breaks. -**Breaks Time Windows SQL** ``TEXT`` `Time Windows SQL`_ query describing valid slots for - break start. -**Matrix SQL** ``TEXT`` `Time Matrix SQL`_ query containing the distance or - travel times between the locations. -============================== =========== ========================================================= - -parameters end - -*/ - -- v0.2 CREATE FUNCTION vrp_vroomJobs( TEXT, -- jobs_sql (required) From 117a53e78c7118d4610535ad686336ff52bbcf38 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 03:52:55 -0600 Subject: [PATCH 13/24] (doc) vrp_vroomJobsPlain.sql -> *.rst --- doc/vroom/vrp_vroomJobsPlain.rst | 25 ++++++++++++------------- sql/vroom/vrp_vroomJobsPlain.sql | 32 -------------------------------- 2 files changed, 12 insertions(+), 45 deletions(-) diff --git a/doc/vroom/vrp_vroomJobsPlain.rst b/doc/vroom/vrp_vroomJobsPlain.rst index beefd0896..2a6f454c5 100644 --- a/doc/vroom/vrp_vroomJobsPlain.rst +++ b/doc/vroom/vrp_vroomJobsPlain.rst @@ -49,19 +49,18 @@ This function can be used to get the solution to a problem involving only jobs. Signature ------------------------------------------------------------------------------- -.. rubric:: Summary - -.. include:: ../sql/vroom/vrp_vroomJobsPlain.sql - :start-after: signature start - :end-before: signature end - -Optional parameters are `named parameters` and have a default value. - -.. rubric:: Using defaults - -.. include:: ../sql/vroom/vrp_vroomJobsPlain.sql - :start-after: default signature start - :end-before: default signature end +.. admonition:: \ \ + :class: signatures + + | vrp_vroom( + | `Jobs SQL`_, `Jobs Time Windows SQL`_, + | `Vehicles SQL`_, + | `Breaks SQL`_, `Breaks Time Windows SQL`_, + | `Time Matrix SQL`_ + | [, exploration_level] [, timeout]) -- Experimental on v0.2 + | RETURNS SET OF + | (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, + | task_data, arrival, travel_time, service_time, waiting_time, departure, load) **Example**: This example is based on the VROOM Data of the :doc:`sampledata` network: diff --git a/sql/vroom/vrp_vroomJobsPlain.sql b/sql/vroom/vrp_vroomJobsPlain.sql index 4d29e476e..84961ce1e 100644 --- a/sql/vroom/vrp_vroomJobsPlain.sql +++ b/sql/vroom/vrp_vroomJobsPlain.sql @@ -26,38 +26,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ********************************************************************PGR-GNU*/ -/* -signature start - -.. code-block:: none - - vrp_vroomJobsPlain( - Jobs SQL, Jobs Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL [, exploration_level] [, timeout]) -- Experimental on v0.2 - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -signature end - -default signature start - -.. code-block:: none - - vrp_vroomJobsPlain( - Jobs SQL, Jobs Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL) - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -default signature end -*/ - -- v0.2 CREATE FUNCTION vrp_vroomJobsPlain( TEXT, -- jobs_sql (required) From e4845acfe490d6e6ca77b486f88271a497fb6365 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 03:56:12 -0600 Subject: [PATCH 14/24] (doc) vrp_vroomShipments.sql -> *.rst --- doc/vroom/vrp_vroomShipments.rst | 57 +++++++++++++++++++-------- doc/vroom/vrp_vroomShipmentsPlain.rst | 6 +-- sql/vroom/vrp_vroomShipments.sql | 52 ------------------------ 3 files changed, 44 insertions(+), 71 deletions(-) diff --git a/doc/vroom/vrp_vroomShipments.rst b/doc/vroom/vrp_vroomShipments.rst index 3e7e2abf5..68a2d1224 100644 --- a/doc/vroom/vrp_vroomShipments.rst +++ b/doc/vroom/vrp_vroomShipments.rst @@ -48,19 +48,18 @@ This function can be used to get the solution to a problem involving only shipme Signature ------------------------------------------------------------------------------- -.. rubric:: Summary - -.. include:: ../sql/vroom/vrp_vroomShipments.sql - :start-after: signature start - :end-before: signature end - -Optional parameters are `named parameters` and have a default value. - -.. rubric:: Using defaults - -.. include:: ../sql/vroom/vrp_vroomShipments.sql - :start-after: default signature start - :end-before: default signature end +.. admonition:: \ \ + :class: signatures + + | vrp_vroomShipments( + | `Shipments SQL`_, `Shipments Time Windows SQL`_, + | `Vehicles SQL`_, + | `Breaks SQL`_, `Breaks Time Windows SQL`_, + | `Time Matrix SQL`_ + | [, exploration_level] [, timeout]) -- Experimental on v0.2 + | RETURNS SET OF + | (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, + | task_data, arrival, travel_time, service_time, waiting_time, departure, load) **Example**: This example is based on the modified VROOM Data of the :doc:`sampledata` network. The modification in the tables is mentioned at the end of the :doc:`sampledata`. @@ -72,9 +71,35 @@ The modification in the tables is mentioned at the end of the :doc:`sampledata`. Parameters ------------------------------------------------------------------------------- -.. include:: ../sql/vroom/vrp_vroomShipments.sql - :start-after: parameters start - :end-before: parameters end +.. vship_parameters_start + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Parameter + - Type + - Description + - - `Shipments SQL`_ + - ``TEXT`` + - Query describing pickup and delivery tasks that should happen within same route. + - - `Shipments Time Windows SQL`_ + - ``TEXT`` + - Query describing valid slots for pickup and delivery service start. + - - `Vehicles SQL`_ + - ``TEXT`` + - Query describing the available vehicles. + - - `Breaks SQL`_ + - ``TEXT`` + - Query describing the driver breaks. + - - `Breaks Time Windows SQL`_ + - ``TEXT`` + - Query describing valid slots for break start. + - - `Time Matrix SQL`_ + - ``TEXT`` + - Query containing the distance or travel times between the locations. + +.. vship_parameters_end Optional Parameters ............................................................................... diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index fe57c5950..19ab2b7f2 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -72,9 +72,9 @@ Optional parameters are `named parameters` and have a default value. Parameters ------------------------------------------------------------------------------- -.. include:: ../sql/vroom/vrp_vroomShipments.sql - :start-after: parameters start - :end-before: parameters end +.. include:: vrp_vroomShipments.rst + :start-after: vship_parameters_start + :end-before: vship_parameters_end Optional Parameters ............................................................................... diff --git a/sql/vroom/vrp_vroomShipments.sql b/sql/vroom/vrp_vroomShipments.sql index 17ab933a7..5fad5d7fa 100644 --- a/sql/vroom/vrp_vroomShipments.sql +++ b/sql/vroom/vrp_vroomShipments.sql @@ -26,58 +26,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ********************************************************************PGR-GNU*/ -/* -signature start - -.. code-block:: none - - vrp_vroomShipments( - Shipments SQL, Shipments Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL [, exploration_level] [, timeout]) -- Experimental on v0.2 - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -signature end - -default signature start - -.. code-block:: none - - vrp_vroomShipments( - Shipments SQL, Shipments Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL) - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -default signature end - -parameters start - -============================== =========== ========================================================= -Parameter Type Description -============================== =========== ========================================================= -**Shipments SQL** ``TEXT`` `Shipments SQL`_ query describing pickup and delivery - tasks that should happen within same route. -**Shipments Time Windows SQL** ``TEXT`` `Time Windows SQL`_ query describing valid slots - for pickup and delivery service start. -**Vehicles SQL** ``TEXT`` `Vehicles SQL`_ query describing the available vehicles. -**Breaks SQL** ``TEXT`` `Breaks SQL`_ query describing the driver breaks. -**Breaks Time Windows SQL** ``TEXT`` `Time Windows SQL`_ query describing valid slots for - break start. -**Matrix SQL** ``TEXT`` `Time Matrix SQL`_ query containing the distance or - travel times between the locations. -============================== =========== ========================================================= - -parameters end - -*/ - -- v0.2 CREATE FUNCTION vrp_vroomShipments( TEXT, -- shipments_sql (required) From 876ab6921a66b808c5e6280a9ef39ce48850f366 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 03:57:55 -0600 Subject: [PATCH 15/24] (doc) vrp_vroomShipmentsPlain.sql -> *.rst --- doc/vroom/vrp_vroomShipmentsPlain.rst | 21 +++++++++--------- sql/vroom/vrp_vroomShipmentsPlain.sql | 32 --------------------------- 2 files changed, 11 insertions(+), 42 deletions(-) diff --git a/doc/vroom/vrp_vroomShipmentsPlain.rst b/doc/vroom/vrp_vroomShipmentsPlain.rst index 19ab2b7f2..818637757 100644 --- a/doc/vroom/vrp_vroomShipmentsPlain.rst +++ b/doc/vroom/vrp_vroomShipmentsPlain.rst @@ -49,19 +49,20 @@ This function can be used to get the solution to a problem involving only shipme Signature ------------------------------------------------------------------------------- -.. rubric:: Summary -.. include:: ../sql/vroom/vrp_vroomShipmentsPlain.sql - :start-after: signature start - :end-before: signature end +.. admonition:: \ \ + :class: signatures -Optional parameters are `named parameters` and have a default value. + | vrp_vroomShipmentsPlain( + | `Shipments SQL`_, `Shipments Time Windows SQL`_, + | `Vehicles SQL`_, + | `Breaks SQL`_, `Breaks Time Windows SQL`_, + | `Time Matrix SQL`_ + | [, exploration_level] [, timeout]) -- Experimental on v0.2 + | RETURNS SET OF + | (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, + | task_data, arrival, travel_time, service_time, waiting_time, departure, load) -.. rubric:: Using defaults - -.. include:: ../sql/vroom/vrp_vroomShipmentsPlain.sql - :start-after: default signature start - :end-before: default signature end **Example**: This example is based on the VROOM Data of the :doc:`sampledata` network: diff --git a/sql/vroom/vrp_vroomShipmentsPlain.sql b/sql/vroom/vrp_vroomShipmentsPlain.sql index 126296127..38c3a03ca 100644 --- a/sql/vroom/vrp_vroomShipmentsPlain.sql +++ b/sql/vroom/vrp_vroomShipmentsPlain.sql @@ -26,38 +26,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ********************************************************************PGR-GNU*/ -/* -signature start - -.. code-block:: none - - vrp_vroomShipmentsPlain( - Shipments SQL, Shipments Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL [, exploration_level] [, timeout]) -- Experimental on v0.2 - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -signature end - -default signature start - -.. code-block:: none - - vrp_vroomShipmentsPlain( - Shipments SQL, Shipments Time Windows SQL, - Vehicles SQL, Breaks SQL, Breaks Time Windows SQL, - Matrix SQL) - - RETURNS SET OF - (seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id, - task_data, arrival, travel_time, service_time, waiting_time, departure, load) - -default signature end -*/ - -- v0.2 CREATE FUNCTION vrp_vroomShipmentsPlain( TEXT, -- shipments_sql (required) From 07ad936adb2cffaf9ae3324a98ff0a4c4d13f3ad Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 04:08:46 -0600 Subject: [PATCH 16/24] (doc) matrixRows_input.c -> *.rst --- doc/general/concepts.rst | 31 +++++++++++++++++++++ doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst | 8 +++--- src/common/matrixRows_input.c | 21 -------------- 3 files changed, 35 insertions(+), 25 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index 59374cd74..367d21fde 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -211,6 +211,37 @@ TBD Inner Queries ------------------------------------------------------------------------------- +Pickup-Delivery Inner Queries +............................................................................... + +Matrix SQL +******************************************************************************* + +.. pgr_matrix_start + +A ``SELECT`` statement that returns the following columns: + +``start_vid, end_vid, agg_cost`` + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Description + - - ``start_vid`` + - |ANY-INTEGER| + - Identifier of a node. + - - ``end_vid`` + - |ANY-INTEGER| + - Identifier of a node. + - - ``agg_cost`` + - |ANY-NUMERICAL| + - Cost to travel from ``start_vid`` to ``end_vid`` + +.. pgr_matrix_end + Vroom Inner Queries ............................................................................... diff --git a/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst b/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst index 3dca38567..95bac7f62 100644 --- a/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst +++ b/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst @@ -114,12 +114,12 @@ Vehicles SQL :end-before: pgr_pickDeliver end -Time Matrix SQL +Matrix SQL ......................................................................................... -.. include:: ../../src/common/matrixRows_input.c - :start-after: pgr_pickDeliver start - :end-before: pgr_pickDeliver end +.. include:: concepts.rst + :start-after: pgr_matrix_start + :end-before: pgr_matrix_end Result Columns ------------------------------------------------------------------------------- diff --git a/src/common/matrixRows_input.c b/src/common/matrixRows_input.c index afcbf2325..f3a05b572 100644 --- a/src/common/matrixRows_input.c +++ b/src/common/matrixRows_input.c @@ -37,27 +37,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. #include "c_common/debug_macro.h" #endif -/* -.. pgr_pickDeliver start - -A ``SELECT`` statement that returns the following columns: - -:: - - start_vid, end_vid, agg_cost - -============= =============== ================================================ -Column Type Description -============= =============== ================================================ -**start_vid** |ANY-INTEGER| Identifier of a node. -**end_vid** |ANY-NUMERICAL| Identifier of a node -**agg_cost** |ANY-NUMERICAL| Time to travel from ``start_vid`` to ``end_vid`` -============= =============== ================================================ - -.. pgr_pickDeliver end - -*/ - static void fetch_plain( HeapTuple *tuple, From 71bf98e57db3f1388a8752707db96764c52b18ea Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 04:15:20 -0600 Subject: [PATCH 17/24] (doc) orders_input.c -> *.rst --- doc/general/concepts.rst | 146 ++++++++++++++++++ doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst | 6 +- .../vrp_pgr_pickDeliverEuclidean.rst | 6 +- src/common/orders_input.c | 89 ----------- 4 files changed, 152 insertions(+), 95 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index 367d21fde..64b34f7bf 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -242,6 +242,152 @@ A ``SELECT`` statement that returns the following columns: .. pgr_matrix_end +Orders SQL +******************************************************************************* + +.. rubric:: Orders + +.. pgr_orders_start + +A ``SELECT`` statement that returns the following columns: + +| ``id, amount`` +| ``p_id, p_tw_open, p_tw_close, [p_service]`` +| ``d_id, d_tw_open, d_tw_close, [d_service]`` + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Default + - Description + - - ``id`` + - |ANY-INTEGER| + - + - Identifier of the pick-delivery order pair. + - - ``amount`` + - |ANY-NUMERICAL| + - + - Number of units in the order. + - - ``p_id`` + - |ANY-INTEGER| + - + - Identifier of the pickup node. + + - Must match a node identifier in the `Matrix SQL`_. + - - ``p_tw_open`` + - |ANY-INTEGER| + - + - The time, relative to 0, when the pickup location opens. + - - ``p_tw_close`` + - |ANY-INTEGER| + - + - The time, relative to 0, when the pickup location closes. + + - :math:`p\_tw\_open < p\_tw\_close < 9223372036854775807` + - - ``p_service`` + - |ANY-INTEGER| + - 0 + - The duration of the loading at the pickup location. + - - ``d_id`` + - |ANY-INTEGER| + - + - Identifier of the delivery node. + + - Must match a node identifier in the `Matrix SQL`_. + - - ``d_tw_open`` + - |ANY-INTEGER| + - + - The time, relative to 0, when the delivery location opens. + - - ``d_tw_close`` + - |ANY-INTEGER| + - + - The time, relative to 0, when the delivery location closes. + + - :math:`d\_tw\_open < d\_tw\_close <= 9223372036854775807` + - - ``d_service`` + - |ANY-INTEGER| + - 0 + - The duration of the unloading at the delivery location. + +.. pgr_orders_end + +.. rubric:: Euclidean Orders + +.. pgr_orders_e_start + +A ``SELECT`` statement that returns the following columns: + +| ``id, amount`` +| ``p_x, p_y, p_tw_open, p_tw_close, [p_service,]`` +| ``d_x, d_y, d_tw_open, d_tw_close, [d_service]`` + + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Default + - Description + - - ``id`` + - |ANY-INTEGER| + - + - Identifier of the pick-delivery order pair. + - - ``amount`` + - |ANY-NUMERICAL| + - + - Number of units in the order. + - - ``p_x`` + - |ANY-NUMERICAL| + - + - :math:`x` value of the pickup location. + - - ``p_y`` + - |ANY-NUMERICAL| + - + - :math:`y` value of the pickup location. + - - ``p_tw_open`` + - |ANY-INTEGER| + - + - The time, relative to 0, when the pickup location opens. + - - ``p_tw_close`` + - |ANY-INTEGER| + - + - The time, relative to 0, when the pickup location closes. + + - :math:`p\_tw\_open < p\_tw\_close < 9223372036854775807` + - - ``p_service`` + - |ANY-INTEGER| + - 0 + - The duration of the loading at the pickup location. + - - ``d_x`` + - |ANY-NUMERICAL| + - + - :math:`x` value of the delivery location. + - - ``d_y`` + - |ANY-NUMERICAL| + - + - :math:`y` value of the delivery location. + - - ``d_tw_open`` + - |ANY-INTEGER| + - + - The time, relative to 0, when the delivery location opens. + - - ``d_tw_close`` + - |ANY-INTEGER| + - + - The time, relative to 0, when the delivery location closes. + + - :math:`d\_tw\_open < d\_tw\_close <= 9223372036854775807` + - - ``d_service`` + - |ANY-INTEGER| + - 0 + - The duration of the unloading at the delivery location. + +.. pgr_orders_e_end + Vroom Inner Queries ............................................................................... diff --git a/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst b/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst index 95bac7f62..f83294d21 100644 --- a/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst +++ b/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst @@ -102,9 +102,9 @@ Inner Queries Orders SQL ................................................................................ -.. include:: ../../src/common/orders_input.c - :start-after: pgr_pickDeliver start - :end-before: pgr_pickDeliver end +.. include:: concepts.rst + :start-after: pgr_orders_start + :end-before: pgr_orders_end Vehicles SQL ................................................................................ diff --git a/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst b/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst index 21d5d343b..b8e529842 100644 --- a/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst +++ b/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst @@ -102,9 +102,9 @@ Inner Queries Orders SQL ................................................................................ -.. include:: ../../src/common/orders_input.c - :start-after: pgr_pickDeliverEuclidean start - :end-before: pgr_pickDeliverEuclidean end +.. include:: concepts.rst + :start-after: pgr_orders_e_start + :end-before: pgr_orders_e_end Vehicles SQL ................................................................................ diff --git a/src/common/orders_input.c b/src/common/orders_input.c index 586e0efea..d585e0f76 100644 --- a/src/common/orders_input.c +++ b/src/common/orders_input.c @@ -37,95 +37,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. #endif -/* -.. pgr_pickDeliver start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, amount - p_id, p_tw_open, p_tw_close, [p_service,] - d_id, d_tw_open, d_tw_close, [d_service] - - -================ =================== =========== ================================================ -Column Type Default Description -================ =================== =========== ================================================ -**id** |ANY-INTEGER| Identifier of the pick-delivery order pair. -**amount** |ANY-NUMERICAL| Number of units in the order -**p_id** |ANY-INTEGER| The identifier of the pickup node. -**p_tw_open** |ANY-NUMERICAL| The time, relative to 0, when the pickup location opens. -**p_tw_close** |ANY-NUMERICAL| The time, relative to 0, when the pickup location closes. -**p_service** |ANY-NUMERICAL| 0 The duration of the loading at the pickup location. -**d_id** |ANY-INTEGER| The identifier of the delivery node. -**d_tw_open** |ANY-NUMERICAL| The time, relative to 0, when the delivery location opens. -**d_tw_close** |ANY-NUMERICAL| The time, relative to 0, when the delivery location closes. -**d_service** |ANY-NUMERICAL| 0 The duration of the unloading at the delivery location. -================ =================== =========== ================================================ - -.. pgr_pickDeliver end - -.. pgr_pickDeliverEuclidean start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, amount - p_x, p_y, p_tw_open, p_tw_close, [p_service,] - d_x, d_y, d_tw_open, d_tw_close, [d_service] - - -================ =================== =========== ================================================ -Column Type Default Description -================ =================== =========== ================================================ -**id** |ANY-INTEGER| Identifier of the pick-delivery order pair. -**amount** |ANY-INTEGER| Number of units in the order -**p_x** |ANY-NUMERICAL| :math:`x` value of the pick up location -**p_y** |ANY-NUMERICAL| :math:`y` value of the pick up location -**p_tw_open** |ANY-INTEGER| The time, relative to 0, when the pickup location opens. -**p_tw_close** |ANY-INTEGER| The time, relative to 0, when the pickup location closes. -**p_service** |ANY-INTEGER| 0 The duration of the loading at the pickup location. -**d_x** |ANY-NUMERICAL| :math:`x` value of the delivery location -**d_y** |ANY-NUMERICAL| :math:`y` value of the delivery location -**d_tw_open** |ANY-INTEGER| The time, relative to 0, when the delivery location opens. -**d_tw_close** |ANY-INTEGER| The time, relative to 0, when the delivery location closes. -**d_service** |ANY-INTEGER| 0 The duration of the loading at the delivery location. -================ =================== =========== ================================================ - -.. pgr_pickDeliverEuclidean end - -.. vrp_pickDeliver start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, amount, requested_t - p_id, p_tw_open, p_tw_close, [p_service,] - d_id, d_tw_open, d_tw_close, [d_service] - - -================ =================== =========== ================================================ -Column Type Default Description -================ =================== =========== ================================================ -**id** |ANY-INTEGER| Identifier of the pick-delivery order pair. -**amount** |ANY-NUMERICAL| Number of units in the order -**requested_t** |ANY-NUMERICAL| TODO define if it is going to be used -**p_id** |ANY-INTEGER| The identifier of the pickup node. -**p_tw_open** |ANY-NUMERICAL| The time, relative to 0, when the pickup location opens. -**p_tw_close** |ANY-NUMERICAL| The time, relative to 0, when the pickup location closes. -**p_service** |ANY-NUMERICAL| 0 The duration of the loading at the pickup location. -**d_id** |ANY-INTEGER| The identifier of the delivery node. -**d_tw_open** |ANY-NUMERICAL| The time, relative to 0, when the delivery location opens. -**d_tw_close** |ANY-NUMERICAL| The time, relative to 0, when the delivery location closes. -**d_service** |ANY-NUMERICAL| 0 The duration of the unloading at the delivery location. -================ =================== =========== ================================================ - -.. vrp_pickDeliver end -*/ - static void fetch_euclidean( HeapTuple *tuple, From 7c03ad09375c0bdc0c411415d7bc1ee7e0838607 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 07:46:10 -0600 Subject: [PATCH 18/24] (doc) vehicles_input.c -> *.rst --- doc/conf.py.in | 1 + doc/general/concepts.rst | 155 ++++++++++++++++++ doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst | 6 +- .../vrp_pgr_pickDeliverEuclidean.rst | 6 +- src/common/vehicles_input.c | 149 ----------------- 5 files changed, 162 insertions(+), 155 deletions(-) diff --git a/doc/conf.py.in b/doc/conf.py.in index 1aec7c66f..ba02a60ae 100644 --- a/doc/conf.py.in +++ b/doc/conf.py.in @@ -330,6 +330,7 @@ linkcheck_anchors = False rst_epilog=""" .. |ANY-INTEGER| replace:: :abbr:`ANY-INTEGER(SMALLINT, INTEGER, BIGINT)` .. |ANY-NUMERICAL| replace:: :abbr:`ANY-NUMERICAL(SMALLINT, INTEGER, BIGINT, REAL, FLOAT)` +.. |MAX-BIGINT| replace:: :abbr:`MAX-BIGINT(9223372036854775807)` .. |br| raw:: html

  • diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index 64b34f7bf..f09a0ab7b 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -388,6 +388,161 @@ A ``SELECT`` statement that returns the following columns: .. pgr_orders_e_end +Vehicles SQL +******************************************************************************* + +.. rubric:: Vehicles + +.. pgr_vehicles_start + +A ``SELECT`` statement that returns the following columns: + +| ``id, capacity, [speed,]`` +| ``s_id, [s_tw_open, s_tw_close, s_service,]`` +| ``[e_id, e_tw_open, e_tw_close, e_service]`` + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Default + - Description + - - ``id`` + - |ANY-INTEGER| + - + - Identifier of the vehicle + - - ``capacity`` + - |ANY-INTEGER| + - + - Capacity of the vehicle. + + - :math:`0 < capacity <= 4294967295`. + - - ``speed`` + - |ANY-NUMERICAL| + - 1 + - Speed of the vehicle. + - - ``s_id`` + - |ANY-INTEGER| + - + - The node identifier of the starting location. + + - Must match a node identifier in the `Matrix SQL`_. + - - ``s_tw_open`` + - |ANY-INTEGER| + - 0 + - The time, relative to 0, when the starting location opens. + - - ``s_tw_close`` + - |ANY-INTEGER| + - |MAX-BIGINT| + - The time, relative to 0, when the starting location closes. + + - :math:`s\_tw\_open < s\_tw\_close <= 9223372036854775807` + - - ``s_service`` + - |ANY-INTEGER| + - 0 + - Duration of any task at the starting location, + - - ``e_id`` + - |ANY-INTEGER| + - ``s_id`` + - The node identifier of the ending location. + + - Must match a node identifier in the `Matrix SQL`_. + - - ``e_tw_open`` + - |ANY-INTEGER| + - ``s_tw_open`` + - The time, relative to 0, when the ending location opens. + - - ``e_tw_close`` + - |ANY-INTEGER| + - ``s_tw_close`` + - The time, relative to 0, when the ending location closes. + + - :math:`e\_tw\_open < e\_tw\_close <= 9223372036854775807` + - - ``e_service`` + - |ANY-INTEGER| + - ``s_service`` + - The duration of any task at the ending location + +.. pgr_vehicles_end + +.. rubric:: Euclidean Vehicles + +.. pgr_vehicles_e_start + +A ``SELECT`` statement that returns the following columns: + +| ``id, capacity, [speed,]`` +| ``s_x, s_y, [s_tw_open, s_tw_close, s_service]`` +| ``[e_x, e_y, e_tw_open, e_tw_close, e_service]`` + +.. list-table:: + :widths: auto + :header-rows: 1 + + - - Column + - Type + - Default + - Description + - - ``id`` + - |ANY-INTEGER| + - + - Identifier of the vehicle. + - - ``capacity`` + - |ANY-INTEGER| + - + - Capacity of the vehicle. :math:`0 < capacity <= 4294967295`. + - - ``speed`` + - |ANY-NUMERICAL| + - 1 + - Speed of the vehicle. + - - ``s_x`` + - |ANY-NUMERICAL| + - + - :math:`x` value of the coordinate of the starting location. + - - ``s_y`` + - |ANY-NUMERICAL| + - + - :math:`y` value of the coordinate of the starting location. + - - ``s_tw_open`` + - |ANY-INTEGER| + - 0 + - The time, relative to 0, when the starting location opens. + - - ``s_tw_close`` + - |ANY-INTEGER| + - |MAX-BIGINT| + - The time, relative to 0, when the starting location closes. + + - :math:`s\_tw\_open < s\_tw\_close <= 9223372036854775807` + - - ``s_service`` + - |ANY-INTEGER| + - 0 + - Duration of any task at the ending location, + - - ``e_x`` + - |ANY-NUMERICAL| + - + - :math:`x` value of the coordinate of the ending location. + - - ``e_y`` + - |ANY-NUMERICAL| + - + - :math:`y` value of the coordinate of the ending location. + - - ``e_tw_open`` + - |ANY-INTEGER| + - ``s_tw_open`` + - The time, relative to 0, when the ending location opens. + - - ``e_tw_close`` + - |ANY-INTEGER| + - ``s_tw_close`` + - The time, relative to 0, when the ending location closes. + + - :math:`e\_tw\_open < e\_tw\_close <= 9223372036854775807` + - - ``e_service`` + - |ANY-INTEGER| + - ``s_service`` + - The duration of any task at the ending location + +.. pgr_vehicles_e_end + Vroom Inner Queries ............................................................................... diff --git a/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst b/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst index f83294d21..7298e8cf3 100644 --- a/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst +++ b/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst @@ -109,9 +109,9 @@ Orders SQL Vehicles SQL ................................................................................ -.. include:: ../../src/common/vehicles_input.c - :start-after: pgr_pickDeliver start - :end-before: pgr_pickDeliver end +.. include:: concepts.rst + :start-after: pgr_vehicles_start + :end-before: pgr_vehicles_end Matrix SQL diff --git a/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst b/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst index b8e529842..48cefa313 100644 --- a/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst +++ b/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst @@ -109,9 +109,9 @@ Orders SQL Vehicles SQL ................................................................................ -.. include:: ../../src/common/vehicles_input.c - :start-after: pgr_pickDeliverEuclidean start - :end-before: pgr_pickDeliverEuclidean end +.. include:: concepts.rst + :start-after: pgr_vehicles_e_start + :end-before: pgr_vehicles_e_end Result Columns diff --git a/src/common/vehicles_input.c b/src/common/vehicles_input.c index f29814ddd..af7ae879c 100644 --- a/src/common/vehicles_input.c +++ b/src/common/vehicles_input.c @@ -41,155 +41,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. #include "c_common/debug_macro.h" #endif -/* -.. pgr_pickDeliver start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, capacity, [speed,] - s_id, s_tw_open, s_tw_close, [s_service,] - [e_id, e_tw_open, e_tw_close, e_service] - - - -================== =================== ================ ================================================ -Column Type Default Description -================== =================== ================ ================================================ -**id** |ANY-INTEGER| Identifier of the vehicle -**capacity** |ANY-NUMERICAL| Capacity of the vehicle -**speed** |ANY-NUMERICAL| `1` Average speed of the vehicle. -**s_id** |ANY-INTEGER| The node identifier of the starting location, must match a node identifier in the matrix table. -**s_tw_open** |ANY-NUMERICAL| `0` The time, relative to 0, when the starting location opens. - When `s_tw_open` column exist then `s_tw_close` column is expected - Default value when (`s_tw_open`, s_tw_close) columns do not exist -**s_tw_close** |ANY-NUMERICAL| `INFINITY` The time, relative to 0, when the starting location closes. - When `s_tw_close` column exist then `e_tw_open` column is expected - Default value when `(s_tw_open, s_tw_close)` columns do not exist -**s_service** |ANY-NUMERICAL| `0` The duration of the loading at the starting location. -**e_id** |ANY-INTEGER| `s_id` The node identifier of the ending location, must match a node identifier in the matrix table. -**e_tw_open** |ANY-NUMERICAL| `s_tw_open` The time, relative to 0, when the ending location opens. - When `e_tw_open` column exist then `e__tw_close` column is expected - Default value when (`e_tw_open`, e_tw_close) columns do not exist -**e_tw_close** |ANY-NUMERICAL| `s_tw_close` The time, relative to 0, when the ending location closes. - When `e_tw_close` column exist then `e_tw_open` column is expected - Default value when `(e_tw_open`, e_tw_close)` columns do not exist -**e_service** |ANY-NUMERICAL| `s_service` The duration of the unloading at the ending location. -================== =================== ================ ================================================ - -Throws: -* When column `id` is missing -* When column `capacity` is missing -* When column `s_id` is missing -* When column `s_tw_open` exists but not `s_tw_close` -* When column `s_tw_close`exists but not `s_tw_open` -* When column `e_tw_open` exists but not `e_tw_close` -* When column `e_tw_close`exists but not `e_tw_open` - -.. pgr_pickDeliver end -.. pgr_pickDeliverEuclidean start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, capacity, [speed,] - s_x, s_y, s_tw_open, s_tw_close, [s_service,] - [e_x, e_y, e_tw_open, e_tw_close, e_service] - -================== =================== ================ ================================================ -Column Type Default Description -================== =================== ================ ================================================ -**id** |ANY-INTEGER| Identifier of the vehicle -**capacity** |ANY-NUMERICAL| Capacity of the vehicle -**speed** |ANY-NUMERICAL| `1` Average speed of the vehicle. -**s_x** |ANY-NUMERICAL| :math:`x` value of the coordinate of the starting location. -**s_y** |ANY-NUMERICAL| :math:`y` value of the coordinate of the starting location. -**s_tw_open** |ANY-NUMERICAL| `0` The time, relative to 0, when the starting location opens. - When `s_tw_open` column exist then `s_tw_close` column is expected - Default value when (`s_tw_open`, s_tw_close) columns do not exist -**s_tw_close** |ANY-NUMERICAL| `INFINITY` The time, relative to 0, when the starting location closes. - When `s_tw_close` column exist then `e_tw_open` column is expected - Default value when `(s_tw_open, s_tw_close)` columns do not exist -**s_service** |ANY-NUMERICAL| `0` The duration of the loading at the starting location. -**e_tw_open** |ANY-NUMERICAL| `s_tw_open` The time, relative to 0, when the ending location opens. - When `e_tw_open` column exist then `e__tw_close` column is expected - Default value when (`e_tw_open`, e_tw_close) columns do not exist -**e_tw_close** |ANY-NUMERICAL| `s_tw_close` The time, relative to 0, when the ending location closes. - When `e_tw_close` column exist then `e_tw_open` column is expected - Default value when `(e_tw_open`, e_tw_close)` columns do not exist -**e_service** |ANY-NUMERICAL| `s_service` The duration of the loading at the ending location. -**e_x** |ANY-NUMERICAL| `s_x` :math:`x` value of the coordinate of the ending location. - Default value when `(e_x, e_y)` columns do not exist - Default value when `e_y` column does not exist -**e_y** |ANY-NUMERICAL| `s_y` :math:`y` value of the coordinate of the ending location. - When `e_y` column exist then `e_x` column is expected - Default value when `(e_x, e_y)` columns do not exist -================== =================== ================ ================================================ - -Throws: -* When column `id` is missing -* When column `capacity` is missing -* When column `s_x` is missing -* When column `s_y` is missing -* When column `s_tw_open` exists but not `s_tw_close` -* When column `s_tw_close`exists but not `s_tw_open` -* When column `e_y` exists but not `e_x` -* When column `e_x` exists but not `e_y` -* When column `e_tw_open` exists but not `e_tw_close` -* When column `e_tw_close`exists but not `e_tw_open` - -.. pgr_pickDeliverEuclidean end - -.. vrp_pickDeliver start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, capacity, [speed,] - s_id, s_tw_open, s_tw_close, [s_service,] - [e_id, e_tw_open, e_tw_close, e_service] - - - -================== =================== ================ ================================================ -Column Type Default Description -================== =================== ================ ================================================ -**id** |ANY-INTEGER| Identifier of the vehicle -**capacity** |ANY-NUMERICAL| Capacity of the vehicle -**stops** |ANY-NUMERICAL| `[]` Array of shipments identifiers indicating an initial solution -**s_id** |ANY-INTEGER| The node identifier of the starting location, must match a node identifier in the matrix table. -**s_tw_open** |ANY-NUMERICAL| `0` The time, relative to 0, when the starting location opens. - When `s_tw_open` column exist then `s_tw_close` column is expected - Default value when (`s_tw_open`, s_tw_close) columns do not exist -**s_tw_close** |ANY-NUMERICAL| `INFINITY` The time, relative to 0, when the starting location closes. - When `s_tw_close` column exist then `e_tw_open` column is expected - Default value when `(s_tw_open, s_tw_close)` columns do not exist -**s_service** |ANY-NUMERICAL| `0` The duration of the loading at the starting location. -**e_id** |ANY-INTEGER| `s_id` The node identifier of the ending location, must match a node identifier in the matrix table. -**e_tw_open** |ANY-NUMERICAL| `s_tw_open` The time, relative to 0, when the ending location opens. - When `e_tw_open` column exist then `e__tw_close` column is expected - Default value when (`e_tw_open`, e_tw_close) columns do not exist -**e_tw_close** |ANY-NUMERICAL| `s_tw_close` The time, relative to 0, when the ending location closes. - When `e_tw_close` column exist then `e_tw_open` column is expected - Default value when `(e_tw_open`, e_tw_close)` columns do not exist -**e_service** |ANY-NUMERICAL| `s_service` The duration of the unloading at the ending location. -================== =================== ================ ================================================ - -Throws: -* When column `id` is missing -* When column `capacity` is missing -* When column `s_id` is missing -* When column `s_tw_open` exists but not `s_tw_close` -* When column `s_tw_close`exists but not `s_tw_open` -* When column `e_tw_open` exists but not `e_tw_close` -* When column `e_tw_close`exists but not `e_tw_open` - -.. pgr_pickDeliver end -*/ - static void check_pairs(Column_info_t lhs, Column_info_t rhs) { if (!(column_found(lhs.colNumber)) && column_found(rhs.colNumber)) { From 056faa1a2911f8f0a83b93b84c05becc31662ebf Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 08:24:16 -0600 Subject: [PATCH 19/24] (doc) pgr_pickDeliver.sql -> *.rst --- doc/general/concepts.rst | 142 ++++++++++++++++++++ doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst | 74 ++++++++-- sql/pgr_pickDeliver/pgr_pickDeliver.sql | 72 ---------- 3 files changed, 207 insertions(+), 81 deletions(-) diff --git a/doc/general/concepts.rst b/doc/general/concepts.rst index f09a0ab7b..68a186895 100644 --- a/doc/general/concepts.rst +++ b/doc/general/concepts.rst @@ -1015,6 +1015,148 @@ A ``SELECT`` statement that returns the following columns: Return columns & values -------------------------------------------------------------------------------- +Pick-Deliver result columns +............................................................................... + +.. rubric:: Results + +.. pd_result_start + +Returns set of + +| ``seq, vehicle_number, vehicle_id, stop_seq, stop_type, stop_id, order_id, cargo,`` +| ``travel_time, arrival_time, wait_time, service_time, departure_time`` + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Column + - Type + - Description + * - ``seq`` + - ``INTEGER`` + - Sequential value starting from **1**. + * - ``vehicle_seq`` + - ``INTEGER`` + - Sequential value starting from **1** for current vehicles. The + :math:`n_{th}` vehicle in the solution. + * - ``vehicle_id`` + - ``BIGINT`` + - Current vehicle identifier. + * - ``stop_seq`` + - ``INTEGER`` + - Sequential value starting from **1** for the stops made by the current + vehicle. The :math:`m_{th}` stop of the current vehicle. + * - ``stop_type`` + - ``INTEGER`` + - Kind of stop location the vehicle is at: + + - ``1``: Starting location + - ``2``: Pickup location + - ``3``: Delivery location + - ``6``: Ending location + * - ``stop_id`` + - ``BIGINT`` + - Identifier of the stop. + * - ``order_id`` + - ``BIGINT`` + - Pickup-Delivery order pair identifier. + + - ``-1``: When no order is involved on the current stop location. + * - ``cargo`` + - ``BIGINT`` + - Cargo units of the vehicle when leaving the stop. + * - ``travel_time`` + - ``BIGINT`` + - Travel time from previous ``stop_seq`` to current ``stop_seq``. + + - ``0`` When ``stop_type = 1`` + * - ``arrival_time`` + - ``BIGINT`` + - Previous ``departure_time`` plus current ``travel_time``. + * - ``wait_time`` + - ``BIGINT`` + - Time spent waiting for current `location` to open. + * - ``service_time`` + - ``BIGINT`` + - Service time at current `location`. + * - ``departure_time`` + - ``BIGINT`` + - :math:`arrival\_time + wait\_time + service\_time`. + + - When ``stop_type = 6`` has the `total_time` used for the current vehicle. + +.. pd_result_end + +.. rubric:: Euclidean Results + +.. pde_result_start + +Returns set of + +| ``seq, vehicle_seq, vehicle_id, stop_seq, stop_type, order_id, cargo,`` +| ``travel_time, arrival_time, wait_time, service_time, departure_time`` + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Column + - Type + - Description + * - ``seq`` + - ``INTEGER`` + - Sequential value starting from **1**. + * - ``vehicle_seq`` + - ``INTEGER`` + - Sequential value starting from **1** for current vehicles. The + :math:`n_{th}` vehicle in the solution. + * - ``vehicle_id`` + - ``BIGINT`` + - Current vehicle identifier. + * - ``stop_seq`` + - ``INTEGER`` + - Sequential value starting from **1** for the stops made by the current + vehicle. The :math:`m_{th}` stop of the current vehicle. + * - ``stop_type`` + - ``INTEGER`` + - Kind of stop location the vehicle is at: + + - ``1``: Starting location + - ``2``: Pickup location + - ``3``: Delivery location + - ``6``: Ending location + * - ``order_id`` + - ``BIGINT`` + - Pickup-Delivery order pair identifier. + + - ``-1``: When no order is involved on the current stop location. + * - ``cargo`` + - ``BIGINT`` + - Cargo units of the vehicle when leaving the stop. + * - ``travel_time`` + - ``BIGINT`` + - Travel time from previous ``stop_seq`` to current ``stop_seq``. + + - ``0`` When ``stop_type = 1`` + * - ``arrival_time`` + - ``BIGINT`` + - Previous ``departure_time`` plus current ``travel_time``. + * - ``wait_time`` + - ``BIGINT`` + - Time spent waiting for current `location` to open. + * - ``service_time`` + - ``BIGINT`` + - Service time at current `location`. + * - ``departure_time`` + - ``BIGINT`` + - :math:`arrival\_time + wait\_time + service\_time`. + + - When ``stop_type = 6`` has the `total_time` used for the current vehicle. + +.. pde_result_end + VROOM result columns ............................................................................... diff --git a/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst b/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst index 7298e8cf3..d0a89c44e 100644 --- a/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst +++ b/doc/pgr_pickDeliver/vrp_pgr_pickDeliver.rst @@ -82,18 +82,74 @@ Characteristics Signature ------------------------------------------------------------------------------- -.. include:: ../sql/pgr_pickDeliver/pgr_pickDeliver.sql - :start-after: signature start - :end-before: signature end +.. admonition:: \ \ + :class: signatures + | pgr_pickDeliver( + | `Orders SQL`_, `Vehicles SQL`_, `Matrix SQL`_ + | ``[factor, max_cycles, initial_sol]`` + | RETURNS SET OF + | ``seq, vehicle_number, vehicle_id, stop, order_id, stop_type, cargo,`` + | ``travel_time, arrival_time, wait_time, service_time, departure_time`` Parameters ------------------------------------------------------------------------------- -.. include:: ../sql/pgr_pickDeliver/pgr_pickDeliver.sql - :start-after: parameters start - :end-before: parameters end +.. pd_parameters_start +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Column + - Type + - Description + * - `Orders SQL`_ + - ``TEXT`` + - `Orders SQL`_ as described below. + * - `Vehicles SQL`_ + - ``TEXT`` + - `Vehicles SQL`_ as described below. + * - `Matrix SQL`_ + - ``TEXT`` + - `Matrix SQL`_ as described below. + +.. pd_parameters_end + +Optional Parameters +------------------------------------------------------------------------------- + +.. pd_optionals_start + +.. list-table:: + :widths: auto + :header-rows: 1 + + * - Column + - Type + - Default + - Description + * - ``factor`` + - ``NUMERIC`` + - 1 + - Travel time multiplier. See :ref:`pd_factor` + * - ``max_cycles`` + - ``INTEGER`` + - 10 + - Maximum number of cycles to perform on the optimization. + * - ``initial_sol`` + - ``INTEGER`` + - 4 + - Initial solution to be used. + + - ``1`` One order per truck + - ``2`` Push front order. + - ``3`` Push back order. + - ``4`` Optimize insert. + - ``5`` Push back order that allows more orders to be inserted at the back + - ``6`` Push front order that allows more orders to be inserted at the front + +.. pd_optionals_end Inner Queries ------------------------------------------------------------------------------- @@ -124,9 +180,9 @@ Matrix SQL Result Columns ------------------------------------------------------------------------------- -.. include:: ../sql/pgr_pickDeliver/pgr_pickDeliver.sql - :start-after: result start - :end-before: result end +.. include:: concepts.rst + :start-after: pd_result_start + :end-before: pd_result_end Example ------------------------------------------------------------------------------- diff --git a/sql/pgr_pickDeliver/pgr_pickDeliver.sql b/sql/pgr_pickDeliver/pgr_pickDeliver.sql index ab70ae329..b5517ece3 100644 --- a/sql/pgr_pickDeliver/pgr_pickDeliver.sql +++ b/sql/pgr_pickDeliver/pgr_pickDeliver.sql @@ -24,78 +24,6 @@ along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ********************************************************************PGR-GNU*/ -/* -signature start - -:: - - vrp_pgr_pickDeliver(Orders SQL, Vehicles SQL, Matrix SQL [, factor, max_cycles, initial_sol]) - RETURNS SET OF: - seq, vehicle_seq, vehicle_id, - stop_seq, stop_type, stop_id, order_id - cargo, travel_time, arrival_time, wait_time, service_time, departure_time - -signature end - -parameters start - -================= ================== ========= ================================================= -Column Type Default Description -================= ================== ========= ================================================= -**Orders SQL** ``TEXT`` `Orders SQL`_ query contianing the orders to be processed. -**Vehicles SQL** ``TEXT`` `Vehicles SQL`_ query containing the vehicles to be used. -**Matrix SQL** ``TEXT`` `Time Matrix SQL`_ query containing the distance or travel times. -**factor** ``NUMERIC`` 1 Travel time multiplier. See :ref:`pd_factor` -**max_cycles** ``INTEGER`` 10 Maximum number of cycles to perform on the optimization. -**initial_sol** ``INTEGER`` 4 Initial solution to be used. - - - ``1`` One order per truck - - ``2`` Push front order. - - ``3`` Push back order. - - ``4`` Optimize insert. - - ``5`` Push back order that allows more orders to be inserted at the back - - ``6`` Push front order that allows more orders to be inserted at the front -================= ================== ========= ================================================= - -parameters end - -result start - -=================== ============= ================================================= -Column Type Description -=================== ============= ================================================= -**seq** INTEGER Sequential value starting from **1**. -**vehicle_seq** INTEGER Sequential value starting from **1** for current vehicles. The :math:`n_{th}` vehicle in the solution. -**vehicle_id** BIGINT Current vehicle identifier. -**stop_seq** INTEGER Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m_{th}` stop of the current vehicle. -**stop_type** INTEGER Kind of stop location the vehicle is at: - - - ``1``: Starting location - - ``2``: Pickup location - - ``3``: Delivery location - - ``6``: Ending location - -**stop_id** INTEGER -**order_id** BIGINT Pickup-Delivery order pair identifier. - - - ``-1``: When no order is involved on the current stop location. - -**cargo** FLOAT Cargo units of the vehicle when leaving the stop. - -**travel_time** FLOAT Travel time from previous ``stop_seq`` to current ``stop_seq``. - - - ``0`` When ``stop_type = 1`` - -**arrival_time** FLOAT Previous ``departure_time`` plus current ``travel_time``. -**wait_time** FLOAT Time spent waiting for current `location` to open. -**service_time** FLOAT Service time at current `location`. -**departure_time** FLOAT :math:`arrival\_time + wait\_time + service\_time`. - - - When ``stop_type = 6`` has the `total_time` used for the current vehicle. -=================== ============= ================================================= - -result end -*/ --v0.0 CREATE FUNCTION vrp_pgr_pickDeliver( From 2d6df0c107d8b9ab0230e2c98bdc8614f8095a23 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 08:30:28 -0600 Subject: [PATCH 20/24] (doc) pgr_pickDeliverEuclidean.sql -> *.rst --- .../vrp_pgr_pickDeliverEuclidean.rst | 75 ++++++++++++++++--- .../pgr_pickDeliverEuclidean.sql | 73 ------------------ 2 files changed, 66 insertions(+), 82 deletions(-) diff --git a/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst b/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst index 48cefa313..28afd549f 100644 --- a/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst +++ b/doc/pgr_pickDeliver/vrp_pgr_pickDeliverEuclidean.rst @@ -82,18 +82,75 @@ Characteristics Signature ------------------------------------------------------------------------------- -.. include:: ../sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql - :start-after: signature start - :end-before: signature end +.. admonition:: \ \ + :class: signatures + | ``pgr_pickDeliverEuclidean(`` + | `Orders SQL`_, `Vehicles SQL`_ + | ``[factor, max_cycles, initial_sol]`` + | RETURNS SET OF + | ``seq, vehicle_number, vehicle_id, stop, order_id, stop_type, cargo,`` + | ``travel_time, arrival_time, wait_time, service_time, departure_time`` Parameters ------------------------------------------------------------------------------- -.. include:: ../sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql - :start-after: parameters start - :end-before: parameters end +.. pde_parameters_start +.. list-table:: + :width: 81 + :widths: auto + :header-rows: 1 + + * - Column + - Type + - Description + * - `Orders SQL`_ + - ``TEXT`` + - `Orders SQL`_ as described below. + * - `Vehicles SQL`_ + - ``TEXT`` + - `Vehicles SQL`_ as described below. + +.. pde_parameters_end + +Optional Parameters +------------------------------------------------------------------------------- + +.. pde_optionals_start + +.. list-table:: + :width: 81 + :widths: auto + :header-rows: 1 + + * - Column + - Type + - Default + - Description + * - ``factor`` + - ``NUMERIC`` + - 1 + - Travel time multiplier. See :ref:`pd_factor` + * - ``max_cycles`` + - ``INTEGER`` + - 10 + - Maximum number of cycles to perform on the optimization. + * - ``initial_sol`` + - ``INTEGER`` + - 4 + - Initial solution to be used. + + - ``1`` One order per truck + - ``2`` Push front order. + - ``3`` Push back order. + - ``4`` Optimize insert. + - ``5`` Push back order that allows more orders to be inserted at the + back + - ``6`` Push front order that allows more orders to be inserted at the + front + +.. pde_optionals_end Inner Queries ------------------------------------------------------------------------------- @@ -117,9 +174,9 @@ Vehicles SQL Result Columns ------------------------------------------------------------------------------- -.. include:: ../sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql - :start-after: result start - :end-before: result end +.. include:: concepts.rst + :start-after: pde_result_start + :end-before: pde_result_end Example diff --git a/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql b/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql index d090fc3cf..2377a1a22 100644 --- a/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql +++ b/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql @@ -26,79 +26,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ********************************************************************PGR-GNU*/ -/* -.. signature start - -:: - - vrp_pgr_pickDeliverEuclidean(Orders SQL, Vehicles SQL [, factor, max_cycles, initial_sol]) - RETURNS SET OF: - seq, vehicle_seq, vehicle_id, - stop_seq, stop_type, order_id, - cargo, travel_time, arrival_time, wait_time, service_time, departure_time) - -.. signature end - - -.. parameters start - -================= ================== ========= ================================================= -Column Type Default Description -================= ================== ========= ================================================= -**Orders SQL** ``TEXT`` `Orders SQL`_ query contianing the orders to be processed. -**Vehicles SQL** ``TEXT`` `Vehicles SQL`_ query containing the vehicles to be used. -**factor** ``NUMERIC`` 1 Travel time multiplier. See :ref:`pd_factor` -**max_cycles** ``INTEGER`` 10 Maximum number of cycles to perform on the optimization. -**initial_sol** ``INTEGER`` 4 Initial solution to be used. - - - ``1`` One order per truck - - ``2`` Push front order. - - ``3`` Push back order. - - ``4`` Optimize insert. - - ``5`` Push back order that allows more orders to be inserted at the back - - ``6`` Push front order that allows more orders to be inserted at the front -================= ================== ========= ================================================= - -.. parameters end - -.. result start - -=================== ============= ================================================= -Column Type Description -=================== ============= ================================================= -**seq** INTEGER Sequential value starting from **1**. -**vehicle_seq** INTEGER Sequential value starting from **1** for current vehicles. The :math:`n_{th}` vehicle in the solution. -**vehicle_id** BIGINT Current vehicle identifier. -**stop_seq** INTEGER Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m_{th}` stop of the current vehicle. -**stop_type** INTEGER Kind of stop location the vehicle is at: - - - ``1``: Starting location - - ``2``: Pickup location - - ``3``: Delivery location - - ``6``: Ending location - -**order_id** BIGINT Pickup-Delivery order pair identifier. - - - ``-1``: When no order is involved on the current stop location. - -**cargo** FLOAT Cargo units of the vehicle when leaving the stop. - -**travel_time** FLOAT Travel time from previous ``stop_seq`` to current ``stop_seq``. - - - ``0`` When ``stop_type = 1`` - -**arrival_time** FLOAT Previous ``departure_time`` plus current ``travel_time``. -**wait_time** FLOAT Time spent waiting for current `location` to open. -**service_time** FLOAT Service time at current `location`. -**departure_time** FLOAT :math:`arrival\_time + wait\_time + service\_time`. - - - When ``stop_type = 6`` has the `total_time` used for the current vehicle. -=================== ============= ================================================= - -.. result end - -*/ - --v0.0 CREATE FUNCTION vrp_pgr_pickDeliverEuclidean( TEXT, -- orders_sql (required) From 349a57447a29de44da8fe1d1640bb2ee410017e8 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 08:36:36 -0600 Subject: [PATCH 21/24] (doc) or_tools -> *.rst --- doc/or_tools/vrp_multiple_knapsack.rst | 8 --- sql/or_tools/multiple_knapsack.sql | 81 +------------------------- 2 files changed, 1 insertion(+), 88 deletions(-) diff --git a/doc/or_tools/vrp_multiple_knapsack.rst b/doc/or_tools/vrp_multiple_knapsack.rst index 9e3f8f6df..379bab5e6 100644 --- a/doc/or_tools/vrp_multiple_knapsack.rst +++ b/doc/or_tools/vrp_multiple_knapsack.rst @@ -53,10 +53,6 @@ Signatures | RETURNS SET OF (knapsack, id) | OR EMPTY SET -.. include:: ../../sql/or_tools/multiple_knapsack.sql - :start-after: signature start - :end-before: signature end - Parameters ------------------------------------------------------------------------------- @@ -120,10 +116,6 @@ Result Columns - ``INTEGER`` - Indentifier of an item in the ``knapsack``. -.. include:: ../../sql/or_tools/multiple_knapsack.sql - :start-after: result start - :end-before: result end - Example ------------------------------------------------------------------------------- diff --git a/sql/or_tools/multiple_knapsack.sql b/sql/or_tools/multiple_knapsack.sql index e38f7722f..4d06da386 100644 --- a/sql/or_tools/multiple_knapsack.sql +++ b/sql/or_tools/multiple_knapsack.sql @@ -24,87 +24,8 @@ along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ********************************************************************PGR-GNU*/ -/* -signature start - -.. code-block:: none - - vrp_multiple_knapsack( - Weights_Costs SQL, capacities ARRAY[ANY-INTEGER], [, max_rows]) - - RETURNS SET OF - (knapsack_number, item_id) - -signature end - -parameters start - -============================== ======================= ========================================================= -Parameter Type Description -============================== ======================= ========================================================= -**Weights_Costs SQL** ``TEXT`` `Weights_Costs SQL`_ query describing the weight of each item -**Capacities** ``ARRAY[ANY-INTEGER]`` An array describing the capacity of each knapsack -============================== ======================= ========================================================= - -parameters end - -optional parameters start - -===================== ================ ============================= ================================================= -Parameter Type Default Description -===================== ================ ============================= ================================================= -**max_rows** ``ANY-INTEGER`` :math:`100000` Maximum items(rows) to fetch from bin_packing_data - table -===================== ================ ============================= ================================================= - -optional parameters end - -.. Weights_Costs start - -A ``SELECT`` statement that returns the following columns: - -:: - - id, weight, cost - - -==================== ========================= =========== ================================================ -Column Type Default Description -==================== ========================= =========== ================================================ -**id** ``ANY-INTEGER`` unique identifier of the item. - -**weight** ``ANY-INTEGER`` weight of the item. - -**cost** ``ANY-INTEGER`` cost of the item. -==================== ========================= =========== ================================================ - -.. Weights_Costs end - -result start - -Returns set of - -.. code-block:: none - - (knapsack_number, item_id) - -=================== ================= ================================================= -Column Type Description -=================== ================= ================================================= -**knapsack_number** ``ANY-INTEGER`` Integer to uniquely identify a knapsack - -**item_id** ``ANY-INTEGER`` Integer to uniquely identify an item in the - bin -=================== ================= ================================================= -result end - -**Note**: - -- ANY-INTEGER: [SMALLINT, INTEGER, BIGINT] -*/ - - +--v4.0 CREATE OR REPLACE FUNCTION vrp_multiple_knapsack( inner_query TEXT, -- weights_cost SQL capacities INTEGER[], -- ARRAY of Knapsack Capacities From a567dc34393f0493c6753f58f2a325f70dc7f947 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 09:17:41 -0600 Subject: [PATCH 22/24] (NEWS) Adjusting news --- NEWS.md | 1 + doc/general/release_notes.rst | 1 + tools/scripts/notes2news.pl | 1 + 3 files changed, 3 insertions(+) diff --git a/NEWS.md b/NEWS.md index efe00ec9a..50b199b36 100644 --- a/NEWS.md +++ b/NEWS.md @@ -13,6 +13,7 @@ on Github. **Code reorganization** * Renamed files to be compiled as C++ with .hpp & .cpp extensions +* Moved sphinx doc from .c files .rst files **Documentation queries** diff --git a/doc/general/release_notes.rst b/doc/general/release_notes.rst index 750aa053e..95ee1d84b 100644 --- a/doc/general/release_notes.rst +++ b/doc/general/release_notes.rst @@ -48,6 +48,7 @@ on Github. .. rubric:: Code reorganization * Renamed files to be compiled as C++ with .hpp & .cpp extensions +* Moved sphinx doc from .c files .rst files .. rubric:: Documentation queries diff --git a/tools/scripts/notes2news.pl b/tools/scripts/notes2news.pl index 0720b1f83..8531119de 100755 --- a/tools/scripts/notes2news.pl +++ b/tools/scripts/notes2news.pl @@ -161,6 +161,7 @@ sub get_substitutions { my $skipping = 1; while (my $line = <$fh>) { next if $skipping and $line !~ /$mstart/; + last if $line =~ /\|br\|/; $skipping = 0; next if $line =~ /$mstart/; last if $line =~ /$mend/; From 03d6ff4dc10d9491a80efc889111799d48e2c286 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sun, 4 Aug 2024 15:19:49 +0000 Subject: [PATCH 23/24] Update locale: commit for hash a567dc3 --- locale/en/LC_MESSAGES/concepts.po | 1622 ++++++++++++++- locale/en/LC_MESSAGES/release_notes.po | 130 +- locale/en/LC_MESSAGES/vroom-category.po | 806 ++++---- .../en/LC_MESSAGES/vrp_multiple_knapsack.po | 102 +- locale/en/LC_MESSAGES/vrp_pgr_pickDeliver.po | 570 +++--- .../vrp_pgr_pickDeliverEuclidean.po | 564 ++--- locale/en/LC_MESSAGES/vrp_vroom.po | 999 +++++---- locale/en/LC_MESSAGES/vrp_vroomJobs.po | 815 ++++---- locale/en/LC_MESSAGES/vrp_vroomJobsPlain.po | 828 ++++---- locale/en/LC_MESSAGES/vrp_vroomPlain.po | 1015 +++++---- locale/en/LC_MESSAGES/vrp_vroomShipments.po | 874 ++++---- .../en/LC_MESSAGES/vrp_vroomShipmentsPlain.po | 892 ++++---- locale/pot/concepts.pot | 1820 ++++++++++++++++- locale/pot/release_notes.pot | 142 +- locale/pot/vroom-category.pot | 872 ++++---- locale/pot/vrp_multiple_knapsack.pot | 104 +- locale/pot/vrp_pgr_pickDeliver.pot | 605 +++--- locale/pot/vrp_pgr_pickDeliverEuclidean.pot | 590 +++--- locale/pot/vrp_vroom.pot | 1075 +++++----- locale/pot/vrp_vroomJobs.pot | 861 ++++---- locale/pot/vrp_vroomJobsPlain.pot | 873 ++++---- locale/pot/vrp_vroomPlain.pot | 1089 +++++----- locale/pot/vrp_vroomShipments.pot | 928 +++++---- locale/pot/vrp_vroomShipmentsPlain.pot | 944 +++++---- 24 files changed, 11129 insertions(+), 7991 deletions(-) diff --git a/locale/en/LC_MESSAGES/concepts.po b/locale/en/LC_MESSAGES/concepts.po index 5346b91b7..7226f227a 100644 --- a/locale/en/LC_MESSAGES/concepts.po +++ b/locale/en/LC_MESSAGES/concepts.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.0.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-09-28 10:43+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/concepts.rst:12 msgid "" @@ -48,134 +48,134 @@ msgid "" "generalises the travelling salesman problem (TSP)." msgstr "" -#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:28 msgid "The objective of the VRP is to minimize the total route cost." msgstr "" -#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:29 msgid "There are several variants of the VRP problem," msgstr "" -#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:31 msgid "**vrpRouting does not try to implement all variants.**" msgstr "" -#: ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:35 msgid "Characteristics" msgstr "" -#: ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:37 msgid "" "Capacitated Vehicle Routing Problem `CVRP` where The vehicles have " "limited carrying capacity of the goods." msgstr "" -#: ../../build/doc/concepts.rst:37 +#: ../../build/doc/concepts.rst:39 msgid "" "Vehicle Routing Problem with Time Windows `VRPTW` where the locations " "have time windows within which the vehicle's visits must be made." msgstr "" -#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:41 msgid "" "Vehicle Routing Problem with Pickup and Delivery `VRPPD` where a number " "of goods need to be moved from certain pickup locations to other delivery" " locations." msgstr "" -#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:47 msgid "Limitations" msgstr "" -#: ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:48 msgid "No multiple time windows for a location." msgstr "" -#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:49 msgid "Less vehicle used is considered better." msgstr "" -#: ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:50 msgid "Less total duration is better." msgstr "" -#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:51 msgid "Less wait time is better." msgstr "" -#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:55 msgid "Pick & Delivery" msgstr "" -#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:57 msgid "" "Problem: `CVRPPDTW` Capacitated Pick and Delivery Vehicle Routing problem" " with Time Windows" msgstr "" -#: ../../build/doc/concepts.rst:54 +#: ../../build/doc/concepts.rst:60 msgid "Times are relative to `0`" msgstr "" -#: ../../build/doc/concepts.rst:55 +#: ../../build/doc/concepts.rst:61 msgid "The vehicles" msgstr "" -#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:63 msgid "have start and ending service duration times." msgstr "" -#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:64 msgid "have opening and closing times for the start and ending locations." msgstr "" -#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:65 msgid "have a capacity." msgstr "" -#: ../../build/doc/concepts.rst:61 +#: ../../build/doc/concepts.rst:67 msgid "The orders" msgstr "" -#: ../../build/doc/concepts.rst:63 +#: ../../build/doc/concepts.rst:69 msgid "Have pick up and delivery locations." msgstr "" -#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:70 msgid "Have opening and closing times for the pickup and delivery locations." msgstr "" -#: ../../build/doc/concepts.rst:65 +#: ../../build/doc/concepts.rst:71 msgid "Have pickup and delivery duration service times." msgstr "" -#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:72 msgid "" "have a demand request for moving goods from the pickup location to the " "delivery location." msgstr "" -#: ../../build/doc/concepts.rst:68 +#: ../../build/doc/concepts.rst:75 msgid "Time based calculations:" msgstr "" -#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:77 msgid "Travel time between customers is :math:`distance / speed`" msgstr "" -#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:78 msgid "Pickup and delivery order pair is done by the same vehicle." msgstr "" -#: ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:79 msgid "A pickup is done before the delivery." msgstr "" -#: ../../build/doc/concepts.rst:81 +#: ../../build/doc/concepts.rst:84 msgid "Getting Started" msgstr "" -#: ../../build/doc/concepts.rst:83 +#: ../../build/doc/concepts.rst:86 msgid "" "This is a simple guide to walk you through the steps of getting started " "with vrpRouting. In this guide we will cover:" @@ -259,13 +259,13 @@ msgid "" " as the units used in the vehicle's `capacity`." msgstr "" -#: ../../build/doc/concepts.rst:135 +#: ../../build/doc/concepts.rst:136 msgid "" "To handle problems like: 10 (equal dimension) boxes of apples and 5 kg " "of feathers that are to be transported (not packed in boxes)." msgstr "" -#: ../../build/doc/concepts.rst:137 +#: ../../build/doc/concepts.rst:139 msgid "" "If the vehicle's `capacity` is measured by `boxes`, a conversion of `kg " "of feathers` to `equivalent number of boxes` is needed. If the vehicle's " @@ -273,231 +273,1651 @@ msgid "" "`equivalent number of kg` is needed." msgstr "" -#: ../../build/doc/concepts.rst:140 +#: ../../build/doc/concepts.rst:144 msgid "Showing how the 2 possible conversions can be done" msgstr "" -#: ../../build/doc/concepts.rst:142 +#: ../../build/doc/concepts.rst:146 msgid "" "Let: - :math:`f_boxes`: number of boxes that would be used for `1` kg of " "feathers. - :math:`a_weight`: weight of `1` box of apples." msgstr "" -#: ../../build/doc/concepts.rst:147 +#: ../../build/doc/concepts.rst:151 msgid "Capacity Units" msgstr "" -#: ../../build/doc/concepts.rst:147 +#: ../../build/doc/concepts.rst:151 msgid "apples" msgstr "" -#: ../../build/doc/concepts.rst:147 +#: ../../build/doc/concepts.rst:151 msgid "feathers" msgstr "" -#: ../../build/doc/concepts.rst:149 +#: ../../build/doc/concepts.rst:153 msgid "boxes" msgstr "" -#: ../../build/doc/concepts.rst:149 +#: ../../build/doc/concepts.rst:153 msgid "10" msgstr "" -#: ../../build/doc/concepts.rst:149 +#: ../../build/doc/concepts.rst:153 msgid ":math:`5 * f\\_boxes`" msgstr "" -#: ../../build/doc/concepts.rst:150 +#: ../../build/doc/concepts.rst:154 msgid "kg" msgstr "" -#: ../../build/doc/concepts.rst:150 +#: ../../build/doc/concepts.rst:154 msgid ":math:`10 * a\\_weight`" msgstr "" -#: ../../build/doc/concepts.rst:150 +#: ../../build/doc/concepts.rst:154 msgid "5" msgstr "" -#: ../../build/doc/concepts.rst:156 +#: ../../build/doc/concepts.rst:160 msgid "Locations" msgstr "" -#: ../../build/doc/concepts.rst:158 +#: ../../build/doc/concepts.rst:162 msgid "When using the Euclidean signatures:" msgstr "" -#: ../../build/doc/concepts.rst:160 +#: ../../build/doc/concepts.rst:164 msgid "The vehicles have :math:`(x, y)` pairs for start and ending locations." msgstr "" -#: ../../build/doc/concepts.rst:161 +#: ../../build/doc/concepts.rst:165 msgid "The orders Have :math:`(x, y)` pairs for pickup and delivery locations." msgstr "" -#: ../../build/doc/concepts.rst:163 +#: ../../build/doc/concepts.rst:167 msgid "When using a matrix:" msgstr "" -#: ../../build/doc/concepts.rst:165 +#: ../../build/doc/concepts.rst:169 msgid "The vehicles have identifiers for the start and ending locations." msgstr "" -#: ../../build/doc/concepts.rst:166 +#: ../../build/doc/concepts.rst:170 msgid "The orders have identifiers for the pickup and delivery locations." msgstr "" -#: ../../build/doc/concepts.rst:167 +#: ../../build/doc/concepts.rst:171 msgid "All the identifiers are indices to the given matrix." msgstr "" -#: ../../build/doc/concepts.rst:171 +#: ../../build/doc/concepts.rst:175 msgid "Time Handling" msgstr "" -#: ../../build/doc/concepts.rst:173 +#: ../../build/doc/concepts.rst:177 msgid "The times are relative to 0" msgstr "" -#: ../../build/doc/concepts.rst:175 +#: ../../build/doc/concepts.rst:179 msgid "" "Suppose that a vehicle's driver starts the shift at 9:00 am and ends the " "shift at 4:30 pm and the service time duration is 10 minutes with 30 " "seconds." msgstr "" -#: ../../build/doc/concepts.rst:178 +#: ../../build/doc/concepts.rst:182 msgid "All time units have to be converted" msgstr "" -#: ../../build/doc/concepts.rst:181 +#: ../../build/doc/concepts.rst:185 msgid "Meaning of 0" msgstr "" -#: ../../build/doc/concepts.rst:181 +#: ../../build/doc/concepts.rst:185 msgid "time units" msgstr "" -#: ../../build/doc/concepts.rst:181 ../../build/doc/concepts.rst:184 -#: ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:185 ../../build/doc/concepts.rst:188 +#: ../../build/doc/concepts.rst:190 msgid "9:00 am" msgstr "" -#: ../../build/doc/concepts.rst:181 +#: ../../build/doc/concepts.rst:185 msgid "4:30 pm" msgstr "" -#: ../../build/doc/concepts.rst:181 +#: ../../build/doc/concepts.rst:185 msgid "10 min 30 secs" msgstr "" -#: ../../build/doc/concepts.rst:183 ../../build/doc/concepts.rst:185 +#: ../../build/doc/concepts.rst:187 ../../build/doc/concepts.rst:189 msgid "0:00 am" msgstr "" -#: ../../build/doc/concepts.rst:183 ../../build/doc/concepts.rst:184 +#: ../../build/doc/concepts.rst:187 ../../build/doc/concepts.rst:188 msgid "hours" msgstr "" -#: ../../build/doc/concepts.rst:183 +#: ../../build/doc/concepts.rst:187 msgid "9" msgstr "" -#: ../../build/doc/concepts.rst:183 +#: ../../build/doc/concepts.rst:187 msgid "16.5" msgstr "" -#: ../../build/doc/concepts.rst:183 ../../build/doc/concepts.rst:184 +#: ../../build/doc/concepts.rst:187 ../../build/doc/concepts.rst:188 msgid ":math:`10.5 / 60 = 0.175`" msgstr "" -#: ../../build/doc/concepts.rst:184 ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:188 ../../build/doc/concepts.rst:190 +#: ../../build/doc/concepts.rst:292 ../../build/doc/concepts.rst:312 +#: ../../build/doc/concepts.rst:364 ../../build/doc/concepts.rst:386 +#: ../../build/doc/concepts.rst:434 ../../build/doc/concepts.rst:444 +#: ../../build/doc/concepts.rst:509 ../../build/doc/concepts.rst:519 msgid "0" msgstr "" -#: ../../build/doc/concepts.rst:184 +#: ../../build/doc/concepts.rst:188 msgid "7.5" msgstr "" -#: ../../build/doc/concepts.rst:185 ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:189 ../../build/doc/concepts.rst:190 msgid "minutes" msgstr "" -#: ../../build/doc/concepts.rst:185 +#: ../../build/doc/concepts.rst:189 msgid ":math:`9*60 = 54`" msgstr "" -#: ../../build/doc/concepts.rst:185 +#: ../../build/doc/concepts.rst:189 msgid ":math:`16.5*60 = 990`" msgstr "" -#: ../../build/doc/concepts.rst:185 ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:189 ../../build/doc/concepts.rst:190 msgid "10.5" msgstr "" -#: ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:190 msgid ":math:`7.5*60 = 540`" msgstr "" -#: ../../build/doc/concepts.rst:193 +#: ../../build/doc/concepts.rst:197 msgid "Factor Handling" msgstr "" -#: ../../build/doc/concepts.rst:197 ../../build/doc/concepts.rst:203 -#: ../../build/doc/concepts.rst:210 ../../build/doc/concepts.rst:216 -#: ../../build/doc/concepts.rst:222 +#: ../../build/doc/concepts.rst:201 ../../build/doc/concepts.rst:207 +#: ../../build/doc/concepts.rst:1270 msgid "TBD" msgstr "" -#: ../../build/doc/concepts.rst:201 +#: ../../build/doc/concepts.rst:205 msgid "Group of Functions" msgstr "" -#: ../../build/doc/concepts.rst:208 +#: ../../build/doc/concepts.rst:212 msgid "Inner Queries" msgstr "" -#: ../../build/doc/concepts.rst:214 -msgid "Return columns & values" +#: ../../build/doc/concepts.rst:215 +msgid "Pickup-Delivery Inner Queries" msgstr "" -#: ../../build/doc/concepts.rst:220 -msgid "Performance" +#: ../../build/doc/concepts.rst:218 +msgid "Matrix SQL" msgstr "" -#: ../../build/doc/concepts.rst:225 -msgid "How to contribute" +#: ../../build/doc/concepts.rst:222 ../../build/doc/concepts.rst:252 +#: ../../build/doc/concepts.rst:321 ../../build/doc/concepts.rst:398 +#: ../../build/doc/concepts.rst:473 ../../build/doc/concepts.rst:569 +#: ../../build/doc/concepts.rst:648 ../../build/doc/concepts.rst:741 +#: ../../build/doc/concepts.rst:843 ../../build/doc/concepts.rst:881 +#: ../../build/doc/concepts.rst:922 ../../build/doc/concepts.rst:958 +msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../build/doc/concepts.rst:228 -msgid "Wiki" +#: ../../build/doc/concepts.rst:224 +msgid "``start_vid, end_vid, agg_cost``" msgstr "" -#: ../../build/doc/concepts.rst:229 -msgid "" -"Edit an existing `vrpRouting Wiki " -"`_ page." +#: ../../build/doc/concepts.rst:230 ../../build/doc/concepts.rst:262 +#: ../../build/doc/concepts.rst:332 ../../build/doc/concepts.rst:408 +#: ../../build/doc/concepts.rst:483 ../../build/doc/concepts.rst:593 +#: ../../build/doc/concepts.rst:674 ../../build/doc/concepts.rst:761 +#: ../../build/doc/concepts.rst:853 ../../build/doc/concepts.rst:891 +#: ../../build/doc/concepts.rst:932 ../../build/doc/concepts.rst:967 +#: ../../build/doc/concepts.rst:1034 ../../build/doc/concepts.rst:1105 +#: ../../build/doc/concepts.rst:1177 +msgid "Column" +msgstr "" + +#: ../../build/doc/concepts.rst:231 ../../build/doc/concepts.rst:263 +#: ../../build/doc/concepts.rst:333 ../../build/doc/concepts.rst:409 +#: ../../build/doc/concepts.rst:484 ../../build/doc/concepts.rst:594 +#: ../../build/doc/concepts.rst:675 ../../build/doc/concepts.rst:762 +#: ../../build/doc/concepts.rst:854 ../../build/doc/concepts.rst:892 +#: ../../build/doc/concepts.rst:933 ../../build/doc/concepts.rst:968 +#: ../../build/doc/concepts.rst:1035 ../../build/doc/concepts.rst:1106 +#: ../../build/doc/concepts.rst:1178 +msgid "Type" +msgstr "" + +#: ../../build/doc/concepts.rst:232 ../../build/doc/concepts.rst:265 +#: ../../build/doc/concepts.rst:335 ../../build/doc/concepts.rst:411 +#: ../../build/doc/concepts.rst:486 ../../build/doc/concepts.rst:596 +#: ../../build/doc/concepts.rst:677 ../../build/doc/concepts.rst:764 +#: ../../build/doc/concepts.rst:856 ../../build/doc/concepts.rst:894 +#: ../../build/doc/concepts.rst:934 ../../build/doc/concepts.rst:969 +#: ../../build/doc/concepts.rst:1036 ../../build/doc/concepts.rst:1107 +#: ../../build/doc/concepts.rst:1179 +msgid "Description" msgstr "" #: ../../build/doc/concepts.rst:233 -msgid "Adding Functionaity to vrpRouting" +msgid "``start_vid``" +msgstr "" + +#: ../../build/doc/concepts.rst:234 ../../build/doc/concepts.rst:237 +#: ../../build/doc/concepts.rst:267 ../../build/doc/concepts.rst:275 +#: ../../build/doc/concepts.rst:281 ../../build/doc/concepts.rst:285 +#: ../../build/doc/concepts.rst:291 ../../build/doc/concepts.rst:295 +#: ../../build/doc/concepts.rst:301 ../../build/doc/concepts.rst:305 +#: ../../build/doc/concepts.rst:311 ../../build/doc/concepts.rst:337 +#: ../../build/doc/concepts.rst:353 ../../build/doc/concepts.rst:357 +#: ../../build/doc/concepts.rst:363 ../../build/doc/concepts.rst:375 +#: ../../build/doc/concepts.rst:379 ../../build/doc/concepts.rst:385 +#: ../../build/doc/concepts.rst:413 ../../build/doc/concepts.rst:417 +#: ../../build/doc/concepts.rst:427 ../../build/doc/concepts.rst:433 +#: ../../build/doc/concepts.rst:437 ../../build/doc/concepts.rst:443 +#: ../../build/doc/concepts.rst:447 ../../build/doc/concepts.rst:453 +#: ../../build/doc/concepts.rst:457 ../../build/doc/concepts.rst:463 +#: ../../build/doc/concepts.rst:488 ../../build/doc/concepts.rst:492 +#: ../../build/doc/concepts.rst:508 ../../build/doc/concepts.rst:512 +#: ../../build/doc/concepts.rst:518 ../../build/doc/concepts.rst:530 +#: ../../build/doc/concepts.rst:534 ../../build/doc/concepts.rst:540 +#: ../../build/doc/concepts.rst:598 ../../build/doc/concepts.rst:602 +#: ../../build/doc/concepts.rst:679 ../../build/doc/concepts.rst:683 +#: ../../build/doc/concepts.rst:699 ../../build/doc/concepts.rst:766 +#: ../../build/doc/concepts.rst:770 ../../build/doc/concepts.rst:774 +#: ../../build/doc/concepts.rst:858 ../../build/doc/concepts.rst:862 +#: ../../build/doc/concepts.rst:896 ../../build/doc/concepts.rst:900 +#: ../../build/doc/concepts.rst:936 ../../build/doc/concepts.rst:971 +msgid "|ANY-INTEGER|" +msgstr "" + +#: ../../build/doc/concepts.rst:235 ../../build/doc/concepts.rst:238 +msgid "Identifier of a node." +msgstr "" + +#: ../../build/doc/concepts.rst:236 +msgid "``end_vid``" +msgstr "" + +#: ../../build/doc/concepts.rst:239 +msgid "``agg_cost``" +msgstr "" + +#: ../../build/doc/concepts.rst:240 ../../build/doc/concepts.rst:271 +#: ../../build/doc/concepts.rst:341 ../../build/doc/concepts.rst:345 +#: ../../build/doc/concepts.rst:349 ../../build/doc/concepts.rst:367 +#: ../../build/doc/concepts.rst:371 ../../build/doc/concepts.rst:423 +#: ../../build/doc/concepts.rst:496 ../../build/doc/concepts.rst:500 +#: ../../build/doc/concepts.rst:504 ../../build/doc/concepts.rst:522 +#: ../../build/doc/concepts.rst:526 ../../build/doc/concepts.rst:802 +msgid "|ANY-NUMERICAL|" +msgstr "" + +#: ../../build/doc/concepts.rst:241 +msgid "Cost to travel from ``start_vid`` to ``end_vid``" +msgstr "" + +#: ../../build/doc/concepts.rst:246 +msgid "Orders SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:249 +msgid "Orders" +msgstr "" + +#: ../../build/doc/concepts.rst:254 ../../build/doc/concepts.rst:323 +msgid "``id, amount``" +msgstr "" + +#: ../../build/doc/concepts.rst:255 +msgid "``p_id, p_tw_open, p_tw_close, [p_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:256 +msgid "``d_id, d_tw_open, d_tw_close, [d_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:264 ../../build/doc/concepts.rst:334 +#: ../../build/doc/concepts.rst:410 ../../build/doc/concepts.rst:485 +#: ../../build/doc/concepts.rst:595 ../../build/doc/concepts.rst:676 +#: ../../build/doc/concepts.rst:763 ../../build/doc/concepts.rst:855 +#: ../../build/doc/concepts.rst:893 +msgid "Default" +msgstr "" + +#: ../../build/doc/concepts.rst:266 ../../build/doc/concepts.rst:336 +#: ../../build/doc/concepts.rst:412 ../../build/doc/concepts.rst:487 +#: ../../build/doc/concepts.rst:597 ../../build/doc/concepts.rst:650 +#: ../../build/doc/concepts.rst:678 ../../build/doc/concepts.rst:765 +#: ../../build/doc/concepts.rst:895 ../../build/doc/concepts.rst:935 +#: ../../build/doc/concepts.rst:970 +msgid "``id``" +msgstr "" + +#: ../../build/doc/concepts.rst:269 ../../build/doc/concepts.rst:339 +msgid "Identifier of the pick-delivery order pair." +msgstr "" + +#: ../../build/doc/concepts.rst:270 ../../build/doc/concepts.rst:340 +#: ../../build/doc/concepts.rst:714 +msgid "``amount``" +msgstr "" + +#: ../../build/doc/concepts.rst:273 ../../build/doc/concepts.rst:343 +msgid "Number of units in the order." +msgstr "" + +#: ../../build/doc/concepts.rst:274 +msgid "``p_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:277 +msgid "Identifier of the pickup node." +msgstr "" + +#: ../../build/doc/concepts.rst:279 ../../build/doc/concepts.rst:299 +#: ../../build/doc/concepts.rst:431 ../../build/doc/concepts.rst:451 +msgid "Must match a node identifier in the `Matrix SQL`_." +msgstr "" + +#: ../../build/doc/concepts.rst:280 ../../build/doc/concepts.rst:352 +msgid "``p_tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:283 ../../build/doc/concepts.rst:355 +msgid "The time, relative to 0, when the pickup location opens." +msgstr "" + +#: ../../build/doc/concepts.rst:284 ../../build/doc/concepts.rst:356 +msgid "``p_tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:287 ../../build/doc/concepts.rst:359 +msgid "The time, relative to 0, when the pickup location closes." +msgstr "" + +#: ../../build/doc/concepts.rst:289 ../../build/doc/concepts.rst:361 +msgid ":math:`p\\_tw\\_open < p\\_tw\\_close < 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:290 ../../build/doc/concepts.rst:362 +#: ../../build/doc/concepts.rst:690 +msgid "``p_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:293 ../../build/doc/concepts.rst:365 +msgid "The duration of the loading at the pickup location." +msgstr "" + +#: ../../build/doc/concepts.rst:294 +msgid "``d_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:297 +msgid "Identifier of the delivery node." +msgstr "" + +#: ../../build/doc/concepts.rst:300 ../../build/doc/concepts.rst:374 +msgid "``d_tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:303 ../../build/doc/concepts.rst:377 +msgid "The time, relative to 0, when the delivery location opens." +msgstr "" + +#: ../../build/doc/concepts.rst:304 ../../build/doc/concepts.rst:378 +msgid "``d_tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:307 ../../build/doc/concepts.rst:381 +msgid "The time, relative to 0, when the delivery location closes." +msgstr "" + +#: ../../build/doc/concepts.rst:309 ../../build/doc/concepts.rst:383 +msgid ":math:`d\\_tw\\_open < d\\_tw\\_close <= 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:310 ../../build/doc/concepts.rst:384 +#: ../../build/doc/concepts.rst:706 +msgid "``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:313 ../../build/doc/concepts.rst:387 +msgid "The duration of the unloading at the delivery location." +msgstr "" + +#: ../../build/doc/concepts.rst:318 +msgid "Euclidean Orders" +msgstr "" + +#: ../../build/doc/concepts.rst:324 +msgid "``p_x, p_y, p_tw_open, p_tw_close, [p_service,]``" +msgstr "" + +#: ../../build/doc/concepts.rst:325 +msgid "``d_x, d_y, d_tw_open, d_tw_close, [d_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:344 +msgid "``p_x``" +msgstr "" + +#: ../../build/doc/concepts.rst:347 +msgid ":math:`x` value of the pickup location." +msgstr "" + +#: ../../build/doc/concepts.rst:348 +msgid "``p_y``" +msgstr "" + +#: ../../build/doc/concepts.rst:351 +msgid ":math:`y` value of the pickup location." +msgstr "" + +#: ../../build/doc/concepts.rst:366 +msgid "``d_x``" +msgstr "" + +#: ../../build/doc/concepts.rst:369 +msgid ":math:`x` value of the delivery location." +msgstr "" + +#: ../../build/doc/concepts.rst:370 +msgid "``d_y``" +msgstr "" + +#: ../../build/doc/concepts.rst:373 +msgid ":math:`y` value of the delivery location." +msgstr "" + +#: ../../build/doc/concepts.rst:392 ../../build/doc/concepts.rst:737 +msgid "Vehicles SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:395 +msgid "Vehicles" +msgstr "" + +#: ../../build/doc/concepts.rst:400 ../../build/doc/concepts.rst:475 +msgid "``id, capacity, [speed,]``" +msgstr "" + +#: ../../build/doc/concepts.rst:401 +msgid "``s_id, [s_tw_open, s_tw_close, s_service,]``" +msgstr "" + +#: ../../build/doc/concepts.rst:402 +msgid "``[e_id, e_tw_open, e_tw_close, e_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:415 +msgid "Identifier of the vehicle" +msgstr "" + +#: ../../build/doc/concepts.rst:416 ../../build/doc/concepts.rst:491 +#: ../../build/doc/concepts.rst:777 +msgid "``capacity``" +msgstr "" + +#: ../../build/doc/concepts.rst:419 +msgid "Capacity of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:421 +msgid ":math:`0 < capacity <= 4294967295`." +msgstr "" + +#: ../../build/doc/concepts.rst:422 ../../build/doc/concepts.rst:495 +msgid "``speed``" +msgstr "" + +#: ../../build/doc/concepts.rst:424 ../../build/doc/concepts.rst:497 +msgid "1" +msgstr "" + +#: ../../build/doc/concepts.rst:425 ../../build/doc/concepts.rst:498 +msgid "Speed of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:426 ../../build/doc/concepts.rst:448 +msgid "``s_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:429 +msgid "The node identifier of the starting location." +msgstr "" + +#: ../../build/doc/concepts.rst:432 ../../build/doc/concepts.rst:454 +#: ../../build/doc/concepts.rst:507 ../../build/doc/concepts.rst:531 +msgid "``s_tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:435 ../../build/doc/concepts.rst:510 +msgid "The time, relative to 0, when the starting location opens." +msgstr "" + +#: ../../build/doc/concepts.rst:436 ../../build/doc/concepts.rst:458 +#: ../../build/doc/concepts.rst:511 ../../build/doc/concepts.rst:535 +msgid "``s_tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:438 ../../build/doc/concepts.rst:513 +msgid "|MAX-BIGINT|" +msgstr "" + +#: ../../build/doc/concepts.rst:439 ../../build/doc/concepts.rst:514 +msgid "The time, relative to 0, when the starting location closes." +msgstr "" + +#: ../../build/doc/concepts.rst:441 ../../build/doc/concepts.rst:516 +msgid ":math:`s\\_tw\\_open < s\\_tw\\_close <= 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:442 ../../build/doc/concepts.rst:464 +#: ../../build/doc/concepts.rst:517 ../../build/doc/concepts.rst:541 +msgid "``s_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:445 +msgid "Duration of any task at the starting location," +msgstr "" + +#: ../../build/doc/concepts.rst:446 +msgid "``e_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:449 +msgid "The node identifier of the ending location." +msgstr "" + +#: ../../build/doc/concepts.rst:452 ../../build/doc/concepts.rst:529 +msgid "``e_tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:455 ../../build/doc/concepts.rst:532 +msgid "The time, relative to 0, when the ending location opens." +msgstr "" + +#: ../../build/doc/concepts.rst:456 ../../build/doc/concepts.rst:533 +msgid "``e_tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:459 ../../build/doc/concepts.rst:536 +msgid "The time, relative to 0, when the ending location closes." +msgstr "" + +#: ../../build/doc/concepts.rst:461 ../../build/doc/concepts.rst:538 +msgid ":math:`e\\_tw\\_open < e\\_tw\\_close <= 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:462 ../../build/doc/concepts.rst:539 +msgid "``e_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:465 ../../build/doc/concepts.rst:542 +msgid "The duration of any task at the ending location" +msgstr "" + +#: ../../build/doc/concepts.rst:470 +msgid "Euclidean Vehicles" +msgstr "" + +#: ../../build/doc/concepts.rst:476 +msgid "``s_x, s_y, [s_tw_open, s_tw_close, s_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:477 +msgid "``[e_x, e_y, e_tw_open, e_tw_close, e_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:490 +msgid "Identifier of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:494 +msgid "Capacity of the vehicle. :math:`0 < capacity <= 4294967295`." +msgstr "" + +#: ../../build/doc/concepts.rst:499 +msgid "``s_x``" +msgstr "" + +#: ../../build/doc/concepts.rst:502 +msgid ":math:`x` value of the coordinate of the starting location." +msgstr "" + +#: ../../build/doc/concepts.rst:503 +msgid "``s_y``" +msgstr "" + +#: ../../build/doc/concepts.rst:506 +msgid ":math:`y` value of the coordinate of the starting location." +msgstr "" + +#: ../../build/doc/concepts.rst:520 +msgid "Duration of any task at the ending location," +msgstr "" + +#: ../../build/doc/concepts.rst:521 +msgid "``e_x``" +msgstr "" + +#: ../../build/doc/concepts.rst:524 +msgid ":math:`x` value of the coordinate of the ending location." +msgstr "" + +#: ../../build/doc/concepts.rst:525 +msgid "``e_y``" +msgstr "" + +#: ../../build/doc/concepts.rst:528 +msgid ":math:`y` value of the coordinate of the ending location." +msgstr "" + +#: ../../build/doc/concepts.rst:547 +msgid "Vroom Inner Queries" msgstr "" -#: ../../build/doc/concepts.rst:234 +#: ../../build/doc/concepts.rst:549 msgid "" -"Consult the `developer's documentation " -"`_" +"Vroom, because of the data types used internally, some maximum values " +"apply." msgstr "" -#: ../../build/doc/concepts.rst:238 -msgid "Indices and tables" +#: ../../build/doc/concepts.rst:551 +msgid "For ``TIMESTAMP``:" msgstr "" -#: ../../build/doc/concepts.rst:239 +#: ../../build/doc/concepts.rst:557 +msgid "For ``INTERVAL``:" +msgstr "" + +#: ../../build/doc/concepts.rst:565 +msgid "Jobs SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:571 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:572 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:574 ../../build/doc/concepts.rst:655 +#: ../../build/doc/concepts.rst:746 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:576 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:578 ../../build/doc/concepts.rst:659 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:580 ../../build/doc/concepts.rst:628 +#: ../../build/doc/concepts.rst:661 ../../build/doc/concepts.rst:723 +#: ../../build/doc/concepts.rst:748 ../../build/doc/concepts.rst:785 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:582 ../../build/doc/concepts.rst:663 +#: ../../build/doc/concepts.rst:750 ../../build/doc/concepts.rst:810 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:584 ../../build/doc/concepts.rst:632 +#: ../../build/doc/concepts.rst:665 ../../build/doc/concepts.rst:729 +#: ../../build/doc/concepts.rst:752 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:586 ../../build/doc/concepts.rst:667 +#: ../../build/doc/concepts.rst:754 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:600 +msgid "Positive unique identifier of the job." +msgstr "" + +#: ../../build/doc/concepts.rst:601 ../../build/doc/concepts.rst:1220 +msgid "``location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:604 +msgid "Positive unique identifier of the location of the job." +msgstr "" + +#: ../../build/doc/concepts.rst:605 +msgid "``setup``" +msgstr "" + +#: ../../build/doc/concepts.rst:606 ../../build/doc/concepts.rst:611 +#: ../../build/doc/concepts.rst:687 ../../build/doc/concepts.rst:691 +#: ../../build/doc/concepts.rst:703 ../../build/doc/concepts.rst:707 +#: ../../build/doc/concepts.rst:866 ../../build/doc/concepts.rst:870 +#: ../../build/doc/concepts.rst:904 ../../build/doc/concepts.rst:1232 +#: ../../build/doc/concepts.rst:1237 ../../build/doc/concepts.rst:1240 +#: ../../build/doc/concepts.rst:1243 +msgid "|interval|" +msgstr "" + +#: ../../build/doc/concepts.rst:607 ../../build/doc/concepts.rst:612 +#: ../../build/doc/concepts.rst:688 ../../build/doc/concepts.rst:692 +#: ../../build/doc/concepts.rst:704 ../../build/doc/concepts.rst:708 +#: ../../build/doc/concepts.rst:905 +msgid "|interval0|" +msgstr "" + +#: ../../build/doc/concepts.rst:608 +msgid "The Job setup duration." +msgstr "" + +#: ../../build/doc/concepts.rst:610 ../../build/doc/concepts.rst:903 +msgid "``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:613 +msgid "The Job service duration. Max value:" +msgstr "" + +#: ../../build/doc/concepts.rst:614 +msgid "``pickup``" +msgstr "" + +#: ../../build/doc/concepts.rst:615 ../../build/doc/concepts.rst:622 +#: ../../build/doc/concepts.rst:629 ../../build/doc/concepts.rst:715 +#: ../../build/doc/concepts.rst:724 ../../build/doc/concepts.rst:778 +#: ../../build/doc/concepts.rst:786 +msgid "``ARRAY[ANY-INTEGER]``" +msgstr "" + +#: ../../build/doc/concepts.rst:616 ../../build/doc/concepts.rst:623 +#: ../../build/doc/concepts.rst:630 ../../build/doc/concepts.rst:716 +#: ../../build/doc/concepts.rst:725 ../../build/doc/concepts.rst:779 +#: ../../build/doc/concepts.rst:787 +msgid "``[]``" +msgstr "" + +#: ../../build/doc/concepts.rst:617 +msgid "" +"Array of non-negative integers describing multidimensional quantities for" +" pickup such as number of items, weight, volume etc." +msgstr "" + +#: ../../build/doc/concepts.rst:620 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:621 +msgid "``delivery``" +msgstr "" + +#: ../../build/doc/concepts.rst:624 +msgid "" +"Array of non-negative integers describing multidimensional quantities for" +" delivery such as number of items, weight, volume etc." +msgstr "" + +#: ../../build/doc/concepts.rst:627 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:631 ../../build/doc/concepts.rst:726 +#: ../../build/doc/concepts.rst:788 +msgid "Array of non-negative integers defining mandatory skills." +msgstr "" + +#: ../../build/doc/concepts.rst:633 ../../build/doc/concepts.rst:730 +#: ../../build/doc/concepts.rst:809 ../../build/doc/concepts.rst:1038 +#: ../../build/doc/concepts.rst:1041 ../../build/doc/concepts.rst:1048 +#: ../../build/doc/concepts.rst:1052 ../../build/doc/concepts.rst:1109 +#: ../../build/doc/concepts.rst:1112 ../../build/doc/concepts.rst:1119 +#: ../../build/doc/concepts.rst:1123 +msgid "``INTEGER``" +msgstr "" + +#: ../../build/doc/concepts.rst:634 ../../build/doc/concepts.rst:731 +msgid ":math:`0`" +msgstr "" + +#: ../../build/doc/concepts.rst:635 ../../build/doc/concepts.rst:732 +msgid "Value range: :math:`[0, 100]`" +msgstr "" + +#: ../../build/doc/concepts.rst:636 ../../build/doc/concepts.rst:814 +#: ../../build/doc/concepts.rst:907 +msgid "``data``" +msgstr "" + +#: ../../build/doc/concepts.rst:637 ../../build/doc/concepts.rst:695 +#: ../../build/doc/concepts.rst:711 ../../build/doc/concepts.rst:815 +#: ../../build/doc/concepts.rst:908 ../../build/doc/concepts.rst:1194 +#: ../../build/doc/concepts.rst:1226 +msgid "``JSONB``" +msgstr "" + +#: ../../build/doc/concepts.rst:638 ../../build/doc/concepts.rst:696 +#: ../../build/doc/concepts.rst:712 ../../build/doc/concepts.rst:816 +#: ../../build/doc/concepts.rst:909 +msgid "``'{}'::JSONB``" +msgstr "" + +#: ../../build/doc/concepts.rst:639 +msgid "Any metadata information of the job." +msgstr "" + +#: ../../build/doc/concepts.rst:644 +msgid "Shipments SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:651 +msgid "``p_location_id, [p_setup, p_service, p_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:652 +msgid "``d_location_id, [d_setup, d_service, d_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:653 +msgid "``[amount, skills, priority]``" +msgstr "" + +#: ../../build/doc/concepts.rst:657 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:681 +msgid "Positive unique identifier of the shipment." +msgstr "" + +#: ../../build/doc/concepts.rst:682 +msgid "``p_location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:685 ../../build/doc/concepts.rst:701 +msgid "Positive unique identifier of the pickup location." +msgstr "" + +#: ../../build/doc/concepts.rst:686 +msgid "``p_setup``" +msgstr "" + +#: ../../build/doc/concepts.rst:689 ../../build/doc/concepts.rst:705 +msgid "The pickup setup duration" +msgstr "" + +#: ../../build/doc/concepts.rst:693 ../../build/doc/concepts.rst:709 +msgid "The pickup service duration" +msgstr "" + +#: ../../build/doc/concepts.rst:694 +msgid "``p_data``" +msgstr "" + +#: ../../build/doc/concepts.rst:697 +msgid "Any metadata information of the pickup." +msgstr "" + +#: ../../build/doc/concepts.rst:698 +msgid "``d_location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:702 +msgid "``d_setup``" +msgstr "" + +#: ../../build/doc/concepts.rst:710 +msgid "``d_data``" +msgstr "" + +#: ../../build/doc/concepts.rst:713 +msgid "Any metadata information of the delivery." +msgstr "" + +#: ../../build/doc/concepts.rst:717 ../../build/doc/concepts.rst:780 +msgid "" +"Array of non-negative integers describing multidimensional quantities " +"such as number of items, weight, volume etc." +msgstr "" + +#: ../../build/doc/concepts.rst:720 +msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:728 +msgid ":math:`values \\leq 2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:743 +msgid "``id, start_id, end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:744 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:768 ../../build/doc/concepts.rst:902 +msgid "Positive unique identifier of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:769 ../../build/doc/concepts.rst:857 +msgid "``start_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:772 +msgid "Positive unique identifier of the start location." +msgstr "" + +#: ../../build/doc/concepts.rst:773 ../../build/doc/concepts.rst:861 +msgid "``end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:776 +msgid "Positive unique identifier of the end location." +msgstr "" + +#: ../../build/doc/concepts.rst:783 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:789 ../../build/doc/concepts.rst:939 +#: ../../build/doc/concepts.rst:974 +msgid "``tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:790 ../../build/doc/concepts.rst:796 +#: ../../build/doc/concepts.rst:940 ../../build/doc/concepts.rst:943 +#: ../../build/doc/concepts.rst:975 ../../build/doc/concepts.rst:978 +#: ../../build/doc/concepts.rst:1229 ../../build/doc/concepts.rst:1246 +msgid "|timestamp|" +msgstr "" + +#: ../../build/doc/concepts.rst:791 +msgid "|tw_open_default|" +msgstr "" + +#: ../../build/doc/concepts.rst:792 ../../build/doc/concepts.rst:941 +#: ../../build/doc/concepts.rst:976 +msgid "Time window opening time." +msgstr "" + +#: ../../build/doc/concepts.rst:794 ../../build/doc/concepts.rst:800 +msgid ":code:`tw_open \\leq tw_close`" +msgstr "" + +#: ../../build/doc/concepts.rst:795 ../../build/doc/concepts.rst:942 +#: ../../build/doc/concepts.rst:977 +msgid "``tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:797 +msgid "|tw_close_default|" +msgstr "" + +#: ../../build/doc/concepts.rst:798 ../../build/doc/concepts.rst:944 +#: ../../build/doc/concepts.rst:979 +msgid "Time window closing time." +msgstr "" + +#: ../../build/doc/concepts.rst:801 +msgid "``speed_factor``" +msgstr "" + +#: ../../build/doc/concepts.rst:803 +msgid ":math:`1.0`" +msgstr "" + +#: ../../build/doc/concepts.rst:804 +msgid "Vehicle travel time multiplier." +msgstr "" + +#: ../../build/doc/concepts.rst:806 +msgid "" +"Max value of speed factor for a vehicle shall not be greater than 5 times" +" the speed factor of any other vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:808 +msgid "``max_tasks``" +msgstr "" + +#: ../../build/doc/concepts.rst:811 +msgid "Maximum number of tasks in a route for the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:813 +msgid "A job, pickup, or delivery is counted as a single task." +msgstr "" + +#: ../../build/doc/concepts.rst:817 +msgid "Any metadata information of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:819 ../../build/doc/concepts.rst:985 +#: ../../build/doc/concepts.rst:1254 +msgid "**Note**:" +msgstr "" + +#: ../../build/doc/concepts.rst:821 +msgid "At least one of the ``start_id`` or ``end_id`` shall be present." +msgstr "" + +#: ../../build/doc/concepts.rst:822 +msgid "" +"If ``end_id`` is omitted, the resulting route will stop at the last " +"visited task, whose choice is determined by the optimization process." +msgstr "" + +#: ../../build/doc/concepts.rst:824 +msgid "" +"If ``start_id`` is omitted, the resulting route will start at the first " +"visited task, whose choice is determined by the optimization process." +msgstr "" + +#: ../../build/doc/concepts.rst:826 +msgid "" +"To request a round trip, specify both ``start_id`` and ``end_id`` as the " +"same index." +msgstr "" + +#: ../../build/doc/concepts.rst:828 +msgid "" +"A vehicle is only allowed to serve a set of tasks if the resulting load " +"at each route step is lower than the matching value in capacity for each " +"metric. When using multiple components for amounts, it is recommended to " +"put the most important/limiting metrics first." +msgstr "" + +#: ../../build/doc/concepts.rst:832 +msgid "" +"It is assumed that all delivery-related amounts for jobs are loaded at " +"vehicle start, while all pickup-related amounts for jobs are brought back" +" at vehicle end." +msgstr "" + +#: ../../build/doc/concepts.rst:839 +msgid "Vroom Matrix SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:845 +msgid "``start_id, end_id, duration``" +msgstr "" + +#: ../../build/doc/concepts.rst:846 +msgid "``[ cost]``" +msgstr "" + +#: ../../build/doc/concepts.rst:860 +msgid "Identifier of the start node." +msgstr "" + +#: ../../build/doc/concepts.rst:864 +msgid "Identifier of the end node." +msgstr "" + +#: ../../build/doc/concepts.rst:865 ../../build/doc/concepts.rst:871 +msgid "``duration``" +msgstr "" + +#: ../../build/doc/concepts.rst:868 +msgid "Time to travel from ``start_id`` to ``end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:869 +msgid "``cost``" +msgstr "" + +#: ../../build/doc/concepts.rst:872 +msgid "Cost of travel from ``start_id`` to ``end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:877 +msgid "Breaks SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:883 +msgid "``id, vehicle_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:884 +msgid "``[service, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:898 +msgid "Positive unique identifier of the break. Unique for the same vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:899 ../../build/doc/concepts.rst:1044 +#: ../../build/doc/concepts.rst:1115 ../../build/doc/concepts.rst:1187 +msgid "``vehicle_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:906 +msgid "The break duration" +msgstr "" + +#: ../../build/doc/concepts.rst:910 +msgid "Any metadata information of the break." +msgstr "" + +#: ../../build/doc/concepts.rst:916 +msgid "Time Windows SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:919 +msgid "Shipment Time Windows SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:924 ../../build/doc/concepts.rst:960 +msgid "``id, tw_open, tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:925 +msgid "``[kind]``" +msgstr "" + +#: ../../build/doc/concepts.rst:937 ../../build/doc/concepts.rst:972 +msgid "" +"Positive unique identifier of the: job, pickup/delivery shipment, or " +"break." +msgstr "" + +#: ../../build/doc/concepts.rst:945 +msgid "``kind``" +msgstr "" + +#: ../../build/doc/concepts.rst:946 +msgid "``CHAR``" +msgstr "" + +#: ../../build/doc/concepts.rst:947 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" +msgstr "" + +#: ../../build/doc/concepts.rst:949 +msgid "Pickup shipment, or" +msgstr "" + +#: ../../build/doc/concepts.rst:950 +msgid "Delivery shipment." +msgstr "" + +#: ../../build/doc/concepts.rst:955 +msgid "General Time Windows SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:987 +msgid "All timings are in **seconds** when represented as an ``INTEGER``." +msgstr "" + +#: ../../build/doc/concepts.rst:988 +msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +msgstr "" + +#: ../../build/doc/concepts.rst:989 +msgid "Time windows can be interpreted by the users:" +msgstr "" + +#: ../../build/doc/concepts.rst:991 +msgid "**Relative values**, e.g." +msgstr "" + +#: ../../build/doc/concepts.rst:993 +msgid "Let the beginning of the planning horizon :math:`0`." +msgstr "" + +#: ../../build/doc/concepts.rst:994 +msgid "" +"for a 4 hour time window (:math:`4 * 3600 = 14400` seconds) starting from" +" the planning horizon" +msgstr "" + +#: ../../build/doc/concepts.rst:997 +msgid "``tw_open`` = :math:`0`" +msgstr "" + +#: ../../build/doc/concepts.rst:998 +msgid "``tw_close`` = :math:`14400`" +msgstr "" + +#: ../../build/doc/concepts.rst:1000 +msgid "Times reported in output relative to the start of the planning horizon." +msgstr "" + +#: ../../build/doc/concepts.rst:1002 +msgid "**Absolute values**," +msgstr "" + +#: ../../build/doc/concepts.rst:1004 +msgid "Let the beginning of the planning horizon ``2019-07-30 08:00:00``" +msgstr "" + +#: ../../build/doc/concepts.rst:1005 +msgid "for a 4 hour time window starting from the planning horizon" +msgstr "" + +#: ../../build/doc/concepts.rst:1007 +msgid "``tw_open`` = ``2019-07-30 08:00:00``" +msgstr "" + +#: ../../build/doc/concepts.rst:1008 +msgid "``tw_close`` = ``2019-07-30 12:00:00``" +msgstr "" + +#: ../../build/doc/concepts.rst:1010 +msgid "Times reported in output can be interpreted as ``TIMESTAMP``." +msgstr "" + +#: ../../build/doc/concepts.rst:1016 +msgid "Return columns & values" +msgstr "" + +#: ../../build/doc/concepts.rst:1019 +msgid "Pick-Deliver result columns" +msgstr "" + +#: ../../build/doc/concepts.rst:1022 +msgid "Results" +msgstr "" + +#: ../../build/doc/concepts.rst:1025 ../../build/doc/concepts.rst:1096 +#: ../../build/doc/concepts.rst:1165 +msgid "Returns set of" +msgstr "" + +#: ../../build/doc/concepts.rst:1027 +msgid "" +"``seq, vehicle_number, vehicle_id, stop_seq, stop_type, stop_id, " +"order_id, cargo,``" +msgstr "" + +#: ../../build/doc/concepts.rst:1028 ../../build/doc/concepts.rst:1099 +msgid "``travel_time, arrival_time, wait_time, service_time, departure_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1037 ../../build/doc/concepts.rst:1108 +#: ../../build/doc/concepts.rst:1180 +msgid "``seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:1039 ../../build/doc/concepts.rst:1110 +#: ../../build/doc/concepts.rst:1182 +msgid "Sequential value starting from **1**." +msgstr "" + +#: ../../build/doc/concepts.rst:1040 ../../build/doc/concepts.rst:1111 +#: ../../build/doc/concepts.rst:1183 +msgid "``vehicle_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:1042 ../../build/doc/concepts.rst:1113 +msgid "" +"Sequential value starting from **1** for current vehicles. The " +":math:`n_{th}` vehicle in the solution." +msgstr "" + +#: ../../build/doc/concepts.rst:1045 ../../build/doc/concepts.rst:1060 +#: ../../build/doc/concepts.rst:1063 ../../build/doc/concepts.rst:1068 +#: ../../build/doc/concepts.rst:1071 ../../build/doc/concepts.rst:1076 +#: ../../build/doc/concepts.rst:1079 ../../build/doc/concepts.rst:1082 +#: ../../build/doc/concepts.rst:1085 ../../build/doc/concepts.rst:1116 +#: ../../build/doc/concepts.rst:1131 ../../build/doc/concepts.rst:1136 +#: ../../build/doc/concepts.rst:1139 ../../build/doc/concepts.rst:1144 +#: ../../build/doc/concepts.rst:1147 ../../build/doc/concepts.rst:1150 +#: ../../build/doc/concepts.rst:1153 ../../build/doc/concepts.rst:1181 +#: ../../build/doc/concepts.rst:1184 ../../build/doc/concepts.rst:1188 +#: ../../build/doc/concepts.rst:1197 ../../build/doc/concepts.rst:1203 +#: ../../build/doc/concepts.rst:1215 ../../build/doc/concepts.rst:1221 +#: ../../build/doc/concepts.rst:1251 +msgid "``BIGINT``" +msgstr "" + +#: ../../build/doc/concepts.rst:1046 ../../build/doc/concepts.rst:1117 +#: ../../build/doc/concepts.rst:1189 +msgid "Current vehicle identifier." +msgstr "" + +#: ../../build/doc/concepts.rst:1047 ../../build/doc/concepts.rst:1118 +msgid "``stop_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:1049 ../../build/doc/concepts.rst:1120 +msgid "" +"Sequential value starting from **1** for the stops made by the current " +"vehicle. The :math:`m_{th}` stop of the current vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:1051 ../../build/doc/concepts.rst:1122 +msgid "``stop_type``" +msgstr "" + +#: ../../build/doc/concepts.rst:1053 ../../build/doc/concepts.rst:1124 +msgid "Kind of stop location the vehicle is at:" +msgstr "" + +#: ../../build/doc/concepts.rst:1055 ../../build/doc/concepts.rst:1126 +#: ../../build/doc/concepts.rst:1207 +msgid "``1``: Starting location" +msgstr "" + +#: ../../build/doc/concepts.rst:1056 ../../build/doc/concepts.rst:1127 +msgid "``2``: Pickup location" +msgstr "" + +#: ../../build/doc/concepts.rst:1057 ../../build/doc/concepts.rst:1128 +msgid "``3``: Delivery location" +msgstr "" + +#: ../../build/doc/concepts.rst:1058 ../../build/doc/concepts.rst:1129 +#: ../../build/doc/concepts.rst:1212 +msgid "``6``: Ending location" +msgstr "" + +#: ../../build/doc/concepts.rst:1059 +msgid "``stop_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:1061 +msgid "Identifier of the stop." +msgstr "" + +#: ../../build/doc/concepts.rst:1062 ../../build/doc/concepts.rst:1130 +msgid "``order_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:1064 ../../build/doc/concepts.rst:1132 +msgid "Pickup-Delivery order pair identifier." +msgstr "" + +#: ../../build/doc/concepts.rst:1066 ../../build/doc/concepts.rst:1134 +msgid "``-1``: When no order is involved on the current stop location." +msgstr "" + +#: ../../build/doc/concepts.rst:1067 ../../build/doc/concepts.rst:1135 +msgid "``cargo``" +msgstr "" + +#: ../../build/doc/concepts.rst:1069 ../../build/doc/concepts.rst:1137 +msgid "Cargo units of the vehicle when leaving the stop." +msgstr "" + +#: ../../build/doc/concepts.rst:1070 ../../build/doc/concepts.rst:1138 +#: ../../build/doc/concepts.rst:1231 +msgid "``travel_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1072 ../../build/doc/concepts.rst:1140 +msgid "Travel time from previous ``stop_seq`` to current ``stop_seq``." +msgstr "" + +#: ../../build/doc/concepts.rst:1074 ../../build/doc/concepts.rst:1142 +msgid "``0`` When ``stop_type = 1``" +msgstr "" + +#: ../../build/doc/concepts.rst:1075 ../../build/doc/concepts.rst:1143 +msgid "``arrival_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1077 ../../build/doc/concepts.rst:1145 +msgid "Previous ``departure_time`` plus current ``travel_time``." +msgstr "" + +#: ../../build/doc/concepts.rst:1078 ../../build/doc/concepts.rst:1146 +msgid "``wait_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1080 ../../build/doc/concepts.rst:1148 +msgid "Time spent waiting for current `location` to open." +msgstr "" + +#: ../../build/doc/concepts.rst:1081 ../../build/doc/concepts.rst:1149 +#: ../../build/doc/concepts.rst:1239 +msgid "``service_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1083 ../../build/doc/concepts.rst:1151 +msgid "Service time at current `location`." +msgstr "" + +#: ../../build/doc/concepts.rst:1084 ../../build/doc/concepts.rst:1152 +msgid "``departure_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1086 ../../build/doc/concepts.rst:1154 +msgid ":math:`arrival\\_time + wait\\_time + service\\_time`." +msgstr "" + +#: ../../build/doc/concepts.rst:1088 ../../build/doc/concepts.rst:1156 +msgid "When ``stop_type = 6`` has the `total_time` used for the current vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:1093 +msgid "Euclidean Results" +msgstr "" + +#: ../../build/doc/concepts.rst:1098 +msgid "``seq, vehicle_seq, vehicle_id, stop_seq, stop_type, order_id, cargo,``" +msgstr "" + +#: ../../build/doc/concepts.rst:1161 +msgid "VROOM result columns" +msgstr "" + +#: ../../build/doc/concepts.rst:1185 +msgid "" +"Sequential value starting from **1** for current vehicles. The " +":math:`n^{th}` vehicle in the solution." +msgstr "" + +#: ../../build/doc/concepts.rst:1191 +msgid "``-1``: Vehicle denoting all the unallocated tasks." +msgstr "" + +#: ../../build/doc/concepts.rst:1192 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:1193 +msgid "``vehicle_data``" +msgstr "" + +#: ../../build/doc/concepts.rst:1195 +msgid "Metadata information of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:1196 +msgid "``step_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:1198 +msgid "" +"Sequential value starting from **1** for the stops made by the current " +"vehicle. The :math:`m^{th}` stop of the current vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:1201 ../../build/doc/concepts.rst:1206 +#: ../../build/doc/concepts.rst:1218 ../../build/doc/concepts.rst:1224 +msgid "``0``: Summary row" +msgstr "" + +#: ../../build/doc/concepts.rst:1202 +msgid "``step_type``" +msgstr "" + +#: ../../build/doc/concepts.rst:1204 +msgid "Kind of the step location the vehicle is at:" +msgstr "" + +#: ../../build/doc/concepts.rst:1208 +msgid "``2``: Job location" +msgstr "" + +#: ../../build/doc/concepts.rst:1209 +msgid "``3``: Pickup location" +msgstr "" + +#: ../../build/doc/concepts.rst:1210 +msgid "``4``: Delivery location" +msgstr "" + +#: ../../build/doc/concepts.rst:1211 +msgid "``5``: Break location" +msgstr "" + +#: ../../build/doc/concepts.rst:1214 +msgid "``task_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:1216 +msgid "Identifier of the task performed at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1219 +msgid "``-1``: If the step is starting/ending location." +msgstr "" + +#: ../../build/doc/concepts.rst:1222 +msgid "Identifier of the task location." +msgstr "" + +#: ../../build/doc/concepts.rst:1225 +msgid "``task_data``" +msgstr "" + +#: ../../build/doc/concepts.rst:1227 +msgid "Metadata information of the task." +msgstr "" + +#: ../../build/doc/concepts.rst:1228 +msgid "``arrival``" +msgstr "" + +#: ../../build/doc/concepts.rst:1230 +msgid "Estimated time of arrival at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1233 +msgid "Travel time from previous ``step_seq`` to current ``step_seq``." +msgstr "" + +#: ../../build/doc/concepts.rst:1235 +msgid "``0``: When ``step_type = 1``" +msgstr "" + +#: ../../build/doc/concepts.rst:1236 +msgid "``setup_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1238 +msgid "Setup time at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1241 +msgid "Service time at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1242 +msgid "``waiting_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1244 +msgid "Waiting time at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1245 +msgid "``departure``" +msgstr "" + +#: ../../build/doc/concepts.rst:1247 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1249 +msgid ":math:`arrival + service\\_time + waiting\\_time`." +msgstr "" + +#: ../../build/doc/concepts.rst:1250 +msgid "``load``" +msgstr "" + +#: ../../build/doc/concepts.rst:1252 +msgid "Vehicle load after step completion (with capacity constraints)" +msgstr "" + +#: ../../build/doc/concepts.rst:1256 +msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." +msgstr "" + +#: ../../build/doc/concepts.rst:1257 +msgid "" +"The last step of every vehicle denotes the summary row, where the columns" +" ``travel_time``, ``service_time`` and ``waiting_time`` denote the total " +"time for the corresponding vehicle," +msgstr "" + +#: ../../build/doc/concepts.rst:1260 +msgid "" +"The last row denotes the summary for the complete problem, where the " +"columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the" +" total time for the complete problem," +msgstr "" + +#: ../../build/doc/concepts.rst:1268 +msgid "Performance" +msgstr "" + +#: ../../build/doc/concepts.rst:1273 +msgid "How to contribute" +msgstr "" + +#: ../../build/doc/concepts.rst:1276 +msgid "Wiki" +msgstr "" + +#: ../../build/doc/concepts.rst:1277 +msgid "" +"Edit an existing `vrpRouting Wiki " +"`_ page." +msgstr "" + +#: ../../build/doc/concepts.rst:1281 +msgid "Adding Functionaity to vrpRouting" +msgstr "" + +#: ../../build/doc/concepts.rst:1282 +msgid "" +"Consult the `developer's documentation " +"`_" +msgstr "" + +#: ../../build/doc/concepts.rst:1286 +msgid "Indices and tables" +msgstr "" + +#: ../../build/doc/concepts.rst:1287 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/concepts.rst:240 +#: ../../build/doc/concepts.rst:1288 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/release_notes.po b/locale/en/LC_MESSAGES/release_notes.po index 375d88ce3..9b2df9da8 100644 --- a/locale/en/LC_MESSAGES/release_notes.po +++ b/locale/en/LC_MESSAGES/release_notes.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.0.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-29 23:53+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -81,23 +81,27 @@ msgstr "" msgid "Renamed files to be compiled as C++ with .hpp & .cpp extensions" msgstr "" -#: ../../build/doc/release_notes.rst:54 -msgid "Documentation queries" +#: ../../build/doc/release_notes.rst:51 +msgid "Moved sphinx doc from .c files .rst files" msgstr "" #: ../../build/doc/release_notes.rst:55 -msgid "Renamed to extension `.pg`" +msgid "Documentation queries" msgstr "" #: ../../build/doc/release_notes.rst:56 +msgid "Renamed to extension `.pg`" +msgstr "" + +#: ../../build/doc/release_notes.rst:57 msgid "Removed `doc-` and `doc-vrp_` suffixes on file names" msgstr "" -#: ../../build/doc/release_notes.rst:59 +#: ../../build/doc/release_notes.rst:60 msgid "vrpRouting 0.4.1 Release Notes" msgstr "" -#: ../../build/doc/release_notes.rst:61 +#: ../../build/doc/release_notes.rst:62 #, python-format msgid "" "To see all issues & pull requests closed by this release see the `Git " @@ -106,23 +110,23 @@ msgid "" " on Github." msgstr "" -#: ../../build/doc/release_notes.rst:67 +#: ../../build/doc/release_notes.rst:68 msgid "Modification on experimental functions" msgstr "" -#: ../../build/doc/release_notes.rst:68 +#: ../../build/doc/release_notes.rst:69 msgid "OR Tools" msgstr "" -#: ../../build/doc/release_notes.rst:70 +#: ../../build/doc/release_notes.rst:71 msgid "vrp_bin_packing" msgstr "" -#: ../../build/doc/release_notes.rst:71 +#: ../../build/doc/release_notes.rst:72 msgid "vrp_knapsack" msgstr "" -#: ../../build/doc/release_notes.rst:72 +#: ../../build/doc/release_notes.rst:73 msgid "vrp_multiple_knapsack" msgstr "" @@ -130,7 +134,7 @@ msgstr "" msgid "Support for or-tools v9.10.4067" msgstr "" -#: ../../build/doc/release_notes.rst:78 +#: ../../build/doc/release_notes.rst:79 msgid "vrp_oneDepot" msgstr "" @@ -142,15 +146,15 @@ msgstr "" msgid "Result columns changed" msgstr "" -#: ../../build/doc/release_notes.rst:85 +#: ../../build/doc/release_notes.rst:86 msgid "Removal of Boost on the build" msgstr "" -#: ../../build/doc/release_notes.rst:86 ../../build/doc/release_notes.rst:184 +#: ../../build/doc/release_notes.rst:87 ../../build/doc/release_notes.rst:185 msgid "vrp_full_version" msgstr "" -#: ../../build/doc/release_notes.rst:87 ../../build/doc/release_notes.rst:183 +#: ../../build/doc/release_notes.rst:88 ../../build/doc/release_notes.rst:184 msgid "vrp_version" msgstr "" @@ -158,11 +162,11 @@ msgstr "" msgid "Boost removed from the result columns" msgstr "" -#: ../../build/doc/release_notes.rst:94 +#: ../../build/doc/release_notes.rst:95 msgid "vrpRouting 0.4.0 Release Notes" msgstr "" -#: ../../build/doc/release_notes.rst:96 +#: ../../build/doc/release_notes.rst:97 #, python-format msgid "" "To see all issues & pull requests closed by this release see the `Git " @@ -171,39 +175,39 @@ msgid "" " on Github." msgstr "" -#: ../../build/doc/release_notes.rst:101 +#: ../../build/doc/release_notes.rst:102 msgid "" "Added support for VROOM 1.12.0 (`#34 " "`_)" msgstr "" -#: ../../build/doc/release_notes.rst:102 +#: ../../build/doc/release_notes.rst:103 msgid "No visible changes on user side with respect to signatures." msgstr "" -#: ../../build/doc/release_notes.rst:103 +#: ../../build/doc/release_notes.rst:104 msgid "Adjusted to VROOM v1.12.0 due to internal breaking changes:" msgstr "" -#: ../../build/doc/release_notes.rst:105 +#: ../../build/doc/release_notes.rst:106 msgid "Made changes according to new vroom::Input signature." msgstr "" -#: ../../build/doc/release_notes.rst:106 +#: ../../build/doc/release_notes.rst:107 msgid "" "CI changes to compile without routing support, with Position Independent " "Code." msgstr "" -#: ../../build/doc/release_notes.rst:107 +#: ../../build/doc/release_notes.rst:108 msgid "Removed support for VROOM 1.11.0" msgstr "" -#: ../../build/doc/release_notes.rst:110 +#: ../../build/doc/release_notes.rst:111 msgid "vrpRouting 0.3" msgstr "" -#: ../../build/doc/release_notes.rst:112 +#: ../../build/doc/release_notes.rst:113 #, python-format msgid "" "To see all issues & pull requests closed by this release see the `Git " @@ -212,87 +216,87 @@ msgid "" " on Github." msgstr "" -#: ../../build/doc/release_notes.rst:117 +#: ../../build/doc/release_notes.rst:118 msgid "Modification of experimental functions" msgstr "" -#: ../../build/doc/release_notes.rst:118 ../../build/doc/release_notes.rst:156 +#: ../../build/doc/release_notes.rst:119 ../../build/doc/release_notes.rst:157 msgid "VROOM" msgstr "" -#: ../../build/doc/release_notes.rst:120 ../../build/doc/release_notes.rst:158 +#: ../../build/doc/release_notes.rst:121 ../../build/doc/release_notes.rst:159 msgid "vrp_vroom" msgstr "" -#: ../../build/doc/release_notes.rst:121 ../../build/doc/release_notes.rst:159 +#: ../../build/doc/release_notes.rst:122 ../../build/doc/release_notes.rst:160 msgid "vrp_vroomJobs" msgstr "" -#: ../../build/doc/release_notes.rst:122 ../../build/doc/release_notes.rst:160 +#: ../../build/doc/release_notes.rst:123 ../../build/doc/release_notes.rst:161 msgid "vrp_vroomShipments" msgstr "" -#: ../../build/doc/release_notes.rst:123 ../../build/doc/release_notes.rst:161 +#: ../../build/doc/release_notes.rst:124 ../../build/doc/release_notes.rst:162 msgid "vrp_vroomPlain" msgstr "" -#: ../../build/doc/release_notes.rst:124 ../../build/doc/release_notes.rst:162 +#: ../../build/doc/release_notes.rst:125 ../../build/doc/release_notes.rst:163 msgid "vrp_vroomJobsPlain" msgstr "" -#: ../../build/doc/release_notes.rst:125 ../../build/doc/release_notes.rst:163 +#: ../../build/doc/release_notes.rst:126 ../../build/doc/release_notes.rst:164 msgid "vrp_vroomShipmentsPlain" msgstr "" -#: ../../build/doc/release_notes.rst:128 +#: ../../build/doc/release_notes.rst:129 msgid "" "Added support for VROOM 1.11.0 (`#24 " "`_)" msgstr "" -#: ../../build/doc/release_notes.rst:129 +#: ../../build/doc/release_notes.rst:130 msgid "Added setup time in jobs and shipments to refine service time modeling." msgstr "" -#: ../../build/doc/release_notes.rst:130 +#: ../../build/doc/release_notes.rst:131 msgid "Added support for custom cost matrices, along with the duration matrix." msgstr "" -#: ../../build/doc/release_notes.rst:132 +#: ../../build/doc/release_notes.rst:133 msgid "Using start_id, end_id, duration, cost as matrix table columns." msgstr "" -#: ../../build/doc/release_notes.rst:133 +#: ../../build/doc/release_notes.rst:134 msgid "" "Added timeout and exploration_level parameters to vroom-category " "functions." msgstr "" -#: ../../build/doc/release_notes.rst:134 +#: ../../build/doc/release_notes.rst:135 msgid "Added max_tasks column in vehicles." msgstr "" -#: ../../build/doc/release_notes.rst:135 +#: ../../build/doc/release_notes.rst:136 msgid "Added tests for empty skills arrays." msgstr "" -#: ../../build/doc/release_notes.rst:136 +#: ../../build/doc/release_notes.rst:137 msgid "Added custom scaling logic for speed_factor." msgstr "" -#: ../../build/doc/release_notes.rst:137 +#: ../../build/doc/release_notes.rst:138 msgid "Modified parameter names to make the naming consistent." msgstr "" -#: ../../build/doc/release_notes.rst:140 +#: ../../build/doc/release_notes.rst:141 msgid "Fixes" msgstr "" -#: ../../build/doc/release_notes.rst:141 +#: ../../build/doc/release_notes.rst:142 msgid "Honor client cancel requests for vroom-category functions." msgstr "" -#: ../../build/doc/release_notes.rst:142 +#: ../../build/doc/release_notes.rst:143 msgid "" "Added more information in the inner query and result columns of VROOM " "category functions (`#26 " @@ -300,79 +304,79 @@ msgid "" "`_):" msgstr "" -#: ../../build/doc/release_notes.rst:145 +#: ../../build/doc/release_notes.rst:146 msgid "Summary row in the output, for each vehicle and for the complete problem." msgstr "" -#: ../../build/doc/release_notes.rst:146 +#: ../../build/doc/release_notes.rst:147 msgid "Uassigned rows in the output with vehicle_id = -1." msgstr "" -#: ../../build/doc/release_notes.rst:147 +#: ../../build/doc/release_notes.rst:148 msgid "" "Modified travel_time result column to return travel time between current " "and last step." msgstr "" -#: ../../build/doc/release_notes.rst:148 +#: ../../build/doc/release_notes.rst:149 msgid "" "Added data jsonb field in jobs, shipments, vehicles, breaks as well as in" " the result columns." msgstr "" -#: ../../build/doc/release_notes.rst:149 +#: ../../build/doc/release_notes.rst:150 msgid "Added departure field and location_id field in the result columns." msgstr "" -#: ../../build/doc/release_notes.rst:152 +#: ../../build/doc/release_notes.rst:153 msgid "vrpRouting 0.2" msgstr "" -#: ../../build/doc/release_notes.rst:155 +#: ../../build/doc/release_notes.rst:156 msgid "New experimental functions" msgstr "" -#: ../../build/doc/release_notes.rst:165 +#: ../../build/doc/release_notes.rst:166 msgid "VRP" msgstr "" -#: ../../build/doc/release_notes.rst:167 +#: ../../build/doc/release_notes.rst:168 msgid "vrp_compatibleVehicles" msgstr "" -#: ../../build/doc/release_notes.rst:168 +#: ../../build/doc/release_notes.rst:169 msgid "vrp_optimize" msgstr "" -#: ../../build/doc/release_notes.rst:169 +#: ../../build/doc/release_notes.rst:170 msgid "vrp_pickDeliverAdd" msgstr "" -#: ../../build/doc/release_notes.rst:170 +#: ../../build/doc/release_notes.rst:171 msgid "vrp_pickDeliver" msgstr "" -#: ../../build/doc/release_notes.rst:171 +#: ../../build/doc/release_notes.rst:172 msgid "vrp_simulation" msgstr "" -#: ../../build/doc/release_notes.rst:172 +#: ../../build/doc/release_notes.rst:173 msgid "vrp_viewRoute" msgstr "" -#: ../../build/doc/release_notes.rst:175 +#: ../../build/doc/release_notes.rst:176 msgid "vrpRouting 0.1" msgstr "" -#: ../../build/doc/release_notes.rst:178 +#: ../../build/doc/release_notes.rst:179 msgid "Extraction tasks" msgstr "" -#: ../../build/doc/release_notes.rst:179 +#: ../../build/doc/release_notes.rst:180 msgid "Porting pgRouting's VRP functionality" msgstr "" -#: ../../build/doc/release_notes.rst:182 +#: ../../build/doc/release_notes.rst:183 msgid "New official functions" msgstr "" diff --git a/locale/en/LC_MESSAGES/vroom-category.po b/locale/en/LC_MESSAGES/vroom-category.po index a0a452aa8..8591b2286 100644 --- a/locale/en/LC_MESSAGES/vroom-category.po +++ b/locale/en/LC_MESSAGES/vroom-category.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.3.0-dev\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/vroom-category.rst:12 msgid "" @@ -232,21 +232,21 @@ msgid "" "can be served by only that vehicle which has all the skills of the task." msgstr "" -#: ../../build/doc/vroom-category.rst:89 +#: ../../build/doc/vroom-category.rst:90 msgid "" "**Priority**: Tasks may have some priority assigned, which is useful when" " all tasks cannot be performed due to constraints, so the tasks with low " "priority are left unassigned." msgstr "" -#: ../../build/doc/vroom-category.rst:90 +#: ../../build/doc/vroom-category.rst:93 msgid "" "**Amount (for shipment), Pickup and delivery (for job)**: They denote the" " multidimensional quantities such as number of items, weights, volume, " "etc." msgstr "" -#: ../../build/doc/vroom-category.rst:91 +#: ../../build/doc/vroom-category.rst:95 msgid "" "**Capacity (for vehicle)**: Every vehicle may have some capacity, " "denoting the multidimensional quantities. A vehicle can serve only those " @@ -254,20 +254,20 @@ msgid "" " vehicle capacity, at any point of the route." msgstr "" -#: ../../build/doc/vroom-category.rst:92 +#: ../../build/doc/vroom-category.rst:99 msgid "" "**Time Window**: An interval of time during which some activity can be " "performed, such as working hours of the vehicle, break of the vehicle, or" " service start time for a task." msgstr "" -#: ../../build/doc/vroom-category.rst:93 +#: ../../build/doc/vroom-category.rst:102 msgid "" "**Break**: Array of time windows, denoting valid slots for the break " "start of a vehicle." msgstr "" -#: ../../build/doc/vroom-category.rst:94 +#: ../../build/doc/vroom-category.rst:104 msgid "" "**Setup time**: Setup times serve as a mean to describe the time it takes" " to get started for a task at a given location. This models a duration " @@ -277,523 +277,473 @@ msgid "" "task at the previous vehicle location." msgstr "" -#: ../../build/doc/vroom-category.rst:98 +#: ../../build/doc/vroom-category.rst:111 msgid "" "**Service time**: The additional time to be spent by a vehicle while " "serving a task." msgstr "" -#: ../../build/doc/vroom-category.rst:99 +#: ../../build/doc/vroom-category.rst:113 msgid "**Travel time**: The total time the vehicle travels during its route." msgstr "" -#: ../../build/doc/vroom-category.rst:100 +#: ../../build/doc/vroom-category.rst:114 msgid "" "**Waiting time**: The total time the vehicle is idle, i.e. it is neither " "traveling nor servicing any task. It is generally the time spent by a " "vehicle waiting for a task service to open." msgstr "" -#: ../../build/doc/vroom-category.rst:109 +#: ../../build/doc/vroom-category.rst:119 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vroom-category.rst:112 +#: ../../build/doc/vroom-category.rst:122 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:62 ../../build/doc/concepts.rst:78 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:18 ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:13 ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:23 ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:29 msgid "Column" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:30 msgid "Type" msgstr "" -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:31 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 ../../build/doc/concepts.rst:32 msgid "Description" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:33 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:36 ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../src/common/vroom/jobs_input.c:16 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:45 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:43 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:20 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:80 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 +#: ../../build/doc/concepts.rst:51 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" delivery such as number of items, weight, volume etc." +" pickup such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:26 -msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" +#: ../../build/doc/concepts.rst:54 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 +#: ../../build/doc/concepts.rst:58 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" pickup such as number of items, weight, volume etc." -msgstr "" - -#: ../../src/common/vroom/jobs_input.c:33 -msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" -msgstr "" - -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +" delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:61 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:65 +#: ../../build/doc/concepts.rst:81 msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:33 -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:85 msgid "``INTEGER``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/concepts.rst:68 ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:69 ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "**data**" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:30 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 +#: ../../build/doc/concepts.rst:73 msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/vroom-category.rst:129 +msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c ../../src/common/vroom/shipments_input.c -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" msgstr "" -#: ../../build/doc/vroom-category.rst:119 -msgid "Shipments SQL" +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 +#: ../../build/doc/concepts.rst:36 msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:44 ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:48 ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 ../../build/doc/concepts.rst:72 msgid "" "Array of non-negative integers describing multidimensional quantities " "such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 +#: ../../build/doc/concepts.rst:75 msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." -msgstr "" - -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" -msgstr "" - -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/vroom-category.rst:138 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../build/doc/vroom-category.rst:128 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/vehicles_input.c:14 +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:30 msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "**start_id**" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 +#: ../../build/doc/concepts.rst:45 msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:84 msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 +#: ../../build/doc/concepts.rst:53 msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:54 msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 +#: ../../build/doc/concepts.rst:23 ../../build/doc/concepts.rst:57 +msgid "``tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:59 msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:60 msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "" "Max value of speed factor for a vehicle shall not be greater than 5 times" " the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:73 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../src/common/vroom/vehicles_input.c:46 +#: ../../build/doc/concepts.rst:81 ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "" "If ``end_id`` is omitted, the resulting route will stop at the last " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "" "If ``start_id`` is omitted, the resulting route will start at the first " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "" "To request a round trip, specify both ``start_id`` and ``end_id`` as the " "same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "" "A vehicle is only allowed to serve a set of tasks if the resulting load " "at each route step is lower than the matching value in capacity for each " @@ -801,366 +751,352 @@ msgid "" "put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "" "It is assumed that all delivery-related amounts for jobs are loaded at " "vehicle start, while all pickup-related amounts for jobs are brought back" " at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" +#: ../../build/doc/vroom-category.rst:145 +msgid "Breaks SQL" msgstr "" -#: ../../build/doc/vroom-category.rst:135 -msgid "Breaks SQL" +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../build/doc/vroom-category.rst:142 -msgid "Time Windows SQL" +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." +#: ../../build/doc/vroom-category.rst:152 +msgid "Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 +#: ../../build/doc/concepts.rst:18 msgid "" -"**Only required for shipments time windows**. Value in ['p', 'd'] " -"indicating whether the time window is for:" +"Positive unique identifier of the: job, pickup/delivery shipment, or " +"break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "" -"**Relative values**, e.g. [0, 14400] for a 4 hours time window starting " -"at the beginning of the planning horizon. In that case all times reported" -" in output with the arrival column are relative to the start of the " -"planning horizon." +#: ../../build/doc/vroom-category.rst:159 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "" -"**Absolute values**, \"real\" timestamps. In that case all times reported" -" in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:149 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" -msgstr "" - -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../build/doc/vroom-category.rst:158 +#: ../../build/doc/vroom-category.rst:168 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 +#: ../../build/doc/concepts.rst:23 msgid "" -"Sequential value starting from **1** for current vehicles. The " +"Sequential value starting from **1** for current vehicles. The " ":math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "" "Sequential value starting from **1** for the stops made by the current " "vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "" "The last step of every vehicle denotes the summary row, where the columns" " ``travel_time``, ``service_time`` and ``waiting_time`` denote the total " "time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "" "The last row denotes the summary for the complete problem, where the " "columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the" " total time for the complete problem," msgstr "" -#: ../../build/doc/vroom-category.rst:169 +#: ../../build/doc/vroom-category.rst:175 msgid "See Also" msgstr "" -#: ../../build/doc/vroom-category.rst:173 +#: ../../build/doc/vroom-category.rst:179 msgid "" "`Wikipedia: Vehicle Routing problems " "`__" msgstr "" -#: ../../build/doc/vroom-category.rst:174 +#: ../../build/doc/vroom-category.rst:180 msgid "" "`VROOM: Vehicle Routing Open-source Optimization Machine " "`__" msgstr "" -#: ../../build/doc/vroom-category.rst:175 +#: ../../build/doc/vroom-category.rst:181 msgid "" "`VROOM API Documentation `__" msgstr "" -#: ../../build/doc/vroom-category.rst:180 +#: ../../build/doc/vroom-category.rst:186 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vroom-category.rst:181 +#: ../../build/doc/vroom-category.rst:187 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vroom-category.rst:182 +#: ../../build/doc/vroom-category.rst:188 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/vrp_multiple_knapsack.po b/locale/en/LC_MESSAGES/vrp_multiple_knapsack.po index cbd65c6ef..0205d9c46 100644 --- a/locale/en/LC_MESSAGES/vrp_multiple_knapsack.po +++ b/locale/en/LC_MESSAGES/vrp_multiple_knapsack.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.4.1\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-22 19:34+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -130,10 +130,9 @@ msgstr "" #: ../../build/doc/or_tools-category.rst:10 #: ../../build/doc/vrp_multiple_knapsack.rst:39 -#: ../../build/doc/vrp_multiple_knapsack.rst:70 -#: ../../build/doc/vrp_multiple_knapsack.rst:89 -#: ../../build/doc/vrp_multiple_knapsack.rst:115 -#: ../../sql/or_tools/multiple_knapsack.sql:10 +#: ../../build/doc/vrp_multiple_knapsack.rst:66 +#: ../../build/doc/vrp_multiple_knapsack.rst:85 +#: ../../build/doc/vrp_multiple_knapsack.rst:111 msgid "Description" msgstr "" @@ -165,87 +164,85 @@ msgstr "" msgid "OR EMPTY SET" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:61 +#: ../../build/doc/vrp_multiple_knapsack.rst:57 msgid "Parameters" msgstr "" #: ../../build/doc/or_tools-category.rst:8 -#: ../../build/doc/vrp_multiple_knapsack.rst:68 -#: ../../build/doc/vrp_multiple_knapsack.rst:86 -#: ../../build/doc/vrp_multiple_knapsack.rst:113 -#: ../../sql/or_tools/multiple_knapsack.sql:10 +#: ../../build/doc/vrp_multiple_knapsack.rst:64 +#: ../../build/doc/vrp_multiple_knapsack.rst:82 +#: ../../build/doc/vrp_multiple_knapsack.rst:109 msgid "Column" msgstr "" #: ../../build/doc/or_tools-category.rst:9 -#: ../../build/doc/vrp_multiple_knapsack.rst:69 -#: ../../build/doc/vrp_multiple_knapsack.rst:87 -#: ../../build/doc/vrp_multiple_knapsack.rst:114 -#: ../../sql/or_tools/multiple_knapsack.sql:10 +#: ../../build/doc/vrp_multiple_knapsack.rst:65 +#: ../../build/doc/vrp_multiple_knapsack.rst:83 +#: ../../build/doc/vrp_multiple_knapsack.rst:110 msgid "Type" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:71 +#: ../../build/doc/vrp_multiple_knapsack.rst:67 msgid "`Weight Costs SQL`_" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:72 +#: ../../build/doc/vrp_multiple_knapsack.rst:68 msgid "``TEXT``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:73 +#: ../../build/doc/vrp_multiple_knapsack.rst:69 msgid "`Weight Costs SQL`_ as described below" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:74 +#: ../../build/doc/vrp_multiple_knapsack.rst:70 msgid "capacities" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:75 +#: ../../build/doc/vrp_multiple_knapsack.rst:71 msgid "``ARRAY[`` **ANY-INTEGER** ``]``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:76 +#: ../../build/doc/vrp_multiple_knapsack.rst:72 msgid "An array describing the capacity of each knapsack." msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:79 +#: ../../build/doc/vrp_multiple_knapsack.rst:75 msgid "Optional Parameters" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:88 +#: ../../build/doc/vrp_multiple_knapsack.rst:84 msgid "Default" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:90 +#: ../../build/doc/vrp_multiple_knapsack.rst:86 msgid "``max_rows``" msgstr "" #: ../../build/doc/or_tools-category.rst:12 #: ../../build/doc/or_tools-category.rst:15 #: ../../build/doc/or_tools-category.rst:18 -#: ../../build/doc/vrp_multiple_knapsack.rst:91 +#: ../../build/doc/vrp_multiple_knapsack.rst:87 msgid "**ANY-INTEGER**" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:92 +#: ../../build/doc/vrp_multiple_knapsack.rst:88 msgid ":math:`100000`" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:93 +#: ../../build/doc/vrp_multiple_knapsack.rst:89 msgid "Maximum items(rows) to fetch from bin_packing_data table." msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:96 +#: ../../build/doc/vrp_multiple_knapsack.rst:92 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:99 +#: ../../build/doc/vrp_multiple_knapsack.rst:95 msgid "Weight Costs SQL" msgstr "" #: ../../build/doc/or_tools-category.rst:11 -#: ../../build/doc/vrp_multiple_knapsack.rst:119 +#: ../../build/doc/vrp_multiple_knapsack.rst:115 msgid "``id``" msgstr "" @@ -281,57 +278,32 @@ msgstr "" msgid "``SMALLINT``, ``INTEGER``, ``BIGINT``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:106 +#: ../../build/doc/vrp_multiple_knapsack.rst:102 msgid "Result Columns" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:116 +#: ../../build/doc/vrp_multiple_knapsack.rst:112 msgid "``knapsak``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:117 -#: ../../build/doc/vrp_multiple_knapsack.rst:120 +#: ../../build/doc/vrp_multiple_knapsack.rst:113 +#: ../../build/doc/vrp_multiple_knapsack.rst:116 msgid "``INTEGER``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:118 +#: ../../build/doc/vrp_multiple_knapsack.rst:114 msgid "Indentifier of the knapsack." msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:121 +#: ../../build/doc/vrp_multiple_knapsack.rst:117 msgid "Indentifier of an item in the ``knapsack``." msgstr "" -#: ../../sql/or_tools/multiple_knapsack.sql:3 -msgid "Returns set of" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:12 -msgid "**knapsack_number**" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:12 -#: ../../sql/or_tools/multiple_knapsack.sql:14 -msgid "``ANY-INTEGER``" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:12 -msgid "Integer to uniquely identify a knapsack" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:14 -msgid "**item_id**" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:14 -msgid "Integer to uniquely identify an item in the bin" -msgstr "" - -#: ../../build/doc/vrp_multiple_knapsack.rst:128 +#: ../../build/doc/vrp_multiple_knapsack.rst:120 msgid "Example" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:135 +#: ../../build/doc/vrp_multiple_knapsack.rst:127 msgid "See Also" msgstr "" @@ -345,15 +317,15 @@ msgstr "" msgid "`OR-Tools: Google OR-Tools `__" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:142 +#: ../../build/doc/vrp_multiple_knapsack.rst:134 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:143 +#: ../../build/doc/vrp_multiple_knapsack.rst:135 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:144 +#: ../../build/doc/vrp_multiple_knapsack.rst:136 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/vrp_pgr_pickDeliver.po b/locale/en/LC_MESSAGES/vrp_pgr_pickDeliver.po index 1b2baa3aa..71dffc583 100644 --- a/locale/en/LC_MESSAGES/vrp_pgr_pickDeliver.po +++ b/locale/en/LC_MESSAGES/vrp_pgr_pickDeliver.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.0.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-09-28 10:43+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/vrp_pgr_pickDeliver.rst:12 msgid "" @@ -238,604 +238,634 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:91 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:85 +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst +msgid "pgr_pickDeliver(" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst +msgid "`Orders SQL`_, `Vehicles SQL`_, `Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst +msgid "``[factor, max_cycles, initial_sol]``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst +msgid "``seq, vehicle_number, vehicle_id, stop, order_id, stop_type, cargo,``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 ../../build/doc/vrp_pgr_pickDeliver.rst +msgid "``travel_time, arrival_time, wait_time, service_time, departure_time``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:96 msgid "Parameters" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 -#: ../../src/common/matrixRows_input.c:10 ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:14 +#: ../../build/doc/concepts.rst:11 ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 ../../build/doc/vrp_pgr_pickDeliver.rst:104 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:128 msgid "Column" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 -#: ../../src/common/matrixRows_input.c:10 ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:14 +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 ../../build/doc/vrp_pgr_pickDeliver.rst:105 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:129 msgid "Type" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 -#: ../../src/common/orders_input.c:13 ../../src/common/vehicles_input.c:14 -msgid "Default" -msgstr "" - -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 -#: ../../src/common/matrixRows_input.c:10 ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:14 +#: ../../build/doc/concepts.rst:13 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/vrp_pgr_pickDeliver.rst:106 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:131 msgid "Description" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -msgid "**Orders SQL**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:107 +msgid "`Orders SQL`_" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:108 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:111 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:114 msgid "``TEXT``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -msgid "`Orders SQL`_ query contianing the orders to be processed." +#: ../../build/doc/vrp_pgr_pickDeliver.rst:109 +msgid "`Orders SQL`_ as described below." +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:110 +msgid "`Vehicles SQL`_" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:112 +msgid "`Vehicles SQL`_ as described below." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:113 +msgid "`Matrix SQL`_" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -msgid "`Vehicles SQL`_ query containing the vehicles to be used." +#: ../../build/doc/vrp_pgr_pickDeliver.rst:115 +msgid "`Matrix SQL`_ as described below." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:120 +msgid "Optional Parameters" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 -msgid "`Time Matrix SQL`_ query containing the distance or travel times." +#: ../../build/doc/concepts.rst:15 ../../build/doc/vrp_pgr_pickDeliver.rst:130 +msgid "Default" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 -msgid "**factor**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:132 +msgid "``factor``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:133 msgid "``NUMERIC``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 +#: ../../build/doc/concepts.rst:29 ../../build/doc/vrp_pgr_pickDeliver.rst:134 msgid "1" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:135 msgid "Travel time multiplier. See :ref:`pd_factor`" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 -msgid "**max_cycles**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:136 +msgid "``max_cycles``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:11 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:137 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:141 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:138 msgid "10" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:139 msgid "Maximum number of cycles to perform on the optimization." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:11 -msgid "**initial_sol**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:140 +msgid "``initial_sol``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:11 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:142 msgid "4" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:11 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:143 msgid "Initial solution to be used." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:13 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:145 msgid "``1`` One order per truck" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:14 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:146 msgid "``2`` Push front order." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:15 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:147 msgid "``3`` Push back order." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:16 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:148 msgid "``4`` Optimize insert." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:17 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:149 msgid "``5`` Push back order that allows more orders to be inserted at the back" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:18 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:150 msgid "``6`` Push front order that allows more orders to be inserted at the front" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:99 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:155 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:103 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:159 msgid "Orders SQL" msgstr "" -#: ../../src/common/matrixRows_input.c:3 ../../src/common/orders_input.c:3 -#: ../../src/common/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/orders_input.c:15 ../../src/common/vehicles_input.c:16 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, amount``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``p_id, p_tw_open, p_tw_close, [p_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:7 +msgid "``d_id, d_tw_open, d_tw_close, [d_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:17 +msgid "``id``" msgstr "" -#: ../../src/common/matrixRows_input.c:12 ../../src/common/orders_input.c:15 -#: ../../src/common/orders_input.c:17 ../../src/common/orders_input.c:21 -#: ../../src/common/vehicles_input.c:16 ../../src/common/vehicles_input.c:19 -#: ../../src/common/vehicles_input.c:27 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:32 ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:46 ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:52 ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:58 ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:68 msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/orders_input.c:15 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the pick-delivery order pair." msgstr "" -#: ../../src/common/orders_input.c:16 -msgid "**amount**" +#: ../../build/doc/concepts.rst:21 +msgid "``amount``" msgstr "" -#: ../../src/common/matrixRows_input.c:13 -#: ../../src/common/matrixRows_input.c:14 ../../src/common/orders_input.c:16 -#: ../../src/common/orders_input.c:18 ../../src/common/orders_input.c:19 -#: ../../src/common/orders_input.c:20 ../../src/common/orders_input.c:22 -#: ../../src/common/orders_input.c:23 ../../src/common/orders_input.c:24 -#: ../../src/common/vehicles_input.c:17 ../../src/common/vehicles_input.c:18 -#: ../../src/common/vehicles_input.c:20 ../../src/common/vehicles_input.c:23 -#: ../../src/common/vehicles_input.c:26 ../../src/common/vehicles_input.c:28 -#: ../../src/common/vehicles_input.c:31 ../../src/common/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/orders_input.c:16 -msgid "Number of units in the order" +#: ../../build/doc/concepts.rst:24 +msgid "Number of units in the order." +msgstr "" + +#: ../../build/doc/concepts.rst:25 +msgid "``p_id``" msgstr "" -#: ../../src/common/orders_input.c:17 -msgid "**p_id**" +#: ../../build/doc/concepts.rst:28 +msgid "Identifier of the pickup node." msgstr "" -#: ../../src/common/orders_input.c:17 -msgid "The identifier of the pickup node." +#: ../../build/doc/concepts.rst:30 ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:56 +msgid "Must match a node identifier in the `Matrix SQL`_." msgstr "" -#: ../../src/common/orders_input.c:18 -msgid "**p_tw_open**" +#: ../../build/doc/concepts.rst:31 +msgid "``p_tw_open``" msgstr "" -#: ../../src/common/orders_input.c:18 +#: ../../build/doc/concepts.rst:34 msgid "The time, relative to 0, when the pickup location opens." msgstr "" -#: ../../src/common/orders_input.c:19 -msgid "**p_tw_close**" +#: ../../build/doc/concepts.rst:35 +msgid "``p_tw_close``" msgstr "" -#: ../../src/common/orders_input.c:19 +#: ../../build/doc/concepts.rst:38 msgid "The time, relative to 0, when the pickup location closes." msgstr "" -#: ../../src/common/orders_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:40 +msgid ":math:`p\\_tw\\_open < p\\_tw\\_close < 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:41 +msgid "``p_service``" msgstr "" -#: ../../src/common/orders_input.c:20 ../../src/common/orders_input.c:24 +#: ../../build/doc/concepts.rst:39 ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:49 ../../build/doc/concepts.rst:63 msgid "0" msgstr "" -#: ../../src/common/orders_input.c:20 +#: ../../build/doc/concepts.rst:44 msgid "The duration of the loading at the pickup location." msgstr "" -#: ../../src/common/orders_input.c:21 -msgid "**d_id**" +#: ../../build/doc/concepts.rst:45 +msgid "``d_id``" msgstr "" -#: ../../src/common/orders_input.c:21 -msgid "The identifier of the delivery node." +#: ../../build/doc/concepts.rst:48 +msgid "Identifier of the delivery node." msgstr "" -#: ../../src/common/orders_input.c:22 -msgid "**d_tw_open**" +#: ../../build/doc/concepts.rst:51 +msgid "``d_tw_open``" msgstr "" -#: ../../src/common/orders_input.c:22 +#: ../../build/doc/concepts.rst:54 msgid "The time, relative to 0, when the delivery location opens." msgstr "" -#: ../../src/common/orders_input.c:23 -msgid "**d_tw_close**" +#: ../../build/doc/concepts.rst:55 +msgid "``d_tw_close``" msgstr "" -#: ../../src/common/orders_input.c:23 +#: ../../build/doc/concepts.rst:58 msgid "The time, relative to 0, when the delivery location closes." msgstr "" -#: ../../src/common/orders_input.c:24 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:60 +msgid ":math:`d\\_tw\\_open < d\\_tw\\_close <= 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/orders_input.c:24 +#: ../../build/doc/concepts.rst:64 msgid "The duration of the unloading at the delivery location." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:110 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:166 msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vehicles_input.c:16 -msgid "Identifier of the vehicle" +#: ../../build/doc/concepts.rst:5 +msgid "``id, capacity, [speed,]``" msgstr "" -#: ../../src/common/vehicles_input.c:17 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:6 +msgid "``s_id, [s_tw_open, s_tw_close, s_service,]``" msgstr "" -#: ../../src/common/vehicles_input.c:17 -msgid "Capacity of the vehicle" +#: ../../build/doc/concepts.rst:7 +msgid "``[e_id, e_tw_open, e_tw_close, e_service]``" msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid "**speed**" +#: ../../build/doc/concepts.rst:20 +msgid "Identifier of the vehicle" msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid "`1`" +#: ../../build/doc/concepts.rst:21 +msgid "``capacity``" msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid "Average speed of the vehicle." +#: ../../build/doc/concepts.rst:24 +msgid "Capacity of the vehicle." msgstr "" -#: ../../src/common/vehicles_input.c:19 -msgid "**s_id**" +#: ../../build/doc/concepts.rst:26 +msgid ":math:`0 < capacity <= 4294967295`." msgstr "" -#: ../../src/common/vehicles_input.c:19 -msgid "" -"The node identifier of the starting location, must match a node " -"identifier in the matrix table." +#: ../../build/doc/concepts.rst:27 +msgid "``speed``" msgstr "" -#: ../../src/common/vehicles_input.c:20 -msgid "**s_tw_open**" +#: ../../build/doc/concepts.rst:30 +msgid "Speed of the vehicle." msgstr "" -#: ../../src/common/vehicles_input.c:20 ../../src/common/vehicles_input.c:26 -msgid "`0`" +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:53 +msgid "``s_id``" msgstr "" -#: ../../src/common/vehicles_input.c:20 -msgid "" -"The time, relative to 0, when the starting location opens. When " -"`s_tw_open` column exist then `s_tw_close` column is expected Default " -"value when (`s_tw_open`, s_tw_close) columns do not exist" +#: ../../build/doc/concepts.rst:34 +msgid "The node identifier of the starting location." msgstr "" -#: ../../src/common/vehicles_input.c:23 -msgid "**s_tw_close**" +#: ../../build/doc/concepts.rst:37 ../../build/doc/concepts.rst:59 +msgid "``s_tw_open``" msgstr "" -#: ../../src/common/vehicles_input.c:23 -msgid "`INFINITY`" +#: ../../build/doc/concepts.rst:40 +msgid "The time, relative to 0, when the starting location opens." msgstr "" -#: ../../src/common/vehicles_input.c:23 -msgid "" -"The time, relative to 0, when the starting location closes. When " -"`s_tw_close` column exist then `e_tw_open` column is expected Default " -"value when `(s_tw_open, s_tw_close)` columns do not exist" +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:63 +msgid "``s_tw_close``" msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "**s_service**" +#: ../../build/doc/concepts.rst:43 +msgid "|MAX-BIGINT|" msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "The duration of the loading at the starting location." +#: ../../build/doc/concepts.rst:44 +msgid "The time, relative to 0, when the starting location closes." msgstr "" -#: ../../src/common/vehicles_input.c:27 -msgid "**e_id**" +#: ../../build/doc/concepts.rst:46 +msgid ":math:`s\\_tw\\_open < s\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/vehicles_input.c:27 -msgid "`s_id`" +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:69 +msgid "``s_service``" msgstr "" -#: ../../src/common/vehicles_input.c:27 -msgid "" -"The node identifier of the ending location, must match a node identifier " -"in the matrix table." +#: ../../build/doc/concepts.rst:50 +msgid "Duration of any task at the starting location," msgstr "" -#: ../../src/common/vehicles_input.c:28 -msgid "**e_tw_open**" +#: ../../build/doc/concepts.rst:51 +msgid "``e_id``" msgstr "" -#: ../../src/common/vehicles_input.c:28 -msgid "`s_tw_open`" +#: ../../build/doc/concepts.rst:54 +msgid "The node identifier of the ending location." msgstr "" -#: ../../src/common/vehicles_input.c:28 -msgid "" -"The time, relative to 0, when the ending location opens. When `e_tw_open`" -" column exist then `e__tw_close` column is expected Default value when " -"(`e_tw_open`, e_tw_close) columns do not exist" +#: ../../build/doc/concepts.rst:57 +msgid "``e_tw_open``" msgstr "" -#: ../../src/common/vehicles_input.c:31 -msgid "**e_tw_close**" +#: ../../build/doc/concepts.rst:60 +msgid "The time, relative to 0, when the ending location opens." msgstr "" -#: ../../src/common/vehicles_input.c:31 -msgid "`s_tw_close`" +#: ../../build/doc/concepts.rst:61 +msgid "``e_tw_close``" msgstr "" -#: ../../src/common/vehicles_input.c:31 -msgid "" -"The time, relative to 0, when the ending location closes. When " -"`e_tw_close` column exist then `e_tw_open` column is expected Default " -"value when `(e_tw_open`, e_tw_close)` columns do not exist" +#: ../../build/doc/concepts.rst:64 +msgid "The time, relative to 0, when the ending location closes." msgstr "" -#: ../../src/common/vehicles_input.c:34 -msgid "**e_service**" +#: ../../build/doc/concepts.rst:66 +msgid ":math:`e\\_tw\\_open < e\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/vehicles_input.c:34 -msgid "`s_service`" +#: ../../build/doc/concepts.rst:67 +msgid "``e_service``" msgstr "" -#: ../../src/common/vehicles_input.c:34 -msgid "The duration of the unloading at the ending location." +#: ../../build/doc/concepts.rst:70 +msgid "The duration of any task at the ending location" msgstr "" -#: ../../src/common/vehicles_input.c:37 -msgid "" -"Throws: * When column `id` is missing * When column `capacity` is missing" -" * When column `s_id` is missing * When column `s_tw_open` exists but not" -" `s_tw_close` * When column `s_tw_close`exists but not `s_tw_open` * When" -" column `e_tw_open` exists but not `e_tw_close` * When column " -"`e_tw_close`exists but not `e_tw_open`" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:174 +msgid "Matrix SQL" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:118 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:5 +msgid "``start_vid, end_vid, agg_cost``" msgstr "" -#: ../../src/common/matrixRows_input.c:12 -msgid "**start_vid**" +#: ../../build/doc/concepts.rst:14 +msgid "``start_vid``" msgstr "" -#: ../../src/common/matrixRows_input.c:12 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:19 msgid "Identifier of a node." msgstr "" -#: ../../src/common/matrixRows_input.c:13 -msgid "**end_vid**" +#: ../../build/doc/concepts.rst:17 +msgid "``end_vid``" msgstr "" -#: ../../src/common/matrixRows_input.c:13 -msgid "Identifier of a node" +#: ../../build/doc/concepts.rst:20 +msgid "``agg_cost``" msgstr "" -#: ../../src/common/matrixRows_input.c:14 -msgid "**agg_cost**" +#: ../../build/doc/concepts.rst:22 +msgid "Cost to travel from ``start_vid`` to ``end_vid``" msgstr "" -#: ../../src/common/matrixRows_input.c:14 -msgid "Time to travel from ``start_vid`` to ``end_vid``" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:181 +msgid "Result Columns" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:125 -msgid "Result Columns" +#: ../../build/doc/concepts.rst:3 +msgid "Returns set of" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -msgid "**seq**" +#: ../../build/doc/concepts.rst:5 +msgid "" +"``seq, vehicle_number, vehicle_id, stop_seq, stop_type, stop_id, " +"order_id, cargo,``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:17 -msgid "INTEGER" +#: ../../build/doc/concepts.rst:15 +msgid "``seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 +#: ../../build/doc/concepts.rst:17 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 +#: ../../build/doc/concepts.rst:20 msgid "" "Sequential value starting from **1** for current vehicles. The " ":math:`n_{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:22 +msgid "``vehicle_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:18 -msgid "BIGINT" +#: ../../build/doc/concepts.rst:23 ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:49 ../../build/doc/concepts.rst:54 +#: ../../build/doc/concepts.rst:57 ../../build/doc/concepts.rst:60 +#: ../../build/doc/concepts.rst:63 +msgid "``BIGINT``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 +#: ../../build/doc/concepts.rst:24 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 -msgid "**stop_seq**" +#: ../../build/doc/concepts.rst:25 +msgid "``stop_seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 +#: ../../build/doc/concepts.rst:27 msgid "" "Sequential value starting from **1** for the stops made by the current " "vehicle. The :math:`m_{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 -msgid "**stop_type**" +#: ../../build/doc/concepts.rst:29 +msgid "``stop_type``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 +#: ../../build/doc/concepts.rst:31 msgid "Kind of stop location the vehicle is at:" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:12 +#: ../../build/doc/concepts.rst:33 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:13 +#: ../../build/doc/concepts.rst:34 msgid "``2``: Pickup location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:14 +#: ../../build/doc/concepts.rst:35 msgid "``3``: Delivery location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:15 +#: ../../build/doc/concepts.rst:36 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:17 -msgid "**stop_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``stop_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:18 -msgid "**order_id**" +#: ../../build/doc/concepts.rst:39 +msgid "Identifier of the stop." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:18 -msgid "Pickup-Delivery order pair identifier." +#: ../../build/doc/concepts.rst:40 +msgid "``order_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:20 -msgid "``-1``: When no order is involved on the current stop location." +#: ../../build/doc/concepts.rst:42 +msgid "Pickup-Delivery order pair identifier." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:22 -msgid "**cargo**" +#: ../../build/doc/concepts.rst:44 +msgid "``-1``: When no order is involved on the current stop location." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:22 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:24 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:28 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:29 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:30 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:31 -msgid "FLOAT" +#: ../../build/doc/concepts.rst:45 +msgid "``cargo``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:22 +#: ../../build/doc/concepts.rst:47 msgid "Cargo units of the vehicle when leaving the stop." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:24 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:48 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:24 +#: ../../build/doc/concepts.rst:50 msgid "Travel time from previous ``stop_seq`` to current ``stop_seq``." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:26 +#: ../../build/doc/concepts.rst:52 msgid "``0`` When ``stop_type = 1``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:28 -msgid "**arrival_time**" +#: ../../build/doc/concepts.rst:53 +msgid "``arrival_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:28 +#: ../../build/doc/concepts.rst:55 msgid "Previous ``departure_time`` plus current ``travel_time``." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:29 -msgid "**wait_time**" +#: ../../build/doc/concepts.rst:56 +msgid "``wait_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:29 +#: ../../build/doc/concepts.rst:58 msgid "Time spent waiting for current `location` to open." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:30 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:59 +msgid "``service_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:30 +#: ../../build/doc/concepts.rst:61 msgid "Service time at current `location`." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:31 -msgid "**departure_time**" +#: ../../build/doc/concepts.rst:62 +msgid "``departure_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:31 +#: ../../build/doc/concepts.rst:64 msgid ":math:`arrival\\_time + wait\\_time + service\\_time`." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:33 +#: ../../build/doc/concepts.rst:66 msgid "When ``stop_type = 6`` has the `total_time` used for the current vehicle." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:132 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:188 msgid "Example" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:136 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:192 msgid "This example use the following data:" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:144 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:200 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:146 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:202 msgid ":doc:`pgr-category`" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:147 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:203 msgid "The queries use the :doc:`sampledata` network." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:150 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:206 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:151 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:207 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:152 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:208 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/vrp_pgr_pickDeliverEuclidean.po b/locale/en/LC_MESSAGES/vrp_pgr_pickDeliverEuclidean.po index 057368337..1b3b851d8 100644 --- a/locale/en/LC_MESSAGES/vrp_pgr_pickDeliverEuclidean.po +++ b/locale/en/LC_MESSAGES/vrp_pgr_pickDeliverEuclidean.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.0.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-09-28 10:43+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:12 msgid "" @@ -231,598 +231,618 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:91 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:85 +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst +msgid "``pgr_pickDeliverEuclidean(``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst +msgid "`Orders SQL`_, `Vehicles SQL`_" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst +msgid "``[factor, max_cycles, initial_sol]``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst +msgid "``seq, vehicle_number, vehicle_id, stop, order_id, stop_type, cargo,``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst +msgid "``travel_time, arrival_time, wait_time, service_time, departure_time``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:96 msgid "Parameters" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 -#: ../../src/common/orders_input.c:13 ../../src/common/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:105 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:127 msgid "Column" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 -#: ../../src/common/orders_input.c:13 ../../src/common/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:13 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:106 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:128 msgid "Type" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 -#: ../../src/common/orders_input.c:13 ../../src/common/vehicles_input.c:12 -msgid "Default" -msgstr "" - -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 -#: ../../src/common/orders_input.c:13 ../../src/common/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:107 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:130 msgid "Description" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -msgid "**Orders SQL**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:108 +msgid "`Orders SQL`_" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:109 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:112 msgid "``TEXT``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -msgid "`Orders SQL`_ query contianing the orders to be processed." +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:110 +msgid "`Orders SQL`_ as described below." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:111 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 -msgid "`Vehicles SQL`_ query containing the vehicles to be used." +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:113 +msgid "`Vehicles SQL`_ as described below." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 -msgid "**factor**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:118 +msgid "Optional Parameters" +msgstr "" + +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:16 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:129 +msgid "Default" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:131 +msgid "``factor``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:132 msgid "``NUMERIC``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:133 msgid "1" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:134 msgid "Travel time multiplier. See :ref:`pd_factor`" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 -msgid "**max_cycles**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:135 +msgid "``max_cycles``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:136 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:140 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:137 msgid "10" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:138 msgid "Maximum number of cycles to perform on the optimization." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 -msgid "**initial_sol**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:139 +msgid "``initial_sol``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:141 msgid "4" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:142 msgid "Initial solution to be used." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:12 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:144 msgid "``1`` One order per truck" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:13 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:145 msgid "``2`` Push front order." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:14 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:146 msgid "``3`` Push back order." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:15 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:147 msgid "``4`` Optimize insert." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:16 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:148 msgid "``5`` Push back order that allows more orders to be inserted at the back" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:17 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:150 msgid "``6`` Push front order that allows more orders to be inserted at the front" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:99 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:156 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:103 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:160 msgid "Orders SQL" msgstr "" -#: ../../src/common/orders_input.c:3 ../../src/common/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/orders_input.c:15 ../../src/common/vehicles_input.c:14 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, amount``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``p_x, p_y, p_tw_open, p_tw_close, [p_service,]``" +msgstr "" + +#: ../../build/doc/concepts.rst:7 +msgid "``d_x, d_y, d_tw_open, d_tw_close, [d_service]``" msgstr "" -#: ../../src/common/orders_input.c:15 ../../src/common/orders_input.c:16 -#: ../../src/common/orders_input.c:19 ../../src/common/orders_input.c:20 -#: ../../src/common/orders_input.c:21 ../../src/common/orders_input.c:24 -#: ../../src/common/orders_input.c:25 ../../src/common/orders_input.c:26 -#: ../../src/common/vehicles_input.c:14 +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:18 +msgid "``id``" +msgstr "" + +#: ../../build/doc/concepts.rst:18 ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:38 ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:42 ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:48 ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:60 ../../build/doc/concepts.rst:61 +#: ../../build/doc/concepts.rst:64 ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:70 msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/orders_input.c:15 +#: ../../build/doc/concepts.rst:21 msgid "Identifier of the pick-delivery order pair." msgstr "" -#: ../../src/common/orders_input.c:16 -msgid "**amount**" +#: ../../build/doc/concepts.rst:22 +msgid "``amount``" msgstr "" -#: ../../src/common/orders_input.c:16 -msgid "Number of units in the order" +#: ../../build/doc/concepts.rst:23 ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:49 ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:53 ../../build/doc/concepts.rst:56 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/orders_input.c:17 -msgid "**p_x**" +#: ../../build/doc/concepts.rst:25 +msgid "Number of units in the order." msgstr "" -#: ../../src/common/orders_input.c:17 ../../src/common/orders_input.c:18 -#: ../../src/common/orders_input.c:22 ../../src/common/orders_input.c:23 -#: ../../src/common/vehicles_input.c:15 ../../src/common/vehicles_input.c:16 -#: ../../src/common/vehicles_input.c:17 ../../src/common/vehicles_input.c:18 -#: ../../src/common/vehicles_input.c:19 ../../src/common/vehicles_input.c:22 -#: ../../src/common/vehicles_input.c:25 ../../src/common/vehicles_input.c:26 -#: ../../src/common/vehicles_input.c:29 ../../src/common/vehicles_input.c:32 -#: ../../src/common/vehicles_input.c:33 ../../src/common/vehicles_input.c:36 -msgid "|ANY-NUMERICAL|" +#: ../../build/doc/concepts.rst:26 +msgid "``p_x``" msgstr "" -#: ../../src/common/orders_input.c:17 -msgid ":math:`x` value of the pick up location" +#: ../../build/doc/concepts.rst:29 +msgid ":math:`x` value of the pickup location." msgstr "" -#: ../../src/common/orders_input.c:18 -msgid "**p_y**" +#: ../../build/doc/concepts.rst:30 +msgid "``p_y``" msgstr "" -#: ../../src/common/orders_input.c:18 -msgid ":math:`y` value of the pick up location" +#: ../../build/doc/concepts.rst:33 +msgid ":math:`y` value of the pickup location." msgstr "" -#: ../../src/common/orders_input.c:19 -msgid "**p_tw_open**" +#: ../../build/doc/concepts.rst:34 +msgid "``p_tw_open``" msgstr "" -#: ../../src/common/orders_input.c:19 +#: ../../build/doc/concepts.rst:37 msgid "The time, relative to 0, when the pickup location opens." msgstr "" -#: ../../src/common/orders_input.c:20 -msgid "**p_tw_close**" +#: ../../build/doc/concepts.rst:38 +msgid "``p_tw_close``" msgstr "" -#: ../../src/common/orders_input.c:20 +#: ../../build/doc/concepts.rst:41 msgid "The time, relative to 0, when the pickup location closes." msgstr "" -#: ../../src/common/orders_input.c:21 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:43 +msgid ":math:`p\\_tw\\_open < p\\_tw\\_close < 9223372036854775807`" msgstr "" -#: ../../src/common/orders_input.c:21 ../../src/common/orders_input.c:26 +#: ../../build/doc/concepts.rst:44 +msgid "``p_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:39 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:49 ../../build/doc/concepts.rst:68 msgid "0" msgstr "" -#: ../../src/common/orders_input.c:21 +#: ../../build/doc/concepts.rst:47 msgid "The duration of the loading at the pickup location." msgstr "" -#: ../../src/common/orders_input.c:22 -msgid "**d_x**" +#: ../../build/doc/concepts.rst:48 +msgid "``d_x``" msgstr "" -#: ../../src/common/orders_input.c:22 -msgid ":math:`x` value of the delivery location" +#: ../../build/doc/concepts.rst:51 +msgid ":math:`x` value of the delivery location." msgstr "" -#: ../../src/common/orders_input.c:23 -msgid "**d_y**" +#: ../../build/doc/concepts.rst:52 +msgid "``d_y``" msgstr "" -#: ../../src/common/orders_input.c:23 -msgid ":math:`y` value of the delivery location" +#: ../../build/doc/concepts.rst:55 +msgid ":math:`y` value of the delivery location." msgstr "" -#: ../../src/common/orders_input.c:24 -msgid "**d_tw_open**" +#: ../../build/doc/concepts.rst:56 +msgid "``d_tw_open``" msgstr "" -#: ../../src/common/orders_input.c:24 +#: ../../build/doc/concepts.rst:59 msgid "The time, relative to 0, when the delivery location opens." msgstr "" -#: ../../src/common/orders_input.c:25 -msgid "**d_tw_close**" +#: ../../build/doc/concepts.rst:60 +msgid "``d_tw_close``" msgstr "" -#: ../../src/common/orders_input.c:25 +#: ../../build/doc/concepts.rst:63 msgid "The time, relative to 0, when the delivery location closes." msgstr "" -#: ../../src/common/orders_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:65 +msgid ":math:`d\\_tw\\_open < d\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/orders_input.c:26 -msgid "The duration of the loading at the delivery location." +#: ../../build/doc/concepts.rst:66 +msgid "``d_service``" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:110 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:69 +msgid "The duration of the unloading at the delivery location." msgstr "" -#: ../../src/common/vehicles_input.c:14 -msgid "Identifier of the vehicle" -msgstr "" - -#: ../../src/common/vehicles_input.c:15 -msgid "**capacity**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:167 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vehicles_input.c:15 -msgid "Capacity of the vehicle" +#: ../../build/doc/concepts.rst:5 +msgid "``id, capacity, [speed,]``" msgstr "" -#: ../../src/common/vehicles_input.c:16 -msgid "**speed**" +#: ../../build/doc/concepts.rst:6 +msgid "``s_x, s_y, [s_tw_open, s_tw_close, s_service]``" msgstr "" -#: ../../src/common/vehicles_input.c:16 -msgid "`1`" +#: ../../build/doc/concepts.rst:7 +msgid "``[e_x, e_y, e_tw_open, e_tw_close, e_service]``" msgstr "" -#: ../../src/common/vehicles_input.c:16 -msgid "Average speed of the vehicle." +#: ../../build/doc/concepts.rst:20 +msgid "Identifier of the vehicle." msgstr "" -#: ../../src/common/vehicles_input.c:17 -msgid "**s_x**" +#: ../../build/doc/concepts.rst:21 +msgid "``capacity``" msgstr "" -#: ../../src/common/vehicles_input.c:17 -msgid ":math:`x` value of the coordinate of the starting location." +#: ../../build/doc/concepts.rst:24 +msgid "Capacity of the vehicle. :math:`0 < capacity <= 4294967295`." msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid "**s_y**" +#: ../../build/doc/concepts.rst:25 +msgid "``speed``" msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid ":math:`y` value of the coordinate of the starting location." +#: ../../build/doc/concepts.rst:28 +msgid "Speed of the vehicle." msgstr "" -#: ../../src/common/vehicles_input.c:19 -msgid "**s_tw_open**" +#: ../../build/doc/concepts.rst:29 +msgid "``s_x``" msgstr "" -#: ../../src/common/vehicles_input.c:19 ../../src/common/vehicles_input.c:25 -msgid "`0`" +#: ../../build/doc/concepts.rst:32 +msgid ":math:`x` value of the coordinate of the starting location." msgstr "" -#: ../../src/common/vehicles_input.c:19 -msgid "" -"The time, relative to 0, when the starting location opens. When " -"`s_tw_open` column exist then `s_tw_close` column is expected Default " -"value when (`s_tw_open`, s_tw_close) columns do not exist" +#: ../../build/doc/concepts.rst:33 +msgid "``s_y``" msgstr "" -#: ../../src/common/vehicles_input.c:22 -msgid "**s_tw_close**" +#: ../../build/doc/concepts.rst:36 +msgid ":math:`y` value of the coordinate of the starting location." msgstr "" -#: ../../src/common/vehicles_input.c:22 -msgid "`INFINITY`" +#: ../../build/doc/concepts.rst:37 ../../build/doc/concepts.rst:61 +msgid "``s_tw_open``" msgstr "" -#: ../../src/common/vehicles_input.c:22 -msgid "" -"The time, relative to 0, when the starting location closes. When " -"`s_tw_close` column exist then `e_tw_open` column is expected Default " -"value when `(s_tw_open, s_tw_close)` columns do not exist" +#: ../../build/doc/concepts.rst:40 +msgid "The time, relative to 0, when the starting location opens." msgstr "" -#: ../../src/common/vehicles_input.c:25 -msgid "**s_service**" +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:65 +msgid "``s_tw_close``" msgstr "" -#: ../../src/common/vehicles_input.c:25 -msgid "The duration of the loading at the starting location." +#: ../../build/doc/concepts.rst:43 +msgid "|MAX-BIGINT|" msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "**e_tw_open**" +#: ../../build/doc/concepts.rst:44 +msgid "The time, relative to 0, when the starting location closes." msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "`s_tw_open`" +#: ../../build/doc/concepts.rst:46 +msgid ":math:`s\\_tw\\_open < s\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "" -"The time, relative to 0, when the ending location opens. When `e_tw_open`" -" column exist then `e__tw_close` column is expected Default value when " -"(`e_tw_open`, e_tw_close) columns do not exist" +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:71 +msgid "``s_service``" msgstr "" -#: ../../src/common/vehicles_input.c:29 -msgid "**e_tw_close**" +#: ../../build/doc/concepts.rst:50 +msgid "Duration of any task at the ending location," msgstr "" -#: ../../src/common/vehicles_input.c:29 -msgid "`s_tw_close`" +#: ../../build/doc/concepts.rst:51 +msgid "``e_x``" msgstr "" -#: ../../src/common/vehicles_input.c:29 -msgid "" -"The time, relative to 0, when the ending location closes. When " -"`e_tw_close` column exist then `e_tw_open` column is expected Default " -"value when `(e_tw_open`, e_tw_close)` columns do not exist" +#: ../../build/doc/concepts.rst:54 +msgid ":math:`x` value of the coordinate of the ending location." msgstr "" -#: ../../src/common/vehicles_input.c:32 -msgid "**e_service**" +#: ../../build/doc/concepts.rst:55 +msgid "``e_y``" msgstr "" -#: ../../src/common/vehicles_input.c:32 -msgid "`s_service`" +#: ../../build/doc/concepts.rst:58 +msgid ":math:`y` value of the coordinate of the ending location." msgstr "" -#: ../../src/common/vehicles_input.c:32 -msgid "The duration of the loading at the ending location." +#: ../../build/doc/concepts.rst:59 +msgid "``e_tw_open``" msgstr "" -#: ../../src/common/vehicles_input.c:33 -msgid "**e_x**" +#: ../../build/doc/concepts.rst:62 +msgid "The time, relative to 0, when the ending location opens." msgstr "" -#: ../../src/common/vehicles_input.c:33 -msgid "`s_x`" +#: ../../build/doc/concepts.rst:63 +msgid "``e_tw_close``" msgstr "" -#: ../../src/common/vehicles_input.c:33 -msgid "" -":math:`x` value of the coordinate of the ending location. Default value " -"when `(e_x, e_y)` columns do not exist Default value when `e_y` column " -"does not exist" +#: ../../build/doc/concepts.rst:66 +msgid "The time, relative to 0, when the ending location closes." msgstr "" -#: ../../src/common/vehicles_input.c:36 -msgid "**e_y**" +#: ../../build/doc/concepts.rst:68 +msgid ":math:`e\\_tw\\_open < e\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/vehicles_input.c:36 -msgid "`s_y`" +#: ../../build/doc/concepts.rst:69 +msgid "``e_service``" msgstr "" -#: ../../src/common/vehicles_input.c:36 -msgid "" -":math:`y` value of the coordinate of the ending location. When `e_y` " -"column exist then `e_x` column is expected Default value when `(e_x, " -"e_y)` columns do not exist" +#: ../../build/doc/concepts.rst:72 +msgid "The duration of any task at the ending location" msgstr "" -#: ../../src/common/vehicles_input.c:41 -msgid "" -"Throws: * When column `id` is missing * When column `capacity` is missing" -" * When column `s_x` is missing * When column `s_y` is missing * When " -"column `s_tw_open` exists but not `s_tw_close` * When column " -"`s_tw_close`exists but not `s_tw_open` * When column `e_y` exists but not" -" `e_x` * When column `e_x` exists but not `e_y` * When column `e_tw_open`" -" exists but not `e_tw_close` * When column `e_tw_close`exists but not " -"`e_tw_open`" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:175 +msgid "Result Columns" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:118 -msgid "Result Columns" +#: ../../build/doc/concepts.rst:3 +msgid "Returns set of" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -msgid "**seq**" +#: ../../build/doc/concepts.rst:5 +msgid "``seq, vehicle_seq, vehicle_id, stop_seq, stop_type, order_id, cargo,``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 -msgid "INTEGER" +#: ../../build/doc/concepts.rst:15 +msgid "``seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 +#: ../../build/doc/concepts.rst:17 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 +#: ../../build/doc/concepts.rst:20 msgid "" "Sequential value starting from **1** for current vehicles. The " ":math:`n_{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:22 +msgid "``vehicle_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:17 -msgid "BIGINT" +#: ../../build/doc/concepts.rst:23 ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:43 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:51 ../../build/doc/concepts.rst:54 +#: ../../build/doc/concepts.rst:57 ../../build/doc/concepts.rst:60 +msgid "``BIGINT``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 +#: ../../build/doc/concepts.rst:24 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 -msgid "**stop_seq**" +#: ../../build/doc/concepts.rst:25 +msgid "``stop_seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 +#: ../../build/doc/concepts.rst:27 msgid "" "Sequential value starting from **1** for the stops made by the current " "vehicle. The :math:`m_{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 -msgid "**stop_type**" +#: ../../build/doc/concepts.rst:29 +msgid "``stop_type``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 +#: ../../build/doc/concepts.rst:31 msgid "Kind of stop location the vehicle is at:" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:12 +#: ../../build/doc/concepts.rst:33 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:13 +#: ../../build/doc/concepts.rst:34 msgid "``2``: Pickup location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:14 +#: ../../build/doc/concepts.rst:35 msgid "``3``: Delivery location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:15 +#: ../../build/doc/concepts.rst:36 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:17 -msgid "**order_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``order_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:17 +#: ../../build/doc/concepts.rst:39 msgid "Pickup-Delivery order pair identifier." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:19 +#: ../../build/doc/concepts.rst:41 msgid "``-1``: When no order is involved on the current stop location." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:21 -msgid "**cargo**" +#: ../../build/doc/concepts.rst:42 +msgid "``cargo``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:21 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:23 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:27 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:28 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:29 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:30 -msgid "FLOAT" -msgstr "" - -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:21 +#: ../../build/doc/concepts.rst:44 msgid "Cargo units of the vehicle when leaving the stop." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:23 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:45 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:23 +#: ../../build/doc/concepts.rst:47 msgid "Travel time from previous ``stop_seq`` to current ``stop_seq``." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:25 +#: ../../build/doc/concepts.rst:49 msgid "``0`` When ``stop_type = 1``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:27 -msgid "**arrival_time**" +#: ../../build/doc/concepts.rst:50 +msgid "``arrival_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:27 +#: ../../build/doc/concepts.rst:52 msgid "Previous ``departure_time`` plus current ``travel_time``." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:28 -msgid "**wait_time**" +#: ../../build/doc/concepts.rst:53 +msgid "``wait_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:28 +#: ../../build/doc/concepts.rst:55 msgid "Time spent waiting for current `location` to open." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:29 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:56 +msgid "``service_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:29 +#: ../../build/doc/concepts.rst:58 msgid "Service time at current `location`." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:30 -msgid "**departure_time**" +#: ../../build/doc/concepts.rst:59 +msgid "``departure_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:30 +#: ../../build/doc/concepts.rst:61 msgid ":math:`arrival\\_time + wait\\_time + service\\_time`." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:32 +#: ../../build/doc/concepts.rst:63 msgid "When ``stop_type = 6`` has the `total_time` used for the current vehicle." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:126 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:183 msgid "Example" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:130 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:187 msgid "This example use the following data:" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:139 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:196 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:140 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:197 msgid ":doc:`pgr-category`" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:141 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:198 msgid "The queries use the :doc:`sampledata` network." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:144 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:201 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:145 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:202 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:146 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:203 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/vrp_vroom.po b/locale/en/LC_MESSAGES/vrp_vroom.po index eea5dc828..a28b659c5 100644 --- a/locale/en/LC_MESSAGES/vrp_vroom.po +++ b/locale/en/LC_MESSAGES/vrp_vroom.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.3.0-dev\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/vrp_vroom.rst:12 msgid "" @@ -128,14 +128,11 @@ msgstr "" msgid "New **experimental** function" msgstr "" -#: ../../build/doc/vrp_vroom.rst:39 ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 ../../build/doc/vrp_vroom.rst:39 +#: ../../build/doc/vrp_vroom.rst:85 ../../build/doc/vrp_vroom.rst:125 msgid "Description" msgstr "" @@ -151,656 +148,680 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_vroom.rst:53 -msgid "Summary" +#: ../../build/doc/vrp_vroom.rst:52 +msgid "\\ \\" msgstr "" -#: ../../build/doc/vrp_vroom.rst:58 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroom.rst +msgid "vrp_vroom(" msgstr "" -#: ../../build/doc/vrp_vroom.rst:61 -msgid "Using defaults" +#: ../../build/doc/vrp_vroom.rst +msgid "`Jobs SQL`_, `Jobs Time Windows SQL`_," msgstr "" -#: ../../build/doc/vrp_vroom.rst:66 +#: ../../build/doc/vrp_vroom.rst +msgid "`Shipments SQL`_, `Shipments Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroom.rst +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroom.rst +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroom.rst ../../build/doc/vrp_vroom.rst:107 +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroom.rst +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" +msgstr "" + +#: ../../build/doc/vrp_vroom.rst +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_vroom.rst +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," +msgstr "" + +#: ../../build/doc/vrp_vroom.rst +msgid "" +"task_data, arrival, travel_time, service_time, waiting_time, departure, " +"load)" +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:67 msgid "" "**Example**: This example is based on the modified VROOM Data of the " ":doc:`sampledata` network. The modification in the tables is mentioned at" " the end of the :doc:`sampledata`." msgstr "" -#: ../../build/doc/vrp_vroom.rst:80 +#: ../../build/doc/vrp_vroom.rst:75 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 +#: ../../build/doc/vrp_vroom.rst:83 ../../build/doc/vrp_vroom.rst:122 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:13 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:28 ../../build/doc/concepts.rst:30 +#: ../../build/doc/vrp_vroom.rst:84 ../../build/doc/vrp_vroom.rst:123 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**Jobs SQL**" +#: ../../build/doc/vrp_vroom.rst:86 +msgid "`Jobs SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 ../../build/sql/vroom/vrp_vroom.sql:8 -#: ../../build/sql/vroom/vrp_vroom.sql:10 -#: ../../build/sql/vroom/vrp_vroom.sql:12 -#: ../../build/sql/vroom/vrp_vroom.sql:14 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:16 -#: ../../build/sql/vroom/vrp_vroom.sql:18 +#: ../../build/doc/vrp_vroom.rst:87 ../../build/doc/vrp_vroom.rst:90 +#: ../../build/doc/vrp_vroom.rst:93 ../../build/doc/vrp_vroom.rst:96 +#: ../../build/doc/vrp_vroom.rst:99 ../../build/doc/vrp_vroom.rst:102 +#: ../../build/doc/vrp_vroom.rst:105 ../../build/doc/vrp_vroom.rst:108 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "" -"`Jobs SQL`_ query describing the single-location pickup and/or delivery " -"tasks." +#: ../../build/doc/vrp_vroom.rst:88 +msgid "Query describing the single-location pickup and/or delivery" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 -msgid "**Jobs Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:89 +msgid "`Jobs Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for job service start." +#: ../../build/doc/vrp_vroom.rst:91 +msgid "Query describing valid slots for job service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:10 -msgid "**Shipments SQL**" +#: ../../build/doc/vrp_vroom.rst:92 +msgid "`Shipments SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:10 +#: ../../build/doc/vrp_vroom.rst:94 msgid "" -"`Shipments SQL`_ query describing pickup and delivery tasks that should " -"happen within same route." +"Query describing pickup and delivery tasks that should happen within same" +" route." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:12 -msgid "**Shipments Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:95 +msgid "`Shipments Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:12 -msgid "" -"`Time Windows SQL`_ query describing valid slots for pickup and delivery " -"service start." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:14 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroom.rst:97 +msgid "Query describing valid slots for pickup and delivery service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:14 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroom.rst:98 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroom.rst:100 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroom.rst:101 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:103 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroom.rst:104 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroom.rst:106 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -msgid "" -"`Time Matrix SQL`_ query containing the distance or travel times between " -"the locations." +#: ../../build/doc/vrp_vroom.rst:109 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/doc/vrp_vroom.rst:87 +#: ../../build/doc/vrp_vroom.rst:114 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:31 +#: ../../build/doc/vrp_vroom.rst:124 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroom.rst:126 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 ../../build/sql/vroom/vrp_vroom.sql:33 -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:85 ../../build/doc/vrp_vroom.rst:127 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:128 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:129 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 +#: ../../build/doc/vrp_vroom.rst:131 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:9 +#: ../../build/doc/vrp_vroom.rst:132 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroom.rst:133 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:134 msgid "``INTERVAL``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:135 msgid "'-00:00:01'::INTERVAL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:136 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/vrp_vroom.rst:138 msgid "" "Gives the best possible solution within a time limit. Note that some " "additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 +#: ../../build/doc/vrp_vroom.rst:140 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroom.rst:94 +#: ../../build/doc/vrp_vroom.rst:145 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroom.rst:97 +#: ../../build/doc/vrp_vroom.rst:148 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:62 ../../build/doc/concepts.rst:78 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:18 ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:29 msgid "Column" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:33 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:34 ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../src/common/vroom/jobs_input.c:16 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:45 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:43 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:20 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:80 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 +#: ../../build/doc/concepts.rst:51 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" delivery such as number of items, weight, volume etc." +" pickup such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:26 -msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" +#: ../../build/doc/concepts.rst:54 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 +#: ../../build/doc/concepts.rst:58 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" pickup such as number of items, weight, volume etc." +" delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:33 -msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +#: ../../build/doc/concepts.rst:61 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:65 +#: ../../build/doc/concepts.rst:81 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:68 ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:69 ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/concepts.rst:30 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:73 +msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "**data**" +#: ../../build/doc/vrp_vroom.rst:155 +msgid "Jobs Time Windows SQL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:18 +msgid "" +"Positive unique identifier of the: job, pickup/delivery shipment, or " +"break." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -msgid "Any metadata information of the job." +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:23 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/jobs_input.c ../../src/common/vroom/shipments_input.c -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../build/doc/vrp_vroom.rst:104 +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:162 msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:44 ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:48 ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 ../../build/doc/concepts.rst:72 msgid "" "Array of non-negative integers describing multidimensional quantities " "such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 +#: ../../build/doc/concepts.rst:75 msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" +#: ../../build/doc/vrp_vroom.rst:169 +msgid "Shipments Time Windows SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "**start_id**" +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/vrp_vroom.rst:176 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|tw_close_default|" +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" +msgstr "" + +#: ../../build/doc/concepts.rst:59 +msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "" "Max value of speed factor for a vehicle shall not be greater than 5 times" " the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:73 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../src/common/vroom/vehicles_input.c:46 +#: ../../build/doc/concepts.rst:81 ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "" "If ``end_id`` is omitted, the resulting route will stop at the last " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "" "If ``start_id`` is omitted, the resulting route will start at the first " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "" "To request a round trip, specify both ``start_id`` and ``end_id`` as the " "same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "" "A vehicle is only allowed to serve a set of tasks if the resulting load " "at each route step is lower than the matching value in capacity for each " @@ -808,355 +829,307 @@ msgid "" "put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "" "It is assumed that all delivery-related amounts for jobs are loaded at " "vehicle start, while all pickup-related amounts for jobs are brought back" " at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroom.rst:183 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "" -"**Only required for shipments time windows**. Value in ['p', 'd'] " -"indicating whether the time window is for:" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroom.rst:190 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "" -"**Relative values**, e.g. [0, 14400] for a 4 hours time window starting " -"at the beginning of the planning horizon. In that case all times reported" -" in output with the arrival column are relative to the start of the " -"planning horizon." +#: ../../build/doc/vrp_vroom.rst:197 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "" -"**Absolute values**, \"real\" timestamps. In that case all times reported" -" in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" -msgstr "" - -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../build/doc/vrp_vroom.rst:115 +#: ../../build/doc/vrp_vroom.rst:204 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 +#: ../../build/doc/concepts.rst:23 msgid "" -"Sequential value starting from **1** for current vehicles. The " +"Sequential value starting from **1** for current vehicles. The " ":math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "" "Sequential value starting from **1** for the stops made by the current " "vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "" "The last step of every vehicle denotes the summary row, where the columns" " ``travel_time``, ``service_time`` and ``waiting_time`` denote the total " "time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "" "The last row denotes the summary for the complete problem, where the " "columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the" " total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroom.rst:122 +#: ../../build/doc/vrp_vroom.rst:211 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroom.rst:124 +#: ../../build/doc/vrp_vroom.rst:213 msgid "" "Problem involving 2 jobs and 1 shipment, using a single vehicle, similar " "to the VROOM Documentation `Example 2 `__ with a shipment." msgstr "" -#: ../../build/doc/vrp_vroom.rst:132 +#: ../../build/doc/vrp_vroom.rst:221 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroom.rst:134 +#: ../../build/doc/vrp_vroom.rst:223 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroom.rst:135 +#: ../../build/doc/vrp_vroom.rst:224 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -1178,15 +1151,15 @@ msgid "" "Project/vroom/blob/master/docs/API.md>`__" msgstr "" -#: ../../build/doc/vrp_vroom.rst:142 +#: ../../build/doc/vrp_vroom.rst:231 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroom.rst:143 +#: ../../build/doc/vrp_vroom.rst:232 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroom.rst:144 +#: ../../build/doc/vrp_vroom.rst:233 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/vrp_vroomJobs.po b/locale/en/LC_MESSAGES/vrp_vroomJobs.po index a6fefc641..de4a0e3d4 100644 --- a/locale/en/LC_MESSAGES/vrp_vroomJobs.po +++ b/locale/en/LC_MESSAGES/vrp_vroomJobs.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.3.0-dev\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/vrp_vroomJobs.rst:12 msgid "" @@ -128,14 +128,10 @@ msgstr "" msgid "New **experimental** function" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:39 ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 ../../build/doc/vrp_vroom.rst:10 +#: ../../build/doc/vrp_vroomJobs.rst:39 ../../build/doc/vrp_vroomJobs.rst:82 msgid "Description" msgstr "" @@ -151,520 +147,519 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:52 -msgid "Summary" +#: ../../build/doc/vrp_vroomJobs.rst:51 +msgid "\\ \\" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:57 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomJobs.rst +msgid "vrp_vroom(" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:60 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomJobs.rst +msgid "`Jobs SQL`_, `Jobs Time Windows SQL`_," msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:65 +#: ../../build/doc/vrp_vroomJobs.rst +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst ../../build/doc/vrp_vroomJobs.rst:98 +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst +msgid "" +"task_data, arrival, travel_time, service_time, waiting_time, departure, " +"load)" +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst:64 msgid "" "**Example**: This example is based on the modified VROOM Data of the " ":doc:`sampledata` network. The modification in the tables is mentioned at" " the end of the :doc:`sampledata`." msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:79 +#: ../../build/doc/vrp_vroomJobs.rst:72 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 +#: ../../build/doc/vrp_vroom.rst:7 ../../build/doc/vrp_vroomJobs.rst:80 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:13 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:28 ../../build/doc/vrp_vroom.rst:8 +#: ../../build/doc/vrp_vroomJobs.rst:81 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -msgid "**Jobs SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:83 +msgid "`Jobs SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 +#: ../../build/doc/vrp_vroomJobs.rst:84 ../../build/doc/vrp_vroomJobs.rst:87 +#: ../../build/doc/vrp_vroomJobs.rst:90 ../../build/doc/vrp_vroomJobs.rst:93 +#: ../../build/doc/vrp_vroomJobs.rst:96 ../../build/doc/vrp_vroomJobs.rst:99 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -msgid "" -"`Jobs SQL`_ query describing the single-location pickup and/or delivery " -"tasks." +#: ../../build/doc/vrp_vroomJobs.rst:85 +msgid "Query describing the single-location pickup and/or delivery" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -msgid "**Jobs Time Windows SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:86 +msgid "`Jobs Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for job service start." +#: ../../build/doc/vrp_vroomJobs.rst:88 +msgid "Query describing valid slots for job service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:89 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroomJobs.rst:91 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:92 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroomJobs.rst:94 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:95 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroomJobs.rst:97 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:100 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 -msgid "" -"`Time Matrix SQL`_ query containing the distance or travel times between " -"the locations." -msgstr "" - -#: ../../build/doc/vrp_vroomJobs.rst:86 +#: ../../build/doc/vrp_vroomJobs.rst:105 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 ../../build/doc/vrp_vroom.rst:9 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroom.rst:11 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 ../../build/sql/vroom/vrp_vroom.sql:33 -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:71 +#: ../../build/doc/vrp_vroom.rst:12 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:13 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:14 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 +#: ../../build/doc/vrp_vroom.rst:16 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:9 +#: ../../build/doc/vrp_vroom.rst:17 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroom.rst:18 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:19 msgid "``INTERVAL``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:20 msgid "'-00:00:01'::INTERVAL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:21 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/vrp_vroom.rst:23 msgid "" "Gives the best possible solution within a time limit. Note that some " "additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 +#: ../../build/doc/vrp_vroom.rst:25 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:93 +#: ../../build/doc/vrp_vroomJobs.rst:112 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:96 +#: ../../build/doc/vrp_vroomJobs.rst:115 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:62 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:66 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:20 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:27 msgid "Column" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "**id**" +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:31 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 ../../build/doc/concepts.rst:36 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../src/common/vroom/jobs_input.c:16 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:70 ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:46 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:20 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 +#: ../../build/doc/concepts.rst:51 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" delivery such as number of items, weight, volume etc." +" pickup such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:26 -msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" +#: ../../build/doc/concepts.rst:54 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 +#: ../../build/doc/concepts.rst:58 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" pickup such as number of items, weight, volume etc." +" delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:33 -msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +#: ../../build/doc/concepts.rst:61 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:65 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:68 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:69 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "**priority**" +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "0" +#: ../../build/doc/concepts.rst:30 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:64 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:73 +msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "**data**" +#: ../../build/doc/vrp_vroomJobs.rst:122 +msgid "Jobs Time Windows SQL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:17 +msgid "" +"Positive unique identifier of the: job, pickup/delivery shipment, or " +"break." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -msgid "Any metadata information of the job." +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:51 +msgid "``tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:52 ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -msgid "Where:" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/jobs_input.c -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../build/doc/vroom-category.rst:4 +#: ../../build/doc/vrp_vroomJobs.rst:129 msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/vehicles_input.c:14 +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:30 msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "**start_id**" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 msgid "" "Array of non-negative integers describing multidimensional quantities " "such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 +#: ../../build/doc/concepts.rst:45 msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "**tw_open**" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|timestamp|" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:30 +#: ../../build/doc/concepts.rst:53 msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "**tw_close**" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:32 +#: ../../build/doc/concepts.rst:59 msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "Time window closing time." -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "" "Max value of speed factor for a vehicle shall not be greater than 5 times" " the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:73 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../src/common/vroom/vehicles_input.c:46 +#: ../../build/doc/concepts.rst:81 ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "" "If ``end_id`` is omitted, the resulting route will stop at the last " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "" "If ``start_id`` is omitted, the resulting route will start at the first " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "" "To request a round trip, specify both ``start_id`` and ``end_id`` as the " "same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "" "A vehicle is only allowed to serve a set of tasks if the resulting load " "at each route step is lower than the matching value in capacity for each " @@ -672,355 +667,307 @@ msgid "" "put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "" "It is assumed that all delivery-related amounts for jobs are loaded at " "vehicle start, while all pickup-related amounts for jobs are brought back" " at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomJobs.rst:136 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "" -"**Only required for shipments time windows**. Value in ['p', 'd'] " -"indicating whether the time window is for:" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomJobs.rst:143 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "" -"**Relative values**, e.g. [0, 14400] for a 4 hours time window starting " -"at the beginning of the planning horizon. In that case all times reported" -" in output with the arrival column are relative to the start of the " -"planning horizon." +#: ../../build/doc/vrp_vroomJobs.rst:150 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "" -"**Absolute values**, \"real\" timestamps. In that case all times reported" -" in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" -msgstr "" - -#: ../../build/doc/vrp_vroomJobs.rst:107 +#: ../../build/doc/vrp_vroomJobs.rst:157 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 +#: ../../build/doc/concepts.rst:23 msgid "" -"Sequential value starting from **1** for current vehicles. The " +"Sequential value starting from **1** for current vehicles. The " ":math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "" "Sequential value starting from **1** for the stops made by the current " "vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "" "The last step of every vehicle denotes the summary row, where the columns" " ``travel_time``, ``service_time`` and ``waiting_time`` denote the total " "time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "" "The last row denotes the summary for the complete problem, where the " "columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the" " total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:114 +#: ../../build/doc/vrp_vroomJobs.rst:164 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:116 +#: ../../build/doc/vrp_vroomJobs.rst:166 msgid "" "Problem involving 2 jobs, using a single vehicle, corresponding to the " "VROOM Documentation `Example 2 `__." msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:124 +#: ../../build/doc/vrp_vroomJobs.rst:174 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:126 +#: ../../build/doc/vrp_vroomJobs.rst:176 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:127 +#: ../../build/doc/vrp_vroomJobs.rst:177 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -1042,15 +989,15 @@ msgid "" "Project/vroom/blob/master/docs/API.md>`__" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:134 +#: ../../build/doc/vrp_vroomJobs.rst:184 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:135 +#: ../../build/doc/vrp_vroomJobs.rst:185 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:136 +#: ../../build/doc/vrp_vroomJobs.rst:186 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/vrp_vroomJobsPlain.po b/locale/en/LC_MESSAGES/vrp_vroomJobsPlain.po index b30b1758b..fbbd3531f 100644 --- a/locale/en/LC_MESSAGES/vrp_vroomJobsPlain.po +++ b/locale/en/LC_MESSAGES/vrp_vroomJobsPlain.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.3.0-dev\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/vrp_vroomJobsPlain.rst:12 msgid "" @@ -108,39 +108,35 @@ msgstr "" msgid "Might depend on a deprecated function of vrpRouting" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:28 +#: ../../build/doc/vrp_vroomJobsPlain.rst:29 msgid "Availability" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:29 +#: ../../build/doc/vrp_vroomJobsPlain.rst:30 msgid "Version 0.3.0" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:31 +#: ../../build/doc/vrp_vroomJobsPlain.rst:32 msgid "Function **modified** for VROOM 1.11.0" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:33 +#: ../../build/doc/vrp_vroomJobsPlain.rst:34 msgid "Version 0.2.0" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:35 +#: ../../build/doc/vrp_vroomJobsPlain.rst:36 msgid "New **experimental** function" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:39 -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 ../../build/doc/vrp_vroomJobs.rst:9 +#: ../../build/doc/vrp_vroomJobsPlain.rst:40 +#: ../../build/doc/vrp_vroomPlain.rst:10 msgid "Description" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:41 +#: ../../build/doc/vrp_vroomJobsPlain.rst:42 msgid "" "VROOM is an open-source optimization engine that aims at providing good " "solutions to various real-life vehicle routing problems (VRP) within a " @@ -148,20 +144,50 @@ msgid "" "problem involving only jobs." msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:49 +#: ../../build/doc/vrp_vroomJobsPlain.rst:50 msgid "Signature" msgstr "" #: ../../build/doc/vrp_vroomJobsPlain.rst:52 -msgid "Summary" +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst +msgid "vrp_vroom(" +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst +msgid "`Jobs SQL`_, `Jobs Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst:25 ../../build/doc/vrp_vroomJobsPlain.rst +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:57 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomJobsPlain.rst +msgid "RETURNS SET OF" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:60 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomJobsPlain.rst +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst +msgid "" +"task_data, arrival, travel_time, service_time, waiting_time, departure, " +"load)" msgstr "" #: ../../build/doc/vrp_vroomJobsPlain.rst:65 @@ -170,500 +196,466 @@ msgid "" ":doc:`sampledata` network:" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:78 +#: ../../build/doc/vrp_vroomJobsPlain.rst:72 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 +#: ../../build/doc/vrp_vroomJobs.rst:7 ../../build/doc/vrp_vroomPlain.rst:7 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:13 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:28 ../../build/doc/vrp_vroomJobs.rst:8 +#: ../../build/doc/vrp_vroomPlain.rst:8 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -msgid "**Jobs SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:10 +msgid "`Jobs SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 +#: ../../build/doc/vrp_vroomJobs.rst:11 ../../build/doc/vrp_vroomJobs.rst:14 +#: ../../build/doc/vrp_vroomJobs.rst:17 ../../build/doc/vrp_vroomJobs.rst:20 +#: ../../build/doc/vrp_vroomJobs.rst:23 ../../build/doc/vrp_vroomJobs.rst:26 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -msgid "" -"`Jobs SQL`_ query describing the single-location pickup and/or delivery " -"tasks." +#: ../../build/doc/vrp_vroomJobs.rst:12 +msgid "Query describing the single-location pickup and/or delivery" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -msgid "**Jobs Time Windows SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:13 +msgid "`Jobs Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for job service start." +#: ../../build/doc/vrp_vroomJobs.rst:15 +msgid "Query describing valid slots for job service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:16 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroomJobs.rst:18 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:19 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroomJobs.rst:21 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:22 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroomJobs.rst:24 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 -msgid "**Matrix SQL**" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 -msgid "" -"`Time Matrix SQL`_ query containing the distance or travel times between " -"the locations." +#: ../../build/doc/vrp_vroomJobs.rst:27 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:85 +#: ../../build/doc/vrp_vroomJobsPlain.rst:79 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 ../../build/doc/vrp_vroomPlain.rst:9 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroomPlain.rst:11 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:71 +#: ../../build/doc/vrp_vroomPlain.rst:12 ../../build/doc/vrp_vroomPlain.rst:19 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:13 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:14 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:8 +#: ../../build/doc/vrp_vroomPlain.rst:16 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:9 +#: ../../build/doc/vrp_vroomPlain.rst:17 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroomPlain.rst:18 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:20 msgid ":math:`-1`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:21 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:13 +#: ../../build/doc/vrp_vroomPlain.rst:23 msgid "" "Gives the best possible solution within a time limit. Note that some " "additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:16 +#: ../../build/doc/vrp_vroomPlain.rst:25 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:92 +#: ../../build/doc/vrp_vroomJobsPlain.rst:86 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:95 +#: ../../build/doc/vrp_vroomJobsPlain.rst:89 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:62 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:66 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:20 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:27 msgid "Column" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "**id**" +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:31 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 ../../build/doc/concepts.rst:36 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../src/common/vroom/jobs_input.c:16 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:70 ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:46 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:20 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 +#: ../../build/doc/concepts.rst:51 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" delivery such as number of items, weight, volume etc." +" pickup such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:26 -msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" +#: ../../build/doc/concepts.rst:54 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 +#: ../../build/doc/concepts.rst:58 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" pickup such as number of items, weight, volume etc." +" delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:33 -msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +#: ../../build/doc/concepts.rst:61 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:65 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:68 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:69 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "**priority**" +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "0" +#: ../../build/doc/concepts.rst:30 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:64 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:73 +msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "**data**" +#: ../../build/doc/vrp_vroomJobsPlain.rst:96 +msgid "Jobs Time Windows SQL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:17 +msgid "" +"Positive unique identifier of the: job, pickup/delivery shipment, or " +"break." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -msgid "Any metadata information of the job." +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:51 +msgid "``tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:52 ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -msgid "Where:" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/jobs_input.c -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../build/doc/vroom-category.rst:4 +#: ../../build/doc/vrp_vroomJobsPlain.rst:103 msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/vehicles_input.c:14 +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:30 msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "**start_id**" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 msgid "" "Array of non-negative integers describing multidimensional quantities " "such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 +#: ../../build/doc/concepts.rst:45 msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "**tw_open**" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|timestamp|" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:30 +#: ../../build/doc/concepts.rst:53 msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "Time window opening time." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 +#: ../../build/doc/concepts.rst:59 msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "" "Max value of speed factor for a vehicle shall not be greater than 5 times" " the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:73 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../src/common/vroom/vehicles_input.c:46 +#: ../../build/doc/concepts.rst:81 ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "" "If ``end_id`` is omitted, the resulting route will stop at the last " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "" "If ``start_id`` is omitted, the resulting route will start at the first " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "" "To request a round trip, specify both ``start_id`` and ``end_id`` as the " "same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "" "A vehicle is only allowed to serve a set of tasks if the resulting load " "at each route step is lower than the matching value in capacity for each " @@ -671,355 +663,307 @@ msgid "" "put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "" "It is assumed that all delivery-related amounts for jobs are loaded at " "vehicle start, while all pickup-related amounts for jobs are brought back" " at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomJobsPlain.rst:110 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "**vehicle_id**" -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." -msgstr "" - -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "" -"**Only required for shipments time windows**. Value in ['p', 'd'] " -"indicating whether the time window is for:" +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomJobsPlain.rst:117 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "" -"**Relative values**, e.g. [0, 14400] for a 4 hours time window starting " -"at the beginning of the planning horizon. In that case all times reported" -" in output with the arrival column are relative to the start of the " -"planning horizon." +#: ../../build/doc/vrp_vroomJobsPlain.rst:124 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "" -"**Absolute values**, \"real\" timestamps. In that case all times reported" -" in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" -msgstr "" - -#: ../../build/doc/vrp_vroomJobsPlain.rst:106 +#: ../../build/doc/vrp_vroomJobsPlain.rst:131 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 +#: ../../build/doc/concepts.rst:23 msgid "" -"Sequential value starting from **1** for current vehicles. The " +"Sequential value starting from **1** for current vehicles. The " ":math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "" "Sequential value starting from **1** for the stops made by the current " "vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "" "The last step of every vehicle denotes the summary row, where the columns" " ``travel_time``, ``service_time`` and ``waiting_time`` denote the total " "time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "" "The last row denotes the summary for the complete problem, where the " "columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the" " total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:113 +#: ../../build/doc/vrp_vroomJobsPlain.rst:138 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:115 +#: ../../build/doc/vrp_vroomJobsPlain.rst:140 msgid "" "Problem involving 2 jobs, using a single vehicle, corresponding to the " "VROOM Documentation `Example 2 `__." msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:123 +#: ../../build/doc/vrp_vroomJobsPlain.rst:148 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:125 +#: ../../build/doc/vrp_vroomJobsPlain.rst:150 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:126 +#: ../../build/doc/vrp_vroomJobsPlain.rst:151 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -1041,15 +985,15 @@ msgid "" "Project/vroom/blob/master/docs/API.md>`__" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:133 +#: ../../build/doc/vrp_vroomJobsPlain.rst:158 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:134 +#: ../../build/doc/vrp_vroomJobsPlain.rst:159 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:135 +#: ../../build/doc/vrp_vroomJobsPlain.rst:160 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/vrp_vroomPlain.po b/locale/en/LC_MESSAGES/vrp_vroomPlain.po index 183fc8ca3..fe37f67eb 100644 --- a/locale/en/LC_MESSAGES/vrp_vroomPlain.po +++ b/locale/en/LC_MESSAGES/vrp_vroomPlain.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.3.0-dev\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/vrp_vroomPlain.rst:12 msgid "" @@ -109,39 +109,35 @@ msgstr "" msgid "Might depend on a deprecated function of vrpRouting" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:28 +#: ../../build/doc/vrp_vroomPlain.rst:29 msgid "Availability" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:29 +#: ../../build/doc/vrp_vroomPlain.rst:30 msgid "Version 0.3.0" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:31 +#: ../../build/doc/vrp_vroomPlain.rst:32 msgid "Function **modified** for VROOM 1.11.0" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:33 +#: ../../build/doc/vrp_vroomPlain.rst:34 msgid "Version 0.2.0" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:35 +#: ../../build/doc/vrp_vroomPlain.rst:36 msgid "New **experimental** function" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:39 ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 ../../build/doc/vrp_vroom.rst:9 +#: ../../build/doc/vrp_vroomPlain.rst:40 ../../build/doc/vrp_vroomPlain.rst:93 msgid "Description" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:41 +#: ../../build/doc/vrp_vroomPlain.rst:42 msgid "" "VROOM is an open-source optimization engine that aims at providing good " "solutions to various real-life vehicle routing problems (VRP) within a " @@ -149,659 +145,680 @@ msgid "" "problem involving both jobs and shipments." msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:50 +#: ../../build/doc/vrp_vroomPlain.rst:51 msgid "Signature" msgstr "" #: ../../build/doc/vrp_vroomPlain.rst:53 -msgid "Summary" +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst +msgid "vrp_vroom(" +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst +msgid "`Jobs SQL`_, `Jobs Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst +msgid "`Shipments SQL`_, `Shipments Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:31 ../../build/doc/vrp_vroomPlain.rst +msgid "`Time Matrix SQL`_" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:58 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomPlain.rst +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:61 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomPlain.rst +msgid "RETURNS SET OF" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:66 +#: ../../build/doc/vrp_vroomPlain.rst +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst +msgid "" +"task_data, arrival, travel_time, service_time, waiting_time, departure, " +"load)" +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:68 msgid "" "**Example**: This example is based on the VROOM Data of the " ":doc:`sampledata` network:" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:79 +#: ../../build/doc/vrp_vroomPlain.rst:75 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 +#: ../../build/doc/vrp_vroom.rst:7 ../../build/doc/vrp_vroomPlain.rst:90 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:13 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:28 ../../build/doc/concepts.rst:30 +#: ../../build/doc/vrp_vroom.rst:8 ../../build/doc/vrp_vroomPlain.rst:91 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**Jobs SQL**" +#: ../../build/doc/vrp_vroom.rst:10 +msgid "`Jobs SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 ../../build/sql/vroom/vrp_vroom.sql:8 -#: ../../build/sql/vroom/vrp_vroom.sql:10 -#: ../../build/sql/vroom/vrp_vroom.sql:12 -#: ../../build/sql/vroom/vrp_vroom.sql:14 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:16 -#: ../../build/sql/vroom/vrp_vroom.sql:18 +#: ../../build/doc/vrp_vroom.rst:11 ../../build/doc/vrp_vroom.rst:14 +#: ../../build/doc/vrp_vroom.rst:17 ../../build/doc/vrp_vroom.rst:20 +#: ../../build/doc/vrp_vroom.rst:23 ../../build/doc/vrp_vroom.rst:26 +#: ../../build/doc/vrp_vroom.rst:29 ../../build/doc/vrp_vroom.rst:32 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "" -"`Jobs SQL`_ query describing the single-location pickup and/or delivery " -"tasks." +#: ../../build/doc/vrp_vroom.rst:12 +msgid "Query describing the single-location pickup and/or delivery" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 -msgid "**Jobs Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:13 +msgid "`Jobs Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for job service start." +#: ../../build/doc/vrp_vroom.rst:15 +msgid "Query describing valid slots for job service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:10 -msgid "**Shipments SQL**" +#: ../../build/doc/vrp_vroom.rst:16 +msgid "`Shipments SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:10 +#: ../../build/doc/vrp_vroom.rst:18 msgid "" -"`Shipments SQL`_ query describing pickup and delivery tasks that should " -"happen within same route." +"Query describing pickup and delivery tasks that should happen within same" +" route." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:12 -msgid "**Shipments Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:19 +msgid "`Shipments Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:12 -msgid "" -"`Time Windows SQL`_ query describing valid slots for pickup and delivery " -"service start." +#: ../../build/doc/vrp_vroom.rst:21 +msgid "Query describing valid slots for pickup and delivery service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:14 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroom.rst:22 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:14 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroom.rst:24 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroom.rst:25 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroom.rst:27 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:28 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroom.rst:30 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroom.rst:33 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -msgid "" -"`Time Matrix SQL`_ query containing the distance or travel times between " -"the locations." -msgstr "" - -#: ../../build/doc/vrp_vroomPlain.rst:86 +#: ../../build/doc/vrp_vroomPlain.rst:82 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:31 +#: ../../build/doc/vrp_vroomPlain.rst:92 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroomPlain.rst:94 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:85 ../../build/doc/vrp_vroomPlain.rst:95 +#: ../../build/doc/vrp_vroomPlain.rst:102 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:96 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:97 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:8 +#: ../../build/doc/vrp_vroomPlain.rst:99 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:9 +#: ../../build/doc/vrp_vroomPlain.rst:100 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroomPlain.rst:101 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:103 msgid ":math:`-1`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:104 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:13 +#: ../../build/doc/vrp_vroomPlain.rst:106 msgid "" "Gives the best possible solution within a time limit. Note that some " "additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:16 +#: ../../build/doc/vrp_vroomPlain.rst:108 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:93 +#: ../../build/doc/vrp_vroomPlain.rst:113 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:96 +#: ../../build/doc/vrp_vroomPlain.rst:116 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:62 ../../build/doc/concepts.rst:78 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:18 ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:29 msgid "Column" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:33 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:34 ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../src/common/vroom/jobs_input.c:16 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:45 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:43 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/jobs_input.c:20 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:80 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 +#: ../../build/doc/concepts.rst:51 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" delivery such as number of items, weight, volume etc." +" pickup such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:26 -msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" +#: ../../build/doc/concepts.rst:54 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 +#: ../../build/doc/concepts.rst:58 msgid "" "Array of non-negative integers describing multidimensional quantities for" -" pickup such as number of items, weight, volume etc." +" delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:33 -msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +#: ../../build/doc/concepts.rst:61 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:65 +#: ../../build/doc/concepts.rst:81 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:68 ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:69 ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/concepts.rst:30 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:73 +msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "**data**" +#: ../../build/doc/vrp_vroomPlain.rst:123 +msgid "Jobs Time Windows SQL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:18 +msgid "" +"Positive unique identifier of the: job, pickup/delivery shipment, or " +"break." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -msgid "Any metadata information of the job." +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:23 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/jobs_input.c ../../src/common/vroom/shipments_input.c -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:103 +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:130 msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:44 ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:48 ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 ../../build/doc/concepts.rst:72 msgid "" "Array of non-negative integers describing multidimensional quantities " "such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 +#: ../../build/doc/concepts.rst:75 msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" +#: ../../build/doc/vrp_vroomPlain.rst:137 +msgid "Shipments Time Windows SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "**start_id**" +#: ../../build/doc/vrp_vroomPlain.rst:144 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|tw_close_default|" +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:59 +msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "" "Max value of speed factor for a vehicle shall not be greater than 5 times" " the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:73 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../src/common/vroom/vehicles_input.c:46 +#: ../../build/doc/concepts.rst:81 ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "" "If ``end_id`` is omitted, the resulting route will stop at the last " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "" "If ``start_id`` is omitted, the resulting route will start at the first " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "" "To request a round trip, specify both ``start_id`` and ``end_id`` as the " "same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "" "A vehicle is only allowed to serve a set of tasks if the resulting load " "at each route step is lower than the matching value in capacity for each " @@ -809,355 +826,307 @@ msgid "" "put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "" "It is assumed that all delivery-related amounts for jobs are loaded at " "vehicle start, while all pickup-related amounts for jobs are brought back" " at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomPlain.rst:151 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." -msgstr "" - -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "" -"**Only required for shipments time windows**. Value in ['p', 'd'] " -"indicating whether the time window is for:" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomPlain.rst:158 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "" -"**Relative values**, e.g. [0, 14400] for a 4 hours time window starting " -"at the beginning of the planning horizon. In that case all times reported" -" in output with the arrival column are relative to the start of the " -"planning horizon." +#: ../../build/doc/vrp_vroomPlain.rst:165 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "" -"**Absolute values**, \"real\" timestamps. In that case all times reported" -" in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" -msgstr "" - -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:114 +#: ../../build/doc/vrp_vroomPlain.rst:171 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 +#: ../../build/doc/concepts.rst:23 msgid "" -"Sequential value starting from **1** for current vehicles. The " +"Sequential value starting from **1** for current vehicles. The " ":math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "" "Sequential value starting from **1** for the stops made by the current " "vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "" "The last step of every vehicle denotes the summary row, where the columns" " ``travel_time``, ``service_time`` and ``waiting_time`` denote the total " "time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "" "The last row denotes the summary for the complete problem, where the " "columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the" " total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:121 +#: ../../build/doc/vrp_vroomPlain.rst:178 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:123 +#: ../../build/doc/vrp_vroomPlain.rst:180 msgid "" "Problem involving 2 jobs and 1 shipment, using a single vehicle, similar " "to the VROOM Documentation `Example 2 `__ with a shipment." msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:131 +#: ../../build/doc/vrp_vroomPlain.rst:188 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:133 +#: ../../build/doc/vrp_vroomPlain.rst:190 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:134 +#: ../../build/doc/vrp_vroomPlain.rst:191 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -1179,15 +1148,15 @@ msgid "" "Project/vroom/blob/master/docs/API.md>`__" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:141 +#: ../../build/doc/vrp_vroomPlain.rst:198 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:142 +#: ../../build/doc/vrp_vroomPlain.rst:199 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:143 +#: ../../build/doc/vrp_vroomPlain.rst:200 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/vrp_vroomShipments.po b/locale/en/LC_MESSAGES/vrp_vroomShipments.po index 6c02d8f71..b00d2415d 100644 --- a/locale/en/LC_MESSAGES/vrp_vroomShipments.po +++ b/locale/en/LC_MESSAGES/vrp_vroomShipments.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.3.0-dev\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/vrp_vroomShipments.rst:12 msgid "" @@ -128,14 +128,11 @@ msgstr "" msgid "New **experimental** function" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:39 -#: ../../build/sql/vroom/vrp_vroom.sql:4 ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:32 +#: ../../build/doc/vrp_vroom.rst:10 ../../build/doc/vrp_vroomShipments.rst:39 +#: ../../build/doc/vrp_vroomShipments.rst:82 msgid "Description" msgstr "" @@ -151,541 +148,568 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:52 -msgid "Summary" +#: ../../build/doc/vrp_vroomShipments.rst:51 +msgid "\\ \\" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:57 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomShipments.rst +msgid "vrp_vroomShipments(" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:60 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomShipments.rst +msgid "`Shipments SQL`_, `Shipments Time Windows SQL`_," msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:65 +#: ../../build/doc/vrp_vroomShipments.rst +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst +#: ../../build/doc/vrp_vroomShipments.rst:98 +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst +msgid "" +"task_data, arrival, travel_time, service_time, waiting_time, departure, " +"load)" +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst:64 msgid "" "**Example**: This example is based on the modified VROOM Data of the " ":doc:`sampledata` network. The modification in the tables is mentioned at" " the end of the :doc:`sampledata`." msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:79 +#: ../../build/doc/vrp_vroomShipments.rst:72 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 +#: ../../build/doc/vrp_vroom.rst:7 ../../build/doc/vrp_vroomShipments.rst:80 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:13 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 ../../build/doc/vrp_vroom.rst:8 +#: ../../build/doc/vrp_vroomShipments.rst:81 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -msgid "**Shipments SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:83 +msgid "`Shipments SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 +#: ../../build/doc/vrp_vroomShipments.rst:84 +#: ../../build/doc/vrp_vroomShipments.rst:87 +#: ../../build/doc/vrp_vroomShipments.rst:90 +#: ../../build/doc/vrp_vroomShipments.rst:93 +#: ../../build/doc/vrp_vroomShipments.rst:96 +#: ../../build/doc/vrp_vroomShipments.rst:99 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 +#: ../../build/doc/vrp_vroomShipments.rst:85 msgid "" -"`Shipments SQL`_ query describing pickup and delivery tasks that should " -"happen within same route." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -msgid "**Shipments Time Windows SQL**" +"Query describing pickup and delivery tasks that should happen within same" +" route." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -msgid "" -"`Time Windows SQL`_ query describing valid slots for pickup and delivery " -"service start." +#: ../../build/doc/vrp_vroomShipments.rst:86 +msgid "`Shipments Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:88 +msgid "Query describing valid slots for pickup and delivery service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroomShipments.rst:89 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:91 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroomShipments.rst:92 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:94 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroomShipments.rst:95 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:97 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 -msgid "" -"`Time Matrix SQL`_ query containing the distance or travel times between " -"the locations." +#: ../../build/doc/vrp_vroomShipments.rst:100 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:86 +#: ../../build/doc/vrp_vroomShipments.rst:105 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 ../../build/doc/vrp_vroom.rst:9 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroom.rst:11 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 ../../build/sql/vroom/vrp_vroom.sql:33 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:71 ../../build/doc/concepts.rst:85 +#: ../../build/doc/vrp_vroom.rst:12 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:13 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:14 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 +#: ../../build/doc/vrp_vroom.rst:16 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:9 +#: ../../build/doc/vrp_vroom.rst:17 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroom.rst:18 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:19 msgid "``INTERVAL``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:20 msgid "'-00:00:01'::INTERVAL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:21 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/vrp_vroom.rst:23 msgid "" "Gives the best possible solution within a time limit. Note that some " "additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 +#: ../../build/doc/vrp_vroom.rst:25 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:93 +#: ../../build/doc/vrp_vroomShipments.rst:112 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:96 +#: ../../build/doc/vrp_vroomShipments.rst:115 msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 -msgid "Column" +#: ../../build/doc/concepts.rst:5 ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:33 +msgid "``id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "**id**" +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:8 ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:78 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:29 +msgid "Column" +msgstr "" + +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:34 ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:42 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:44 ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" +msgstr "" + +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:48 ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:30 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" +msgstr "" + +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:70 ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:71 ../../build/doc/concepts.rst:80 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 ../../build/doc/concepts.rst:72 msgid "" "Array of non-negative integers describing multidimensional quantities " "such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 +#: ../../build/doc/concepts.rst:75 msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:81 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" +#: ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/vrp_vroomShipments.rst:122 +msgid "Shipments Time Windows SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:18 +msgid "" +"Positive unique identifier of the: job, pickup/delivery shipment, or " +"break." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:23 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/shipments_input.c -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "**start_id**" +#: ../../build/doc/vrp_vroomShipments.rst:129 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|tw_close_default|" +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:59 +msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "" "Max value of speed factor for a vehicle shall not be greater than 5 times" " the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "**data**" +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:73 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../src/common/vroom/vehicles_input.c:46 +#: ../../build/doc/concepts.rst:81 ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "" "If ``end_id`` is omitted, the resulting route will stop at the last " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "" "If ``start_id`` is omitted, the resulting route will start at the first " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "" "To request a round trip, specify both ``start_id`` and ``end_id`` as the " "same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "" "A vehicle is only allowed to serve a set of tasks if the resulting load " "at each route step is lower than the matching value in capacity for each " @@ -693,348 +717,300 @@ msgid "" "put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "" "It is assumed that all delivery-related amounts for jobs are loaded at " "vehicle start, while all pickup-related amounts for jobs are brought back" " at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomShipments.rst:136 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "**vehicle_id**" -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:17 -msgid "**service**" -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" +#: ../../build/doc/concepts.rst:25 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "" -"**Only required for shipments time windows**. Value in ['p', 'd'] " -"indicating whether the time window is for:" +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomShipments.rst:143 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "" -"**Relative values**, e.g. [0, 14400] for a 4 hours time window starting " -"at the beginning of the planning horizon. In that case all times reported" -" in output with the arrival column are relative to the start of the " -"planning horizon." +#: ../../build/doc/vrp_vroomShipments.rst:150 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "" -"**Absolute values**, \"real\" timestamps. In that case all times reported" -" in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" -msgstr "" - -#: ../../build/doc/vrp_vroomShipments.rst:107 +#: ../../build/doc/vrp_vroomShipments.rst:157 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 +#: ../../build/doc/concepts.rst:23 msgid "" -"Sequential value starting from **1** for current vehicles. The " +"Sequential value starting from **1** for current vehicles. The " ":math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "" "Sequential value starting from **1** for the stops made by the current " "vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "" "The last step of every vehicle denotes the summary row, where the columns" " ``travel_time``, ``service_time`` and ``waiting_time`` denote the total " "time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "" "The last row denotes the summary for the complete problem, where the " "columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the" " total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:114 +#: ../../build/doc/vrp_vroomShipments.rst:164 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:116 +#: ../../build/doc/vrp_vroomShipments.rst:166 msgid "" "Problem involving 1 shipment, using a single vehicle, similar to the " "VROOM Documentation `Example 2 `__" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:135 +#: ../../build/doc/vrp_vroomShipments.rst:185 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:136 +#: ../../build/doc/vrp_vroomShipments.rst:186 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:137 +#: ../../build/doc/vrp_vroomShipments.rst:187 msgid ":ref:`search`" msgstr "" diff --git a/locale/en/LC_MESSAGES/vrp_vroomShipmentsPlain.po b/locale/en/LC_MESSAGES/vrp_vroomShipmentsPlain.po index 79379211f..8fe3c6391 100644 --- a/locale/en/LC_MESSAGES/vrp_vroomShipmentsPlain.po +++ b/locale/en/LC_MESSAGES/vrp_vroomShipmentsPlain.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.3.0-dev\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.15.0\n" #: ../../build/doc/vrp_vroomShipmentsPlain.rst:12 msgid "" @@ -109,39 +109,36 @@ msgstr "" msgid "Might depend on a deprecated function of vrpRouting" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:28 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:29 msgid "Availability" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:29 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:30 msgid "Version 0.3.0" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:31 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:32 msgid "Function **modified** for VROOM 1.11.0" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:33 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:34 msgid "Version 0.2.0" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:35 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:36 msgid "New **experimental** function" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:39 -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:32 +#: ../../build/doc/vrp_vroomPlain.rst:10 +#: ../../build/doc/vrp_vroomShipments.rst:9 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:40 msgid "Description" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:41 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:42 msgid "" "VROOM is an open-source optimization engine that aims at providing good " "solutions to various real-life vehicle routing problems (VRP) within a " @@ -149,543 +146,568 @@ msgid "" "problem involving only shipments." msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:49 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:50 msgid "Signature" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:52 -msgid "Summary" +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:53 +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst +msgid "vrp_vroomShipmentsPlain(" +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst +msgid "`Shipments SQL`_, `Shipments Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst +msgid "`Vehicles SQL`_," msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:57 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomShipmentsPlain.rst +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:60 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomShipments.rst:25 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst +msgid "`Time Matrix SQL`_" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:65 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst +msgid "" +"task_data, arrival, travel_time, service_time, waiting_time, departure, " +"load)" +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:67 msgid "" "**Example**: This example is based on the VROOM Data of the " ":doc:`sampledata` network:" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:78 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:74 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 +#: ../../build/doc/vrp_vroomPlain.rst:7 +#: ../../build/doc/vrp_vroomShipments.rst:7 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:13 ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 ../../build/doc/vrp_vroomPlain.rst:8 +#: ../../build/doc/vrp_vroomShipments.rst:8 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -msgid "**Shipments SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:10 +msgid "`Shipments SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 +#: ../../build/doc/vrp_vroomShipments.rst:11 +#: ../../build/doc/vrp_vroomShipments.rst:14 +#: ../../build/doc/vrp_vroomShipments.rst:17 +#: ../../build/doc/vrp_vroomShipments.rst:20 +#: ../../build/doc/vrp_vroomShipments.rst:23 +#: ../../build/doc/vrp_vroomShipments.rst:26 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 +#: ../../build/doc/vrp_vroomShipments.rst:12 msgid "" -"`Shipments SQL`_ query describing pickup and delivery tasks that should " -"happen within same route." +"Query describing pickup and delivery tasks that should happen within same" +" route." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -msgid "**Shipments Time Windows SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:13 +msgid "`Shipments Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -msgid "" -"`Time Windows SQL`_ query describing valid slots for pickup and delivery " -"service start." +#: ../../build/doc/vrp_vroomShipments.rst:15 +msgid "Query describing valid slots for pickup and delivery service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:16 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroomShipments.rst:18 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:19 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroomShipments.rst:21 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:22 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroomShipments.rst:24 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:27 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 -msgid "" -"`Time Matrix SQL`_ query containing the distance or travel times between " -"the locations." -msgstr "" - -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:85 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:81 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 ../../build/doc/vrp_vroomPlain.rst:9 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroomPlain.rst:11 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:71 ../../build/doc/concepts.rst:85 +#: ../../build/doc/vrp_vroomPlain.rst:12 ../../build/doc/vrp_vroomPlain.rst:19 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:13 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:14 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:8 +#: ../../build/doc/vrp_vroomPlain.rst:16 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:9 +#: ../../build/doc/vrp_vroomPlain.rst:17 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroomPlain.rst:18 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:20 msgid ":math:`-1`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:21 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:13 +#: ../../build/doc/vrp_vroomPlain.rst:23 msgid "" "Gives the best possible solution within a time limit. Note that some " "additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:16 +#: ../../build/doc/vrp_vroomPlain.rst:25 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:92 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:88 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:95 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:91 msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/vehicles_input.c:12 -msgid "Column" +#: ../../build/doc/concepts.rst:5 ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:33 +msgid "``id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:78 +msgid "``skills``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "**id**" +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:29 +msgid "Column" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:16 ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:34 ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 +#: ../../build/doc/concepts.rst:36 msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:42 ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 +#: ../../build/doc/concepts.rst:27 ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:47 ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:44 ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:48 ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:30 ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 ../../build/doc/concepts.rst:77 +msgid "``JSONB``" +msgstr "" + +#: ../../build/doc/concepts.rst:31 ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" +msgstr "" + +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." +msgstr "" + +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:70 ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:71 ../../build/doc/concepts.rst:80 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 ../../build/doc/concepts.rst:72 msgid "" "Array of non-negative integers describing multidimensional quantities " "such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 +#: ../../build/doc/concepts.rst:75 msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 ../../build/doc/concepts.rst:81 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" +#: ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:98 +msgid "Shipments Time Windows SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:18 +msgid "" +"Positive unique identifier of the: job, pickup/delivery shipment, or " +"break." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:20 ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:23 ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/concepts.rst:22 ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/shipments_input.c -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/vehicles_input.c:14 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "**start_id**" +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:105 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:24 ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:17 ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|tw_close_default|" +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:59 +msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "" "Max value of speed factor for a vehicle shall not be greater than 5 times" " the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../src/common/vroom/vehicles_input.c:43 -msgid "**data**" +#: ../../build/doc/concepts.rst:29 ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:73 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../src/common/vroom/vehicles_input.c:46 +#: ../../build/doc/concepts.rst:81 ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "" "If ``end_id`` is omitted, the resulting route will stop at the last " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "" "If ``start_id`` is omitted, the resulting route will start at the first " "visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "" "To request a round trip, specify both ``start_id`` and ``end_id`` as the " "same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "" "A vehicle is only allowed to serve a set of tasks if the resulting load " "at each route step is lower than the matching value in capacity for each " @@ -693,348 +715,300 @@ msgid "" "put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "" "It is assumed that all delivery-related amounts for jobs are loaded at " "vehicle start, while all pickup-related amounts for jobs are brought back" " at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:112 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "**vehicle_id**" -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:17 -msgid "**service**" -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." -msgstr "" - -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" +#: ../../build/doc/concepts.rst:21 ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "" -"**Only required for shipments time windows**. Value in ['p', 'd'] " -"indicating whether the time window is for:" +#: ../../build/doc/concepts.rst:25 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:119 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "" -"**Relative values**, e.g. [0, 14400] for a 4 hours time window starting " -"at the beginning of the planning horizon. In that case all times reported" -" in output with the arrival column are relative to the start of the " -"planning horizon." +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:126 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "" -"**Absolute values**, \"real\" timestamps. In that case all times reported" -" in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" -msgstr "" - -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:106 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:133 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 +#: ../../build/doc/concepts.rst:23 msgid "" -"Sequential value starting from **1** for current vehicles. The " +"Sequential value starting from **1** for current vehicles. The " ":math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "" "Sequential value starting from **1** for the stops made by the current " "vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "" "The last step of every vehicle denotes the summary row, where the columns" " ``travel_time``, ``service_time`` and ``waiting_time`` denote the total " "time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "" "The last row denotes the summary for the complete problem, where the " "columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the" " total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:113 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:140 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:115 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:142 msgid "" "Problem involving 1 shipment, using a single vehicle, similar to the " "VROOM Documentation `Example 2 `__" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:134 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:161 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:135 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:162 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:136 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:163 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/concepts.pot b/locale/pot/concepts.pot index 9aee8c3bc..cc66037e9 100644 --- a/locale/pot/concepts.pot +++ b/locale/pot/concepts.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-09-28 10:43+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -40,123 +40,123 @@ msgstr "" msgid "Vehicle Routing Problems `VRP` are **NP-hard** optimization problem, it generalises the travelling salesman problem (TSP)." msgstr "" -#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:28 msgid "The objective of the VRP is to minimize the total route cost." msgstr "" -#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:29 msgid "There are several variants of the VRP problem," msgstr "" -#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:31 msgid "**vrpRouting does not try to implement all variants.**" msgstr "" -#: ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:35 msgid "Characteristics" msgstr "" -#: ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:37 msgid "Capacitated Vehicle Routing Problem `CVRP` where The vehicles have limited carrying capacity of the goods." msgstr "" -#: ../../build/doc/concepts.rst:37 +#: ../../build/doc/concepts.rst:39 msgid "Vehicle Routing Problem with Time Windows `VRPTW` where the locations have time windows within which the vehicle's visits must be made." msgstr "" -#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:41 msgid "Vehicle Routing Problem with Pickup and Delivery `VRPPD` where a number of goods need to be moved from certain pickup locations to other delivery locations." msgstr "" -#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:47 msgid "Limitations" msgstr "" -#: ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:48 msgid "No multiple time windows for a location." msgstr "" -#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:49 msgid "Less vehicle used is considered better." msgstr "" -#: ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:50 msgid "Less total duration is better." msgstr "" -#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:51 msgid "Less wait time is better." msgstr "" -#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:55 msgid "Pick & Delivery" msgstr "" -#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:57 msgid "Problem: `CVRPPDTW` Capacitated Pick and Delivery Vehicle Routing problem with Time Windows" msgstr "" -#: ../../build/doc/concepts.rst:54 +#: ../../build/doc/concepts.rst:60 msgid "Times are relative to `0`" msgstr "" -#: ../../build/doc/concepts.rst:55 +#: ../../build/doc/concepts.rst:61 msgid "The vehicles" msgstr "" -#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:63 msgid "have start and ending service duration times." msgstr "" -#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:64 msgid "have opening and closing times for the start and ending locations." msgstr "" -#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:65 msgid "have a capacity." msgstr "" -#: ../../build/doc/concepts.rst:61 +#: ../../build/doc/concepts.rst:67 msgid "The orders" msgstr "" -#: ../../build/doc/concepts.rst:63 +#: ../../build/doc/concepts.rst:69 msgid "Have pick up and delivery locations." msgstr "" -#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:70 msgid "Have opening and closing times for the pickup and delivery locations." msgstr "" -#: ../../build/doc/concepts.rst:65 +#: ../../build/doc/concepts.rst:71 msgid "Have pickup and delivery duration service times." msgstr "" -#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:72 msgid "have a demand request for moving goods from the pickup location to the delivery location." msgstr "" -#: ../../build/doc/concepts.rst:68 +#: ../../build/doc/concepts.rst:75 msgid "Time based calculations:" msgstr "" -#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:77 msgid "Travel time between customers is :math:`distance / speed`" msgstr "" -#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:78 msgid "Pickup and delivery order pair is done by the same vehicle." msgstr "" -#: ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:79 msgid "A pickup is done before the delivery." msgstr "" -#: ../../build/doc/concepts.rst:81 +#: ../../build/doc/concepts.rst:84 msgid "Getting Started" msgstr "" -#: ../../build/doc/concepts.rst:83 +#: ../../build/doc/concepts.rst:86 msgid "This is a simple guide to walk you through the steps of getting started with vrpRouting. In this guide we will cover:" msgstr "" @@ -228,238 +228,1840 @@ msgstr "" msgid "The `demand` request of the pickup-deliver orders must use the same units as the units used in the vehicle's `capacity`." msgstr "" -#: ../../build/doc/concepts.rst:135 +#: ../../build/doc/concepts.rst:136 msgid "To handle problems like: 10 (equal dimension) boxes of apples and 5 kg of feathers that are to be transported (not packed in boxes)." msgstr "" -#: ../../build/doc/concepts.rst:137 +#: ../../build/doc/concepts.rst:139 msgid "If the vehicle's `capacity` is measured by `boxes`, a conversion of `kg of feathers` to `equivalent number of boxes` is needed. If the vehicle's `capacity` is measured by `kg`, a conversion of `box of apples` to `equivalent number of kg` is needed." msgstr "" -#: ../../build/doc/concepts.rst:140 +#: ../../build/doc/concepts.rst:144 msgid "Showing how the 2 possible conversions can be done" msgstr "" -#: ../../build/doc/concepts.rst:142 +#: ../../build/doc/concepts.rst:146 msgid "Let: - :math:`f_boxes`: number of boxes that would be used for `1` kg of feathers. - :math:`a_weight`: weight of `1` box of apples." msgstr "" -#: ../../build/doc/concepts.rst:147 +#: ../../build/doc/concepts.rst:151 msgid "Capacity Units" msgstr "" -#: ../../build/doc/concepts.rst:147 +#: ../../build/doc/concepts.rst:151 msgid "apples" msgstr "" -#: ../../build/doc/concepts.rst:147 +#: ../../build/doc/concepts.rst:151 msgid "feathers" msgstr "" -#: ../../build/doc/concepts.rst:149 +#: ../../build/doc/concepts.rst:153 msgid "boxes" msgstr "" -#: ../../build/doc/concepts.rst:149 +#: ../../build/doc/concepts.rst:153 msgid "10" msgstr "" -#: ../../build/doc/concepts.rst:149 +#: ../../build/doc/concepts.rst:153 msgid ":math:`5 * f\\_boxes`" msgstr "" -#: ../../build/doc/concepts.rst:150 +#: ../../build/doc/concepts.rst:154 msgid "kg" msgstr "" -#: ../../build/doc/concepts.rst:150 +#: ../../build/doc/concepts.rst:154 msgid ":math:`10 * a\\_weight`" msgstr "" -#: ../../build/doc/concepts.rst:150 +#: ../../build/doc/concepts.rst:154 msgid "5" msgstr "" -#: ../../build/doc/concepts.rst:156 +#: ../../build/doc/concepts.rst:160 msgid "Locations" msgstr "" -#: ../../build/doc/concepts.rst:158 +#: ../../build/doc/concepts.rst:162 msgid "When using the Euclidean signatures:" msgstr "" -#: ../../build/doc/concepts.rst:160 +#: ../../build/doc/concepts.rst:164 msgid "The vehicles have :math:`(x, y)` pairs for start and ending locations." msgstr "" -#: ../../build/doc/concepts.rst:161 +#: ../../build/doc/concepts.rst:165 msgid "The orders Have :math:`(x, y)` pairs for pickup and delivery locations." msgstr "" -#: ../../build/doc/concepts.rst:163 +#: ../../build/doc/concepts.rst:167 msgid "When using a matrix:" msgstr "" -#: ../../build/doc/concepts.rst:165 +#: ../../build/doc/concepts.rst:169 msgid "The vehicles have identifiers for the start and ending locations." msgstr "" -#: ../../build/doc/concepts.rst:166 +#: ../../build/doc/concepts.rst:170 msgid "The orders have identifiers for the pickup and delivery locations." msgstr "" -#: ../../build/doc/concepts.rst:167 +#: ../../build/doc/concepts.rst:171 msgid "All the identifiers are indices to the given matrix." msgstr "" -#: ../../build/doc/concepts.rst:171 +#: ../../build/doc/concepts.rst:175 msgid "Time Handling" msgstr "" -#: ../../build/doc/concepts.rst:173 +#: ../../build/doc/concepts.rst:177 msgid "The times are relative to 0" msgstr "" -#: ../../build/doc/concepts.rst:175 +#: ../../build/doc/concepts.rst:179 msgid "Suppose that a vehicle's driver starts the shift at 9:00 am and ends the shift at 4:30 pm and the service time duration is 10 minutes with 30 seconds." msgstr "" -#: ../../build/doc/concepts.rst:178 +#: ../../build/doc/concepts.rst:182 msgid "All time units have to be converted" msgstr "" -#: ../../build/doc/concepts.rst:181 +#: ../../build/doc/concepts.rst:185 msgid "Meaning of 0" msgstr "" -#: ../../build/doc/concepts.rst:181 +#: ../../build/doc/concepts.rst:185 msgid "time units" msgstr "" -#: ../../build/doc/concepts.rst:181 -#: ../../build/doc/concepts.rst:184 -#: ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:185 +#: ../../build/doc/concepts.rst:188 +#: ../../build/doc/concepts.rst:190 msgid "9:00 am" msgstr "" -#: ../../build/doc/concepts.rst:181 +#: ../../build/doc/concepts.rst:185 msgid "4:30 pm" msgstr "" -#: ../../build/doc/concepts.rst:181 +#: ../../build/doc/concepts.rst:185 msgid "10 min 30 secs" msgstr "" -#: ../../build/doc/concepts.rst:183 -#: ../../build/doc/concepts.rst:185 +#: ../../build/doc/concepts.rst:187 +#: ../../build/doc/concepts.rst:189 msgid "0:00 am" msgstr "" -#: ../../build/doc/concepts.rst:183 -#: ../../build/doc/concepts.rst:184 +#: ../../build/doc/concepts.rst:187 +#: ../../build/doc/concepts.rst:188 msgid "hours" msgstr "" -#: ../../build/doc/concepts.rst:183 +#: ../../build/doc/concepts.rst:187 msgid "9" msgstr "" -#: ../../build/doc/concepts.rst:183 +#: ../../build/doc/concepts.rst:187 msgid "16.5" msgstr "" -#: ../../build/doc/concepts.rst:183 -#: ../../build/doc/concepts.rst:184 +#: ../../build/doc/concepts.rst:187 +#: ../../build/doc/concepts.rst:188 msgid ":math:`10.5 / 60 = 0.175`" msgstr "" -#: ../../build/doc/concepts.rst:184 -#: ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:188 +#: ../../build/doc/concepts.rst:190 +#: ../../build/doc/concepts.rst:292 +#: ../../build/doc/concepts.rst:312 +#: ../../build/doc/concepts.rst:364 +#: ../../build/doc/concepts.rst:386 +#: ../../build/doc/concepts.rst:434 +#: ../../build/doc/concepts.rst:444 +#: ../../build/doc/concepts.rst:509 +#: ../../build/doc/concepts.rst:519 msgid "0" msgstr "" -#: ../../build/doc/concepts.rst:184 +#: ../../build/doc/concepts.rst:188 msgid "7.5" msgstr "" -#: ../../build/doc/concepts.rst:185 -#: ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:189 +#: ../../build/doc/concepts.rst:190 msgid "minutes" msgstr "" -#: ../../build/doc/concepts.rst:185 +#: ../../build/doc/concepts.rst:189 msgid ":math:`9*60 = 54`" msgstr "" -#: ../../build/doc/concepts.rst:185 +#: ../../build/doc/concepts.rst:189 msgid ":math:`16.5*60 = 990`" msgstr "" -#: ../../build/doc/concepts.rst:185 -#: ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:189 +#: ../../build/doc/concepts.rst:190 msgid "10.5" msgstr "" -#: ../../build/doc/concepts.rst:186 +#: ../../build/doc/concepts.rst:190 msgid ":math:`7.5*60 = 540`" msgstr "" -#: ../../build/doc/concepts.rst:193 +#: ../../build/doc/concepts.rst:197 msgid "Factor Handling" msgstr "" -#: ../../build/doc/concepts.rst:197 -#: ../../build/doc/concepts.rst:203 -#: ../../build/doc/concepts.rst:210 -#: ../../build/doc/concepts.rst:216 -#: ../../build/doc/concepts.rst:222 +#: ../../build/doc/concepts.rst:201 +#: ../../build/doc/concepts.rst:207 +#: ../../build/doc/concepts.rst:1270 msgid "TBD" msgstr "" -#: ../../build/doc/concepts.rst:201 +#: ../../build/doc/concepts.rst:205 msgid "Group of Functions" msgstr "" -#: ../../build/doc/concepts.rst:208 +#: ../../build/doc/concepts.rst:212 msgid "Inner Queries" msgstr "" -#: ../../build/doc/concepts.rst:214 -msgid "Return columns & values" -msgstr "" - -#: ../../build/doc/concepts.rst:220 -msgid "Performance" -msgstr "" - -#: ../../build/doc/concepts.rst:225 -msgid "How to contribute" +#: ../../build/doc/concepts.rst:215 +msgid "Pickup-Delivery Inner Queries" msgstr "" -#: ../../build/doc/concepts.rst:228 -msgid "Wiki" +#: ../../build/doc/concepts.rst:218 +msgid "Matrix SQL" msgstr "" -#: ../../build/doc/concepts.rst:229 -msgid "Edit an existing `vrpRouting Wiki `_ page." +#: ../../build/doc/concepts.rst:222 +#: ../../build/doc/concepts.rst:252 +#: ../../build/doc/concepts.rst:321 +#: ../../build/doc/concepts.rst:398 +#: ../../build/doc/concepts.rst:473 +#: ../../build/doc/concepts.rst:569 +#: ../../build/doc/concepts.rst:648 +#: ../../build/doc/concepts.rst:741 +#: ../../build/doc/concepts.rst:843 +#: ../../build/doc/concepts.rst:881 +#: ../../build/doc/concepts.rst:922 +#: ../../build/doc/concepts.rst:958 +msgid "A ``SELECT`` statement that returns the following columns:" +msgstr "" + +#: ../../build/doc/concepts.rst:224 +msgid "``start_vid, end_vid, agg_cost``" +msgstr "" + +#: ../../build/doc/concepts.rst:230 +#: ../../build/doc/concepts.rst:262 +#: ../../build/doc/concepts.rst:332 +#: ../../build/doc/concepts.rst:408 +#: ../../build/doc/concepts.rst:483 +#: ../../build/doc/concepts.rst:593 +#: ../../build/doc/concepts.rst:674 +#: ../../build/doc/concepts.rst:761 +#: ../../build/doc/concepts.rst:853 +#: ../../build/doc/concepts.rst:891 +#: ../../build/doc/concepts.rst:932 +#: ../../build/doc/concepts.rst:967 +#: ../../build/doc/concepts.rst:1034 +#: ../../build/doc/concepts.rst:1105 +#: ../../build/doc/concepts.rst:1177 +msgid "Column" +msgstr "" + +#: ../../build/doc/concepts.rst:231 +#: ../../build/doc/concepts.rst:263 +#: ../../build/doc/concepts.rst:333 +#: ../../build/doc/concepts.rst:409 +#: ../../build/doc/concepts.rst:484 +#: ../../build/doc/concepts.rst:594 +#: ../../build/doc/concepts.rst:675 +#: ../../build/doc/concepts.rst:762 +#: ../../build/doc/concepts.rst:854 +#: ../../build/doc/concepts.rst:892 +#: ../../build/doc/concepts.rst:933 +#: ../../build/doc/concepts.rst:968 +#: ../../build/doc/concepts.rst:1035 +#: ../../build/doc/concepts.rst:1106 +#: ../../build/doc/concepts.rst:1178 +msgid "Type" +msgstr "" + +#: ../../build/doc/concepts.rst:232 +#: ../../build/doc/concepts.rst:265 +#: ../../build/doc/concepts.rst:335 +#: ../../build/doc/concepts.rst:411 +#: ../../build/doc/concepts.rst:486 +#: ../../build/doc/concepts.rst:596 +#: ../../build/doc/concepts.rst:677 +#: ../../build/doc/concepts.rst:764 +#: ../../build/doc/concepts.rst:856 +#: ../../build/doc/concepts.rst:894 +#: ../../build/doc/concepts.rst:934 +#: ../../build/doc/concepts.rst:969 +#: ../../build/doc/concepts.rst:1036 +#: ../../build/doc/concepts.rst:1107 +#: ../../build/doc/concepts.rst:1179 +msgid "Description" msgstr "" #: ../../build/doc/concepts.rst:233 -msgid "Adding Functionaity to vrpRouting" +msgid "``start_vid``" msgstr "" #: ../../build/doc/concepts.rst:234 -msgid "Consult the `developer's documentation `_" +#: ../../build/doc/concepts.rst:237 +#: ../../build/doc/concepts.rst:267 +#: ../../build/doc/concepts.rst:275 +#: ../../build/doc/concepts.rst:281 +#: ../../build/doc/concepts.rst:285 +#: ../../build/doc/concepts.rst:291 +#: ../../build/doc/concepts.rst:295 +#: ../../build/doc/concepts.rst:301 +#: ../../build/doc/concepts.rst:305 +#: ../../build/doc/concepts.rst:311 +#: ../../build/doc/concepts.rst:337 +#: ../../build/doc/concepts.rst:353 +#: ../../build/doc/concepts.rst:357 +#: ../../build/doc/concepts.rst:363 +#: ../../build/doc/concepts.rst:375 +#: ../../build/doc/concepts.rst:379 +#: ../../build/doc/concepts.rst:385 +#: ../../build/doc/concepts.rst:413 +#: ../../build/doc/concepts.rst:417 +#: ../../build/doc/concepts.rst:427 +#: ../../build/doc/concepts.rst:433 +#: ../../build/doc/concepts.rst:437 +#: ../../build/doc/concepts.rst:443 +#: ../../build/doc/concepts.rst:447 +#: ../../build/doc/concepts.rst:453 +#: ../../build/doc/concepts.rst:457 +#: ../../build/doc/concepts.rst:463 +#: ../../build/doc/concepts.rst:488 +#: ../../build/doc/concepts.rst:492 +#: ../../build/doc/concepts.rst:508 +#: ../../build/doc/concepts.rst:512 +#: ../../build/doc/concepts.rst:518 +#: ../../build/doc/concepts.rst:530 +#: ../../build/doc/concepts.rst:534 +#: ../../build/doc/concepts.rst:540 +#: ../../build/doc/concepts.rst:598 +#: ../../build/doc/concepts.rst:602 +#: ../../build/doc/concepts.rst:679 +#: ../../build/doc/concepts.rst:683 +#: ../../build/doc/concepts.rst:699 +#: ../../build/doc/concepts.rst:766 +#: ../../build/doc/concepts.rst:770 +#: ../../build/doc/concepts.rst:774 +#: ../../build/doc/concepts.rst:858 +#: ../../build/doc/concepts.rst:862 +#: ../../build/doc/concepts.rst:896 +#: ../../build/doc/concepts.rst:900 +#: ../../build/doc/concepts.rst:936 +#: ../../build/doc/concepts.rst:971 +msgid "|ANY-INTEGER|" +msgstr "" + +#: ../../build/doc/concepts.rst:235 +#: ../../build/doc/concepts.rst:238 +msgid "Identifier of a node." msgstr "" -#: ../../build/doc/concepts.rst:238 -msgid "Indices and tables" +#: ../../build/doc/concepts.rst:236 +msgid "``end_vid``" msgstr "" #: ../../build/doc/concepts.rst:239 -msgid ":ref:`genindex`" +msgid "``agg_cost``" msgstr "" #: ../../build/doc/concepts.rst:240 +#: ../../build/doc/concepts.rst:271 +#: ../../build/doc/concepts.rst:341 +#: ../../build/doc/concepts.rst:345 +#: ../../build/doc/concepts.rst:349 +#: ../../build/doc/concepts.rst:367 +#: ../../build/doc/concepts.rst:371 +#: ../../build/doc/concepts.rst:423 +#: ../../build/doc/concepts.rst:496 +#: ../../build/doc/concepts.rst:500 +#: ../../build/doc/concepts.rst:504 +#: ../../build/doc/concepts.rst:522 +#: ../../build/doc/concepts.rst:526 +#: ../../build/doc/concepts.rst:802 +msgid "|ANY-NUMERICAL|" +msgstr "" + +#: ../../build/doc/concepts.rst:241 +msgid "Cost to travel from ``start_vid`` to ``end_vid``" +msgstr "" + +#: ../../build/doc/concepts.rst:246 +msgid "Orders SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:249 +msgid "Orders" +msgstr "" + +#: ../../build/doc/concepts.rst:254 +#: ../../build/doc/concepts.rst:323 +msgid "``id, amount``" +msgstr "" + +#: ../../build/doc/concepts.rst:255 +msgid "``p_id, p_tw_open, p_tw_close, [p_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:256 +msgid "``d_id, d_tw_open, d_tw_close, [d_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:264 +#: ../../build/doc/concepts.rst:334 +#: ../../build/doc/concepts.rst:410 +#: ../../build/doc/concepts.rst:485 +#: ../../build/doc/concepts.rst:595 +#: ../../build/doc/concepts.rst:676 +#: ../../build/doc/concepts.rst:763 +#: ../../build/doc/concepts.rst:855 +#: ../../build/doc/concepts.rst:893 +msgid "Default" +msgstr "" + +#: ../../build/doc/concepts.rst:266 +#: ../../build/doc/concepts.rst:336 +#: ../../build/doc/concepts.rst:412 +#: ../../build/doc/concepts.rst:487 +#: ../../build/doc/concepts.rst:597 +#: ../../build/doc/concepts.rst:650 +#: ../../build/doc/concepts.rst:678 +#: ../../build/doc/concepts.rst:765 +#: ../../build/doc/concepts.rst:895 +#: ../../build/doc/concepts.rst:935 +#: ../../build/doc/concepts.rst:970 +msgid "``id``" +msgstr "" + +#: ../../build/doc/concepts.rst:269 +#: ../../build/doc/concepts.rst:339 +msgid "Identifier of the pick-delivery order pair." +msgstr "" + +#: ../../build/doc/concepts.rst:270 +#: ../../build/doc/concepts.rst:340 +#: ../../build/doc/concepts.rst:714 +msgid "``amount``" +msgstr "" + +#: ../../build/doc/concepts.rst:273 +#: ../../build/doc/concepts.rst:343 +msgid "Number of units in the order." +msgstr "" + +#: ../../build/doc/concepts.rst:274 +msgid "``p_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:277 +msgid "Identifier of the pickup node." +msgstr "" + +#: ../../build/doc/concepts.rst:279 +#: ../../build/doc/concepts.rst:299 +#: ../../build/doc/concepts.rst:431 +#: ../../build/doc/concepts.rst:451 +msgid "Must match a node identifier in the `Matrix SQL`_." +msgstr "" + +#: ../../build/doc/concepts.rst:280 +#: ../../build/doc/concepts.rst:352 +msgid "``p_tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:283 +#: ../../build/doc/concepts.rst:355 +msgid "The time, relative to 0, when the pickup location opens." +msgstr "" + +#: ../../build/doc/concepts.rst:284 +#: ../../build/doc/concepts.rst:356 +msgid "``p_tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:287 +#: ../../build/doc/concepts.rst:359 +msgid "The time, relative to 0, when the pickup location closes." +msgstr "" + +#: ../../build/doc/concepts.rst:289 +#: ../../build/doc/concepts.rst:361 +msgid ":math:`p\\_tw\\_open < p\\_tw\\_close < 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:290 +#: ../../build/doc/concepts.rst:362 +#: ../../build/doc/concepts.rst:690 +msgid "``p_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:293 +#: ../../build/doc/concepts.rst:365 +msgid "The duration of the loading at the pickup location." +msgstr "" + +#: ../../build/doc/concepts.rst:294 +msgid "``d_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:297 +msgid "Identifier of the delivery node." +msgstr "" + +#: ../../build/doc/concepts.rst:300 +#: ../../build/doc/concepts.rst:374 +msgid "``d_tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:303 +#: ../../build/doc/concepts.rst:377 +msgid "The time, relative to 0, when the delivery location opens." +msgstr "" + +#: ../../build/doc/concepts.rst:304 +#: ../../build/doc/concepts.rst:378 +msgid "``d_tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:307 +#: ../../build/doc/concepts.rst:381 +msgid "The time, relative to 0, when the delivery location closes." +msgstr "" + +#: ../../build/doc/concepts.rst:309 +#: ../../build/doc/concepts.rst:383 +msgid ":math:`d\\_tw\\_open < d\\_tw\\_close <= 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:310 +#: ../../build/doc/concepts.rst:384 +#: ../../build/doc/concepts.rst:706 +msgid "``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:313 +#: ../../build/doc/concepts.rst:387 +msgid "The duration of the unloading at the delivery location." +msgstr "" + +#: ../../build/doc/concepts.rst:318 +msgid "Euclidean Orders" +msgstr "" + +#: ../../build/doc/concepts.rst:324 +msgid "``p_x, p_y, p_tw_open, p_tw_close, [p_service,]``" +msgstr "" + +#: ../../build/doc/concepts.rst:325 +msgid "``d_x, d_y, d_tw_open, d_tw_close, [d_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:344 +msgid "``p_x``" +msgstr "" + +#: ../../build/doc/concepts.rst:347 +msgid ":math:`x` value of the pickup location." +msgstr "" + +#: ../../build/doc/concepts.rst:348 +msgid "``p_y``" +msgstr "" + +#: ../../build/doc/concepts.rst:351 +msgid ":math:`y` value of the pickup location." +msgstr "" + +#: ../../build/doc/concepts.rst:366 +msgid "``d_x``" +msgstr "" + +#: ../../build/doc/concepts.rst:369 +msgid ":math:`x` value of the delivery location." +msgstr "" + +#: ../../build/doc/concepts.rst:370 +msgid "``d_y``" +msgstr "" + +#: ../../build/doc/concepts.rst:373 +msgid ":math:`y` value of the delivery location." +msgstr "" + +#: ../../build/doc/concepts.rst:392 +#: ../../build/doc/concepts.rst:737 +msgid "Vehicles SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:395 +msgid "Vehicles" +msgstr "" + +#: ../../build/doc/concepts.rst:400 +#: ../../build/doc/concepts.rst:475 +msgid "``id, capacity, [speed,]``" +msgstr "" + +#: ../../build/doc/concepts.rst:401 +msgid "``s_id, [s_tw_open, s_tw_close, s_service,]``" +msgstr "" + +#: ../../build/doc/concepts.rst:402 +msgid "``[e_id, e_tw_open, e_tw_close, e_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:415 +msgid "Identifier of the vehicle" +msgstr "" + +#: ../../build/doc/concepts.rst:416 +#: ../../build/doc/concepts.rst:491 +#: ../../build/doc/concepts.rst:777 +msgid "``capacity``" +msgstr "" + +#: ../../build/doc/concepts.rst:419 +msgid "Capacity of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:421 +msgid ":math:`0 < capacity <= 4294967295`." +msgstr "" + +#: ../../build/doc/concepts.rst:422 +#: ../../build/doc/concepts.rst:495 +msgid "``speed``" +msgstr "" + +#: ../../build/doc/concepts.rst:424 +#: ../../build/doc/concepts.rst:497 +msgid "1" +msgstr "" + +#: ../../build/doc/concepts.rst:425 +#: ../../build/doc/concepts.rst:498 +msgid "Speed of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:426 +#: ../../build/doc/concepts.rst:448 +msgid "``s_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:429 +msgid "The node identifier of the starting location." +msgstr "" + +#: ../../build/doc/concepts.rst:432 +#: ../../build/doc/concepts.rst:454 +#: ../../build/doc/concepts.rst:507 +#: ../../build/doc/concepts.rst:531 +msgid "``s_tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:435 +#: ../../build/doc/concepts.rst:510 +msgid "The time, relative to 0, when the starting location opens." +msgstr "" + +#: ../../build/doc/concepts.rst:436 +#: ../../build/doc/concepts.rst:458 +#: ../../build/doc/concepts.rst:511 +#: ../../build/doc/concepts.rst:535 +msgid "``s_tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:438 +#: ../../build/doc/concepts.rst:513 +msgid "|MAX-BIGINT|" +msgstr "" + +#: ../../build/doc/concepts.rst:439 +#: ../../build/doc/concepts.rst:514 +msgid "The time, relative to 0, when the starting location closes." +msgstr "" + +#: ../../build/doc/concepts.rst:441 +#: ../../build/doc/concepts.rst:516 +msgid ":math:`s\\_tw\\_open < s\\_tw\\_close <= 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:442 +#: ../../build/doc/concepts.rst:464 +#: ../../build/doc/concepts.rst:517 +#: ../../build/doc/concepts.rst:541 +msgid "``s_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:445 +msgid "Duration of any task at the starting location," +msgstr "" + +#: ../../build/doc/concepts.rst:446 +msgid "``e_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:449 +msgid "The node identifier of the ending location." +msgstr "" + +#: ../../build/doc/concepts.rst:452 +#: ../../build/doc/concepts.rst:529 +msgid "``e_tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:455 +#: ../../build/doc/concepts.rst:532 +msgid "The time, relative to 0, when the ending location opens." +msgstr "" + +#: ../../build/doc/concepts.rst:456 +#: ../../build/doc/concepts.rst:533 +msgid "``e_tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:459 +#: ../../build/doc/concepts.rst:536 +msgid "The time, relative to 0, when the ending location closes." +msgstr "" + +#: ../../build/doc/concepts.rst:461 +#: ../../build/doc/concepts.rst:538 +msgid ":math:`e\\_tw\\_open < e\\_tw\\_close <= 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:462 +#: ../../build/doc/concepts.rst:539 +msgid "``e_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:465 +#: ../../build/doc/concepts.rst:542 +msgid "The duration of any task at the ending location" +msgstr "" + +#: ../../build/doc/concepts.rst:470 +msgid "Euclidean Vehicles" +msgstr "" + +#: ../../build/doc/concepts.rst:476 +msgid "``s_x, s_y, [s_tw_open, s_tw_close, s_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:477 +msgid "``[e_x, e_y, e_tw_open, e_tw_close, e_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:490 +msgid "Identifier of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:494 +msgid "Capacity of the vehicle. :math:`0 < capacity <= 4294967295`." +msgstr "" + +#: ../../build/doc/concepts.rst:499 +msgid "``s_x``" +msgstr "" + +#: ../../build/doc/concepts.rst:502 +msgid ":math:`x` value of the coordinate of the starting location." +msgstr "" + +#: ../../build/doc/concepts.rst:503 +msgid "``s_y``" +msgstr "" + +#: ../../build/doc/concepts.rst:506 +msgid ":math:`y` value of the coordinate of the starting location." +msgstr "" + +#: ../../build/doc/concepts.rst:520 +msgid "Duration of any task at the ending location," +msgstr "" + +#: ../../build/doc/concepts.rst:521 +msgid "``e_x``" +msgstr "" + +#: ../../build/doc/concepts.rst:524 +msgid ":math:`x` value of the coordinate of the ending location." +msgstr "" + +#: ../../build/doc/concepts.rst:525 +msgid "``e_y``" +msgstr "" + +#: ../../build/doc/concepts.rst:528 +msgid ":math:`y` value of the coordinate of the ending location." +msgstr "" + +#: ../../build/doc/concepts.rst:547 +msgid "Vroom Inner Queries" +msgstr "" + +#: ../../build/doc/concepts.rst:549 +msgid "Vroom, because of the data types used internally, some maximum values apply." +msgstr "" + +#: ../../build/doc/concepts.rst:551 +msgid "For ``TIMESTAMP``:" +msgstr "" + +#: ../../build/doc/concepts.rst:557 +msgid "For ``INTERVAL``:" +msgstr "" + +#: ../../build/doc/concepts.rst:565 +msgid "Jobs SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:571 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:572 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:574 +#: ../../build/doc/concepts.rst:655 +#: ../../build/doc/concepts.rst:746 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:576 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:578 +#: ../../build/doc/concepts.rst:659 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:580 +#: ../../build/doc/concepts.rst:628 +#: ../../build/doc/concepts.rst:661 +#: ../../build/doc/concepts.rst:723 +#: ../../build/doc/concepts.rst:748 +#: ../../build/doc/concepts.rst:785 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:582 +#: ../../build/doc/concepts.rst:663 +#: ../../build/doc/concepts.rst:750 +#: ../../build/doc/concepts.rst:810 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:584 +#: ../../build/doc/concepts.rst:632 +#: ../../build/doc/concepts.rst:665 +#: ../../build/doc/concepts.rst:729 +#: ../../build/doc/concepts.rst:752 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:586 +#: ../../build/doc/concepts.rst:667 +#: ../../build/doc/concepts.rst:754 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:600 +msgid "Positive unique identifier of the job." +msgstr "" + +#: ../../build/doc/concepts.rst:601 +#: ../../build/doc/concepts.rst:1220 +msgid "``location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:604 +msgid "Positive unique identifier of the location of the job." +msgstr "" + +#: ../../build/doc/concepts.rst:605 +msgid "``setup``" +msgstr "" + +#: ../../build/doc/concepts.rst:606 +#: ../../build/doc/concepts.rst:611 +#: ../../build/doc/concepts.rst:687 +#: ../../build/doc/concepts.rst:691 +#: ../../build/doc/concepts.rst:703 +#: ../../build/doc/concepts.rst:707 +#: ../../build/doc/concepts.rst:866 +#: ../../build/doc/concepts.rst:870 +#: ../../build/doc/concepts.rst:904 +#: ../../build/doc/concepts.rst:1232 +#: ../../build/doc/concepts.rst:1237 +#: ../../build/doc/concepts.rst:1240 +#: ../../build/doc/concepts.rst:1243 +msgid "|interval|" +msgstr "" + +#: ../../build/doc/concepts.rst:607 +#: ../../build/doc/concepts.rst:612 +#: ../../build/doc/concepts.rst:688 +#: ../../build/doc/concepts.rst:692 +#: ../../build/doc/concepts.rst:704 +#: ../../build/doc/concepts.rst:708 +#: ../../build/doc/concepts.rst:905 +msgid "|interval0|" +msgstr "" + +#: ../../build/doc/concepts.rst:608 +msgid "The Job setup duration." +msgstr "" + +#: ../../build/doc/concepts.rst:610 +#: ../../build/doc/concepts.rst:903 +msgid "``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:613 +msgid "The Job service duration. Max value:" +msgstr "" + +#: ../../build/doc/concepts.rst:614 +msgid "``pickup``" +msgstr "" + +#: ../../build/doc/concepts.rst:615 +#: ../../build/doc/concepts.rst:622 +#: ../../build/doc/concepts.rst:629 +#: ../../build/doc/concepts.rst:715 +#: ../../build/doc/concepts.rst:724 +#: ../../build/doc/concepts.rst:778 +#: ../../build/doc/concepts.rst:786 +msgid "``ARRAY[ANY-INTEGER]``" +msgstr "" + +#: ../../build/doc/concepts.rst:616 +#: ../../build/doc/concepts.rst:623 +#: ../../build/doc/concepts.rst:630 +#: ../../build/doc/concepts.rst:716 +#: ../../build/doc/concepts.rst:725 +#: ../../build/doc/concepts.rst:779 +#: ../../build/doc/concepts.rst:787 +msgid "``[]``" +msgstr "" + +#: ../../build/doc/concepts.rst:617 +msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." +msgstr "" + +#: ../../build/doc/concepts.rst:620 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:621 +msgid "``delivery``" +msgstr "" + +#: ../../build/doc/concepts.rst:624 +msgid "Array of non-negative integers describing multidimensional quantities for delivery such as number of items, weight, volume etc." +msgstr "" + +#: ../../build/doc/concepts.rst:627 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:631 +#: ../../build/doc/concepts.rst:726 +#: ../../build/doc/concepts.rst:788 +msgid "Array of non-negative integers defining mandatory skills." +msgstr "" + +#: ../../build/doc/concepts.rst:633 +#: ../../build/doc/concepts.rst:730 +#: ../../build/doc/concepts.rst:809 +#: ../../build/doc/concepts.rst:1038 +#: ../../build/doc/concepts.rst:1041 +#: ../../build/doc/concepts.rst:1048 +#: ../../build/doc/concepts.rst:1052 +#: ../../build/doc/concepts.rst:1109 +#: ../../build/doc/concepts.rst:1112 +#: ../../build/doc/concepts.rst:1119 +#: ../../build/doc/concepts.rst:1123 +msgid "``INTEGER``" +msgstr "" + +#: ../../build/doc/concepts.rst:634 +#: ../../build/doc/concepts.rst:731 +msgid ":math:`0`" +msgstr "" + +#: ../../build/doc/concepts.rst:635 +#: ../../build/doc/concepts.rst:732 +msgid "Value range: :math:`[0, 100]`" +msgstr "" + +#: ../../build/doc/concepts.rst:636 +#: ../../build/doc/concepts.rst:814 +#: ../../build/doc/concepts.rst:907 +msgid "``data``" +msgstr "" + +#: ../../build/doc/concepts.rst:637 +#: ../../build/doc/concepts.rst:695 +#: ../../build/doc/concepts.rst:711 +#: ../../build/doc/concepts.rst:815 +#: ../../build/doc/concepts.rst:908 +#: ../../build/doc/concepts.rst:1194 +#: ../../build/doc/concepts.rst:1226 +msgid "``JSONB``" +msgstr "" + +#: ../../build/doc/concepts.rst:638 +#: ../../build/doc/concepts.rst:696 +#: ../../build/doc/concepts.rst:712 +#: ../../build/doc/concepts.rst:816 +#: ../../build/doc/concepts.rst:909 +msgid "``'{}'::JSONB``" +msgstr "" + +#: ../../build/doc/concepts.rst:639 +msgid "Any metadata information of the job." +msgstr "" + +#: ../../build/doc/concepts.rst:644 +msgid "Shipments SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:651 +msgid "``p_location_id, [p_setup, p_service, p_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:652 +msgid "``d_location_id, [d_setup, d_service, d_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:653 +msgid "``[amount, skills, priority]``" +msgstr "" + +#: ../../build/doc/concepts.rst:657 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:681 +msgid "Positive unique identifier of the shipment." +msgstr "" + +#: ../../build/doc/concepts.rst:682 +msgid "``p_location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:685 +#: ../../build/doc/concepts.rst:701 +msgid "Positive unique identifier of the pickup location." +msgstr "" + +#: ../../build/doc/concepts.rst:686 +msgid "``p_setup``" +msgstr "" + +#: ../../build/doc/concepts.rst:689 +#: ../../build/doc/concepts.rst:705 +msgid "The pickup setup duration" +msgstr "" + +#: ../../build/doc/concepts.rst:693 +#: ../../build/doc/concepts.rst:709 +msgid "The pickup service duration" +msgstr "" + +#: ../../build/doc/concepts.rst:694 +msgid "``p_data``" +msgstr "" + +#: ../../build/doc/concepts.rst:697 +msgid "Any metadata information of the pickup." +msgstr "" + +#: ../../build/doc/concepts.rst:698 +msgid "``d_location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:702 +msgid "``d_setup``" +msgstr "" + +#: ../../build/doc/concepts.rst:710 +msgid "``d_data``" +msgstr "" + +#: ../../build/doc/concepts.rst:713 +msgid "Any metadata information of the delivery." +msgstr "" + +#: ../../build/doc/concepts.rst:717 +#: ../../build/doc/concepts.rst:780 +msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." +msgstr "" + +#: ../../build/doc/concepts.rst:720 +msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:728 +msgid ":math:`values \\leq 2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:743 +msgid "``id, start_id, end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:744 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:768 +#: ../../build/doc/concepts.rst:902 +msgid "Positive unique identifier of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:769 +#: ../../build/doc/concepts.rst:857 +msgid "``start_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:772 +msgid "Positive unique identifier of the start location." +msgstr "" + +#: ../../build/doc/concepts.rst:773 +#: ../../build/doc/concepts.rst:861 +msgid "``end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:776 +msgid "Positive unique identifier of the end location." +msgstr "" + +#: ../../build/doc/concepts.rst:783 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:789 +#: ../../build/doc/concepts.rst:939 +#: ../../build/doc/concepts.rst:974 +msgid "``tw_open``" +msgstr "" + +#: ../../build/doc/concepts.rst:790 +#: ../../build/doc/concepts.rst:796 +#: ../../build/doc/concepts.rst:940 +#: ../../build/doc/concepts.rst:943 +#: ../../build/doc/concepts.rst:975 +#: ../../build/doc/concepts.rst:978 +#: ../../build/doc/concepts.rst:1229 +#: ../../build/doc/concepts.rst:1246 +msgid "|timestamp|" +msgstr "" + +#: ../../build/doc/concepts.rst:791 +msgid "|tw_open_default|" +msgstr "" + +#: ../../build/doc/concepts.rst:792 +#: ../../build/doc/concepts.rst:941 +#: ../../build/doc/concepts.rst:976 +msgid "Time window opening time." +msgstr "" + +#: ../../build/doc/concepts.rst:794 +#: ../../build/doc/concepts.rst:800 +msgid ":code:`tw_open \\leq tw_close`" +msgstr "" + +#: ../../build/doc/concepts.rst:795 +#: ../../build/doc/concepts.rst:942 +#: ../../build/doc/concepts.rst:977 +msgid "``tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:797 +msgid "|tw_close_default|" +msgstr "" + +#: ../../build/doc/concepts.rst:798 +#: ../../build/doc/concepts.rst:944 +#: ../../build/doc/concepts.rst:979 +msgid "Time window closing time." +msgstr "" + +#: ../../build/doc/concepts.rst:801 +msgid "``speed_factor``" +msgstr "" + +#: ../../build/doc/concepts.rst:803 +msgid ":math:`1.0`" +msgstr "" + +#: ../../build/doc/concepts.rst:804 +msgid "Vehicle travel time multiplier." +msgstr "" + +#: ../../build/doc/concepts.rst:806 +msgid "Max value of speed factor for a vehicle shall not be greater than 5 times the speed factor of any other vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:808 +msgid "``max_tasks``" +msgstr "" + +#: ../../build/doc/concepts.rst:811 +msgid "Maximum number of tasks in a route for the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:813 +msgid "A job, pickup, or delivery is counted as a single task." +msgstr "" + +#: ../../build/doc/concepts.rst:817 +msgid "Any metadata information of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:819 +#: ../../build/doc/concepts.rst:985 +#: ../../build/doc/concepts.rst:1254 +msgid "**Note**:" +msgstr "" + +#: ../../build/doc/concepts.rst:821 +msgid "At least one of the ``start_id`` or ``end_id`` shall be present." +msgstr "" + +#: ../../build/doc/concepts.rst:822 +msgid "If ``end_id`` is omitted, the resulting route will stop at the last visited task, whose choice is determined by the optimization process." +msgstr "" + +#: ../../build/doc/concepts.rst:824 +msgid "If ``start_id`` is omitted, the resulting route will start at the first visited task, whose choice is determined by the optimization process." +msgstr "" + +#: ../../build/doc/concepts.rst:826 +msgid "To request a round trip, specify both ``start_id`` and ``end_id`` as the same index." +msgstr "" + +#: ../../build/doc/concepts.rst:828 +msgid "A vehicle is only allowed to serve a set of tasks if the resulting load at each route step is lower than the matching value in capacity for each metric. When using multiple components for amounts, it is recommended to put the most important/limiting metrics first." +msgstr "" + +#: ../../build/doc/concepts.rst:832 +msgid "It is assumed that all delivery-related amounts for jobs are loaded at vehicle start, while all pickup-related amounts for jobs are brought back at vehicle end." +msgstr "" + +#: ../../build/doc/concepts.rst:839 +msgid "Vroom Matrix SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:845 +msgid "``start_id, end_id, duration``" +msgstr "" + +#: ../../build/doc/concepts.rst:846 +msgid "``[ cost]``" +msgstr "" + +#: ../../build/doc/concepts.rst:860 +msgid "Identifier of the start node." +msgstr "" + +#: ../../build/doc/concepts.rst:864 +msgid "Identifier of the end node." +msgstr "" + +#: ../../build/doc/concepts.rst:865 +#: ../../build/doc/concepts.rst:871 +msgid "``duration``" +msgstr "" + +#: ../../build/doc/concepts.rst:868 +msgid "Time to travel from ``start_id`` to ``end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:869 +msgid "``cost``" +msgstr "" + +#: ../../build/doc/concepts.rst:872 +msgid "Cost of travel from ``start_id`` to ``end_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:877 +msgid "Breaks SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:883 +msgid "``id, vehicle_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:884 +msgid "``[service, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:898 +msgid "Positive unique identifier of the break. Unique for the same vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:899 +#: ../../build/doc/concepts.rst:1044 +#: ../../build/doc/concepts.rst:1115 +#: ../../build/doc/concepts.rst:1187 +msgid "``vehicle_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:906 +msgid "The break duration" +msgstr "" + +#: ../../build/doc/concepts.rst:910 +msgid "Any metadata information of the break." +msgstr "" + +#: ../../build/doc/concepts.rst:916 +msgid "Time Windows SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:919 +msgid "Shipment Time Windows SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:924 +#: ../../build/doc/concepts.rst:960 +msgid "``id, tw_open, tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:925 +msgid "``[kind]``" +msgstr "" + +#: ../../build/doc/concepts.rst:937 +#: ../../build/doc/concepts.rst:972 +msgid "Positive unique identifier of the: job, pickup/delivery shipment, or break." +msgstr "" + +#: ../../build/doc/concepts.rst:945 +msgid "``kind``" +msgstr "" + +#: ../../build/doc/concepts.rst:946 +msgid "``CHAR``" +msgstr "" + +#: ../../build/doc/concepts.rst:947 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" +msgstr "" + +#: ../../build/doc/concepts.rst:949 +msgid "Pickup shipment, or" +msgstr "" + +#: ../../build/doc/concepts.rst:950 +msgid "Delivery shipment." +msgstr "" + +#: ../../build/doc/concepts.rst:955 +msgid "General Time Windows SQL" +msgstr "" + +#: ../../build/doc/concepts.rst:987 +msgid "All timings are in **seconds** when represented as an ``INTEGER``." +msgstr "" + +#: ../../build/doc/concepts.rst:988 +msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +msgstr "" + +#: ../../build/doc/concepts.rst:989 +msgid "Time windows can be interpreted by the users:" +msgstr "" + +#: ../../build/doc/concepts.rst:991 +msgid "**Relative values**, e.g." +msgstr "" + +#: ../../build/doc/concepts.rst:993 +msgid "Let the beginning of the planning horizon :math:`0`." +msgstr "" + +#: ../../build/doc/concepts.rst:994 +msgid "for a 4 hour time window (:math:`4 * 3600 = 14400` seconds) starting from the planning horizon" +msgstr "" + +#: ../../build/doc/concepts.rst:997 +msgid "``tw_open`` = :math:`0`" +msgstr "" + +#: ../../build/doc/concepts.rst:998 +msgid "``tw_close`` = :math:`14400`" +msgstr "" + +#: ../../build/doc/concepts.rst:1000 +msgid "Times reported in output relative to the start of the planning horizon." +msgstr "" + +#: ../../build/doc/concepts.rst:1002 +msgid "**Absolute values**," +msgstr "" + +#: ../../build/doc/concepts.rst:1004 +msgid "Let the beginning of the planning horizon ``2019-07-30 08:00:00``" +msgstr "" + +#: ../../build/doc/concepts.rst:1005 +msgid "for a 4 hour time window starting from the planning horizon" +msgstr "" + +#: ../../build/doc/concepts.rst:1007 +msgid "``tw_open`` = ``2019-07-30 08:00:00``" +msgstr "" + +#: ../../build/doc/concepts.rst:1008 +msgid "``tw_close`` = ``2019-07-30 12:00:00``" +msgstr "" + +#: ../../build/doc/concepts.rst:1010 +msgid "Times reported in output can be interpreted as ``TIMESTAMP``." +msgstr "" + +#: ../../build/doc/concepts.rst:1016 +msgid "Return columns & values" +msgstr "" + +#: ../../build/doc/concepts.rst:1019 +msgid "Pick-Deliver result columns" +msgstr "" + +#: ../../build/doc/concepts.rst:1022 +msgid "Results" +msgstr "" + +#: ../../build/doc/concepts.rst:1025 +#: ../../build/doc/concepts.rst:1096 +#: ../../build/doc/concepts.rst:1165 +msgid "Returns set of" +msgstr "" + +#: ../../build/doc/concepts.rst:1027 +msgid "``seq, vehicle_number, vehicle_id, stop_seq, stop_type, stop_id, order_id, cargo,``" +msgstr "" + +#: ../../build/doc/concepts.rst:1028 +#: ../../build/doc/concepts.rst:1099 +msgid "``travel_time, arrival_time, wait_time, service_time, departure_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1037 +#: ../../build/doc/concepts.rst:1108 +#: ../../build/doc/concepts.rst:1180 +msgid "``seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:1039 +#: ../../build/doc/concepts.rst:1110 +#: ../../build/doc/concepts.rst:1182 +msgid "Sequential value starting from **1**." +msgstr "" + +#: ../../build/doc/concepts.rst:1040 +#: ../../build/doc/concepts.rst:1111 +#: ../../build/doc/concepts.rst:1183 +msgid "``vehicle_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:1042 +#: ../../build/doc/concepts.rst:1113 +msgid "Sequential value starting from **1** for current vehicles. The :math:`n_{th}` vehicle in the solution." +msgstr "" + +#: ../../build/doc/concepts.rst:1045 +#: ../../build/doc/concepts.rst:1060 +#: ../../build/doc/concepts.rst:1063 +#: ../../build/doc/concepts.rst:1068 +#: ../../build/doc/concepts.rst:1071 +#: ../../build/doc/concepts.rst:1076 +#: ../../build/doc/concepts.rst:1079 +#: ../../build/doc/concepts.rst:1082 +#: ../../build/doc/concepts.rst:1085 +#: ../../build/doc/concepts.rst:1116 +#: ../../build/doc/concepts.rst:1131 +#: ../../build/doc/concepts.rst:1136 +#: ../../build/doc/concepts.rst:1139 +#: ../../build/doc/concepts.rst:1144 +#: ../../build/doc/concepts.rst:1147 +#: ../../build/doc/concepts.rst:1150 +#: ../../build/doc/concepts.rst:1153 +#: ../../build/doc/concepts.rst:1181 +#: ../../build/doc/concepts.rst:1184 +#: ../../build/doc/concepts.rst:1188 +#: ../../build/doc/concepts.rst:1197 +#: ../../build/doc/concepts.rst:1203 +#: ../../build/doc/concepts.rst:1215 +#: ../../build/doc/concepts.rst:1221 +#: ../../build/doc/concepts.rst:1251 +msgid "``BIGINT``" +msgstr "" + +#: ../../build/doc/concepts.rst:1046 +#: ../../build/doc/concepts.rst:1117 +#: ../../build/doc/concepts.rst:1189 +msgid "Current vehicle identifier." +msgstr "" + +#: ../../build/doc/concepts.rst:1047 +#: ../../build/doc/concepts.rst:1118 +msgid "``stop_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:1049 +#: ../../build/doc/concepts.rst:1120 +msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m_{th}` stop of the current vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:1051 +#: ../../build/doc/concepts.rst:1122 +msgid "``stop_type``" +msgstr "" + +#: ../../build/doc/concepts.rst:1053 +#: ../../build/doc/concepts.rst:1124 +msgid "Kind of stop location the vehicle is at:" +msgstr "" + +#: ../../build/doc/concepts.rst:1055 +#: ../../build/doc/concepts.rst:1126 +#: ../../build/doc/concepts.rst:1207 +msgid "``1``: Starting location" +msgstr "" + +#: ../../build/doc/concepts.rst:1056 +#: ../../build/doc/concepts.rst:1127 +msgid "``2``: Pickup location" +msgstr "" + +#: ../../build/doc/concepts.rst:1057 +#: ../../build/doc/concepts.rst:1128 +msgid "``3``: Delivery location" +msgstr "" + +#: ../../build/doc/concepts.rst:1058 +#: ../../build/doc/concepts.rst:1129 +#: ../../build/doc/concepts.rst:1212 +msgid "``6``: Ending location" +msgstr "" + +#: ../../build/doc/concepts.rst:1059 +msgid "``stop_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:1061 +msgid "Identifier of the stop." +msgstr "" + +#: ../../build/doc/concepts.rst:1062 +#: ../../build/doc/concepts.rst:1130 +msgid "``order_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:1064 +#: ../../build/doc/concepts.rst:1132 +msgid "Pickup-Delivery order pair identifier." +msgstr "" + +#: ../../build/doc/concepts.rst:1066 +#: ../../build/doc/concepts.rst:1134 +msgid "``-1``: When no order is involved on the current stop location." +msgstr "" + +#: ../../build/doc/concepts.rst:1067 +#: ../../build/doc/concepts.rst:1135 +msgid "``cargo``" +msgstr "" + +#: ../../build/doc/concepts.rst:1069 +#: ../../build/doc/concepts.rst:1137 +msgid "Cargo units of the vehicle when leaving the stop." +msgstr "" + +#: ../../build/doc/concepts.rst:1070 +#: ../../build/doc/concepts.rst:1138 +#: ../../build/doc/concepts.rst:1231 +msgid "``travel_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1072 +#: ../../build/doc/concepts.rst:1140 +msgid "Travel time from previous ``stop_seq`` to current ``stop_seq``." +msgstr "" + +#: ../../build/doc/concepts.rst:1074 +#: ../../build/doc/concepts.rst:1142 +msgid "``0`` When ``stop_type = 1``" +msgstr "" + +#: ../../build/doc/concepts.rst:1075 +#: ../../build/doc/concepts.rst:1143 +msgid "``arrival_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1077 +#: ../../build/doc/concepts.rst:1145 +msgid "Previous ``departure_time`` plus current ``travel_time``." +msgstr "" + +#: ../../build/doc/concepts.rst:1078 +#: ../../build/doc/concepts.rst:1146 +msgid "``wait_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1080 +#: ../../build/doc/concepts.rst:1148 +msgid "Time spent waiting for current `location` to open." +msgstr "" + +#: ../../build/doc/concepts.rst:1081 +#: ../../build/doc/concepts.rst:1149 +#: ../../build/doc/concepts.rst:1239 +msgid "``service_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1083 +#: ../../build/doc/concepts.rst:1151 +msgid "Service time at current `location`." +msgstr "" + +#: ../../build/doc/concepts.rst:1084 +#: ../../build/doc/concepts.rst:1152 +msgid "``departure_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1086 +#: ../../build/doc/concepts.rst:1154 +msgid ":math:`arrival\\_time + wait\\_time + service\\_time`." +msgstr "" + +#: ../../build/doc/concepts.rst:1088 +#: ../../build/doc/concepts.rst:1156 +msgid "When ``stop_type = 6`` has the `total_time` used for the current vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:1093 +msgid "Euclidean Results" +msgstr "" + +#: ../../build/doc/concepts.rst:1098 +msgid "``seq, vehicle_seq, vehicle_id, stop_seq, stop_type, order_id, cargo,``" +msgstr "" + +#: ../../build/doc/concepts.rst:1161 +msgid "VROOM result columns" +msgstr "" + +#: ../../build/doc/concepts.rst:1185 +msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." +msgstr "" + +#: ../../build/doc/concepts.rst:1191 +msgid "``-1``: Vehicle denoting all the unallocated tasks." +msgstr "" + +#: ../../build/doc/concepts.rst:1192 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:1193 +msgid "``vehicle_data``" +msgstr "" + +#: ../../build/doc/concepts.rst:1195 +msgid "Metadata information of the vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:1196 +msgid "``step_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:1198 +msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m^{th}` stop of the current vehicle." +msgstr "" + +#: ../../build/doc/concepts.rst:1201 +#: ../../build/doc/concepts.rst:1206 +#: ../../build/doc/concepts.rst:1218 +#: ../../build/doc/concepts.rst:1224 +msgid "``0``: Summary row" +msgstr "" + +#: ../../build/doc/concepts.rst:1202 +msgid "``step_type``" +msgstr "" + +#: ../../build/doc/concepts.rst:1204 +msgid "Kind of the step location the vehicle is at:" +msgstr "" + +#: ../../build/doc/concepts.rst:1208 +msgid "``2``: Job location" +msgstr "" + +#: ../../build/doc/concepts.rst:1209 +msgid "``3``: Pickup location" +msgstr "" + +#: ../../build/doc/concepts.rst:1210 +msgid "``4``: Delivery location" +msgstr "" + +#: ../../build/doc/concepts.rst:1211 +msgid "``5``: Break location" +msgstr "" + +#: ../../build/doc/concepts.rst:1214 +msgid "``task_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:1216 +msgid "Identifier of the task performed at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1219 +msgid "``-1``: If the step is starting/ending location." +msgstr "" + +#: ../../build/doc/concepts.rst:1222 +msgid "Identifier of the task location." +msgstr "" + +#: ../../build/doc/concepts.rst:1225 +msgid "``task_data``" +msgstr "" + +#: ../../build/doc/concepts.rst:1227 +msgid "Metadata information of the task." +msgstr "" + +#: ../../build/doc/concepts.rst:1228 +msgid "``arrival``" +msgstr "" + +#: ../../build/doc/concepts.rst:1230 +msgid "Estimated time of arrival at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1233 +msgid "Travel time from previous ``step_seq`` to current ``step_seq``." +msgstr "" + +#: ../../build/doc/concepts.rst:1235 +msgid "``0``: When ``step_type = 1``" +msgstr "" + +#: ../../build/doc/concepts.rst:1236 +msgid "``setup_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1238 +msgid "Setup time at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1241 +msgid "Service time at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1242 +msgid "``waiting_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:1244 +msgid "Waiting time at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1245 +msgid "``departure``" +msgstr "" + +#: ../../build/doc/concepts.rst:1247 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:1249 +msgid ":math:`arrival + service\\_time + waiting\\_time`." +msgstr "" + +#: ../../build/doc/concepts.rst:1250 +msgid "``load``" +msgstr "" + +#: ../../build/doc/concepts.rst:1252 +msgid "Vehicle load after step completion (with capacity constraints)" +msgstr "" + +#: ../../build/doc/concepts.rst:1256 +msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." +msgstr "" + +#: ../../build/doc/concepts.rst:1257 +msgid "The last step of every vehicle denotes the summary row, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the corresponding vehicle," +msgstr "" + +#: ../../build/doc/concepts.rst:1260 +msgid "The last row denotes the summary for the complete problem, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the complete problem," +msgstr "" + +#: ../../build/doc/concepts.rst:1268 +msgid "Performance" +msgstr "" + +#: ../../build/doc/concepts.rst:1273 +msgid "How to contribute" +msgstr "" + +#: ../../build/doc/concepts.rst:1276 +msgid "Wiki" +msgstr "" + +#: ../../build/doc/concepts.rst:1277 +msgid "Edit an existing `vrpRouting Wiki `_ page." +msgstr "" + +#: ../../build/doc/concepts.rst:1281 +msgid "Adding Functionaity to vrpRouting" +msgstr "" + +#: ../../build/doc/concepts.rst:1282 +msgid "Consult the `developer's documentation `_" +msgstr "" + +#: ../../build/doc/concepts.rst:1286 +msgid "Indices and tables" +msgstr "" + +#: ../../build/doc/concepts.rst:1287 +msgid ":ref:`genindex`" +msgstr "" + +#: ../../build/doc/concepts.rst:1288 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/release_notes.pot b/locale/pot/release_notes.pot index 2066c94af..3cc152206 100644 --- a/locale/pot/release_notes.pot +++ b/locale/pot/release_notes.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-29 23:53+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -68,43 +68,47 @@ msgstr "" msgid "Renamed files to be compiled as C++ with .hpp & .cpp extensions" msgstr "" -#: ../../build/doc/release_notes.rst:54 -msgid "Documentation queries" +#: ../../build/doc/release_notes.rst:51 +msgid "Moved sphinx doc from .c files .rst files" msgstr "" #: ../../build/doc/release_notes.rst:55 -msgid "Renamed to extension `.pg`" +msgid "Documentation queries" msgstr "" #: ../../build/doc/release_notes.rst:56 +msgid "Renamed to extension `.pg`" +msgstr "" + +#: ../../build/doc/release_notes.rst:57 msgid "Removed `doc-` and `doc-vrp_` suffixes on file names" msgstr "" -#: ../../build/doc/release_notes.rst:59 +#: ../../build/doc/release_notes.rst:60 msgid "vrpRouting 0.4.1 Release Notes" msgstr "" -#: ../../build/doc/release_notes.rst:61 +#: ../../build/doc/release_notes.rst:62 msgid "To see all issues & pull requests closed by this release see the `Git closed milestone for 0.4.1 `_ on Github." msgstr "" -#: ../../build/doc/release_notes.rst:67 +#: ../../build/doc/release_notes.rst:68 msgid "Modification on experimental functions" msgstr "" -#: ../../build/doc/release_notes.rst:68 +#: ../../build/doc/release_notes.rst:69 msgid "OR Tools" msgstr "" -#: ../../build/doc/release_notes.rst:70 +#: ../../build/doc/release_notes.rst:71 msgid "vrp_bin_packing" msgstr "" -#: ../../build/doc/release_notes.rst:71 +#: ../../build/doc/release_notes.rst:72 msgid "vrp_knapsack" msgstr "" -#: ../../build/doc/release_notes.rst:72 +#: ../../build/doc/release_notes.rst:73 msgid "vrp_multiple_knapsack" msgstr "" @@ -112,7 +116,7 @@ msgstr "" msgid "Support for or-tools v9.10.4067" msgstr "" -#: ../../build/doc/release_notes.rst:78 +#: ../../build/doc/release_notes.rst:79 msgid "vrp_oneDepot" msgstr "" @@ -124,17 +128,17 @@ msgstr "" msgid "Result columns changed" msgstr "" -#: ../../build/doc/release_notes.rst:85 +#: ../../build/doc/release_notes.rst:86 msgid "Removal of Boost on the build" msgstr "" -#: ../../build/doc/release_notes.rst:86 -#: ../../build/doc/release_notes.rst:184 +#: ../../build/doc/release_notes.rst:87 +#: ../../build/doc/release_notes.rst:185 msgid "vrp_full_version" msgstr "" -#: ../../build/doc/release_notes.rst:87 -#: ../../build/doc/release_notes.rst:183 +#: ../../build/doc/release_notes.rst:88 +#: ../../build/doc/release_notes.rst:184 msgid "vrp_version" msgstr "" @@ -142,201 +146,201 @@ msgstr "" msgid "Boost removed from the result columns" msgstr "" -#: ../../build/doc/release_notes.rst:94 +#: ../../build/doc/release_notes.rst:95 msgid "vrpRouting 0.4.0 Release Notes" msgstr "" -#: ../../build/doc/release_notes.rst:96 +#: ../../build/doc/release_notes.rst:97 msgid "To see all issues & pull requests closed by this release see the `Git closed milestone for 0.4.0 `_ on Github." msgstr "" -#: ../../build/doc/release_notes.rst:101 +#: ../../build/doc/release_notes.rst:102 msgid "Added support for VROOM 1.12.0 (`#34 `_)" msgstr "" -#: ../../build/doc/release_notes.rst:102 +#: ../../build/doc/release_notes.rst:103 msgid "No visible changes on user side with respect to signatures." msgstr "" -#: ../../build/doc/release_notes.rst:103 +#: ../../build/doc/release_notes.rst:104 msgid "Adjusted to VROOM v1.12.0 due to internal breaking changes:" msgstr "" -#: ../../build/doc/release_notes.rst:105 +#: ../../build/doc/release_notes.rst:106 msgid "Made changes according to new vroom::Input signature." msgstr "" -#: ../../build/doc/release_notes.rst:106 +#: ../../build/doc/release_notes.rst:107 msgid "CI changes to compile without routing support, with Position Independent Code." msgstr "" -#: ../../build/doc/release_notes.rst:107 +#: ../../build/doc/release_notes.rst:108 msgid "Removed support for VROOM 1.11.0" msgstr "" -#: ../../build/doc/release_notes.rst:110 +#: ../../build/doc/release_notes.rst:111 msgid "vrpRouting 0.3" msgstr "" -#: ../../build/doc/release_notes.rst:112 +#: ../../build/doc/release_notes.rst:113 msgid "To see all issues & pull requests closed by this release see the `Git closed milestone for 0.3.0 `_ on Github." msgstr "" -#: ../../build/doc/release_notes.rst:117 +#: ../../build/doc/release_notes.rst:118 msgid "Modification of experimental functions" msgstr "" -#: ../../build/doc/release_notes.rst:118 -#: ../../build/doc/release_notes.rst:156 +#: ../../build/doc/release_notes.rst:119 +#: ../../build/doc/release_notes.rst:157 msgid "VROOM" msgstr "" -#: ../../build/doc/release_notes.rst:120 -#: ../../build/doc/release_notes.rst:158 -msgid "vrp_vroom" -msgstr "" - #: ../../build/doc/release_notes.rst:121 #: ../../build/doc/release_notes.rst:159 -msgid "vrp_vroomJobs" +msgid "vrp_vroom" msgstr "" #: ../../build/doc/release_notes.rst:122 #: ../../build/doc/release_notes.rst:160 -msgid "vrp_vroomShipments" +msgid "vrp_vroomJobs" msgstr "" #: ../../build/doc/release_notes.rst:123 #: ../../build/doc/release_notes.rst:161 -msgid "vrp_vroomPlain" +msgid "vrp_vroomShipments" msgstr "" #: ../../build/doc/release_notes.rst:124 #: ../../build/doc/release_notes.rst:162 -msgid "vrp_vroomJobsPlain" +msgid "vrp_vroomPlain" msgstr "" #: ../../build/doc/release_notes.rst:125 #: ../../build/doc/release_notes.rst:163 +msgid "vrp_vroomJobsPlain" +msgstr "" + +#: ../../build/doc/release_notes.rst:126 +#: ../../build/doc/release_notes.rst:164 msgid "vrp_vroomShipmentsPlain" msgstr "" -#: ../../build/doc/release_notes.rst:128 +#: ../../build/doc/release_notes.rst:129 msgid "Added support for VROOM 1.11.0 (`#24 `_)" msgstr "" -#: ../../build/doc/release_notes.rst:129 +#: ../../build/doc/release_notes.rst:130 msgid "Added setup time in jobs and shipments to refine service time modeling." msgstr "" -#: ../../build/doc/release_notes.rst:130 +#: ../../build/doc/release_notes.rst:131 msgid "Added support for custom cost matrices, along with the duration matrix." msgstr "" -#: ../../build/doc/release_notes.rst:132 +#: ../../build/doc/release_notes.rst:133 msgid "Using start_id, end_id, duration, cost as matrix table columns." msgstr "" -#: ../../build/doc/release_notes.rst:133 +#: ../../build/doc/release_notes.rst:134 msgid "Added timeout and exploration_level parameters to vroom-category functions." msgstr "" -#: ../../build/doc/release_notes.rst:134 +#: ../../build/doc/release_notes.rst:135 msgid "Added max_tasks column in vehicles." msgstr "" -#: ../../build/doc/release_notes.rst:135 +#: ../../build/doc/release_notes.rst:136 msgid "Added tests for empty skills arrays." msgstr "" -#: ../../build/doc/release_notes.rst:136 +#: ../../build/doc/release_notes.rst:137 msgid "Added custom scaling logic for speed_factor." msgstr "" -#: ../../build/doc/release_notes.rst:137 +#: ../../build/doc/release_notes.rst:138 msgid "Modified parameter names to make the naming consistent." msgstr "" -#: ../../build/doc/release_notes.rst:140 +#: ../../build/doc/release_notes.rst:141 msgid "Fixes" msgstr "" -#: ../../build/doc/release_notes.rst:141 +#: ../../build/doc/release_notes.rst:142 msgid "Honor client cancel requests for vroom-category functions." msgstr "" -#: ../../build/doc/release_notes.rst:142 +#: ../../build/doc/release_notes.rst:143 msgid "Added more information in the inner query and result columns of VROOM category functions (`#26 `_, `#27 `_):" msgstr "" -#: ../../build/doc/release_notes.rst:145 +#: ../../build/doc/release_notes.rst:146 msgid "Summary row in the output, for each vehicle and for the complete problem." msgstr "" -#: ../../build/doc/release_notes.rst:146 +#: ../../build/doc/release_notes.rst:147 msgid "Uassigned rows in the output with vehicle_id = -1." msgstr "" -#: ../../build/doc/release_notes.rst:147 +#: ../../build/doc/release_notes.rst:148 msgid "Modified travel_time result column to return travel time between current and last step." msgstr "" -#: ../../build/doc/release_notes.rst:148 +#: ../../build/doc/release_notes.rst:149 msgid "Added data jsonb field in jobs, shipments, vehicles, breaks as well as in the result columns." msgstr "" -#: ../../build/doc/release_notes.rst:149 +#: ../../build/doc/release_notes.rst:150 msgid "Added departure field and location_id field in the result columns." msgstr "" -#: ../../build/doc/release_notes.rst:152 +#: ../../build/doc/release_notes.rst:153 msgid "vrpRouting 0.2" msgstr "" -#: ../../build/doc/release_notes.rst:155 +#: ../../build/doc/release_notes.rst:156 msgid "New experimental functions" msgstr "" -#: ../../build/doc/release_notes.rst:165 +#: ../../build/doc/release_notes.rst:166 msgid "VRP" msgstr "" -#: ../../build/doc/release_notes.rst:167 +#: ../../build/doc/release_notes.rst:168 msgid "vrp_compatibleVehicles" msgstr "" -#: ../../build/doc/release_notes.rst:168 +#: ../../build/doc/release_notes.rst:169 msgid "vrp_optimize" msgstr "" -#: ../../build/doc/release_notes.rst:169 +#: ../../build/doc/release_notes.rst:170 msgid "vrp_pickDeliverAdd" msgstr "" -#: ../../build/doc/release_notes.rst:170 +#: ../../build/doc/release_notes.rst:171 msgid "vrp_pickDeliver" msgstr "" -#: ../../build/doc/release_notes.rst:171 +#: ../../build/doc/release_notes.rst:172 msgid "vrp_simulation" msgstr "" -#: ../../build/doc/release_notes.rst:172 +#: ../../build/doc/release_notes.rst:173 msgid "vrp_viewRoute" msgstr "" -#: ../../build/doc/release_notes.rst:175 +#: ../../build/doc/release_notes.rst:176 msgid "vrpRouting 0.1" msgstr "" -#: ../../build/doc/release_notes.rst:178 +#: ../../build/doc/release_notes.rst:179 msgid "Extraction tasks" msgstr "" -#: ../../build/doc/release_notes.rst:179 +#: ../../build/doc/release_notes.rst:180 msgid "Porting pgRouting's VRP functionality" msgstr "" -#: ../../build/doc/release_notes.rst:182 +#: ../../build/doc/release_notes.rst:183 msgid "New official functions" msgstr "" diff --git a/locale/pot/vroom-category.pot b/locale/pot/vroom-category.pot index 04810af78..faf5b015c 100644 --- a/locale/pot/vroom-category.pot +++ b/locale/pot/vroom-category.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -213,864 +213,882 @@ msgstr "" msgid "**Skills**: Every task and vehicle may have some set of skills. A task can be served by only that vehicle which has all the skills of the task." msgstr "" -#: ../../build/doc/vroom-category.rst:89 +#: ../../build/doc/vroom-category.rst:90 msgid "**Priority**: Tasks may have some priority assigned, which is useful when all tasks cannot be performed due to constraints, so the tasks with low priority are left unassigned." msgstr "" -#: ../../build/doc/vroom-category.rst:90 +#: ../../build/doc/vroom-category.rst:93 msgid "**Amount (for shipment), Pickup and delivery (for job)**: They denote the multidimensional quantities such as number of items, weights, volume, etc." msgstr "" -#: ../../build/doc/vroom-category.rst:91 +#: ../../build/doc/vroom-category.rst:95 msgid "**Capacity (for vehicle)**: Every vehicle may have some capacity, denoting the multidimensional quantities. A vehicle can serve only those sets of tasks such that the total sum of the quantity does not exceed the vehicle capacity, at any point of the route." msgstr "" -#: ../../build/doc/vroom-category.rst:92 +#: ../../build/doc/vroom-category.rst:99 msgid "**Time Window**: An interval of time during which some activity can be performed, such as working hours of the vehicle, break of the vehicle, or service start time for a task." msgstr "" -#: ../../build/doc/vroom-category.rst:93 +#: ../../build/doc/vroom-category.rst:102 msgid "**Break**: Array of time windows, denoting valid slots for the break start of a vehicle." msgstr "" -#: ../../build/doc/vroom-category.rst:94 +#: ../../build/doc/vroom-category.rst:104 msgid "**Setup time**: Setup times serve as a mean to describe the time it takes to get started for a task at a given location. This models a duration that should not be re-applied for other tasks following at the same place. So the total \"action time\" for a task is ``setup + service`` upon arriving at a new location or ``service`` only if performing a new task at the previous vehicle location." msgstr "" -#: ../../build/doc/vroom-category.rst:98 +#: ../../build/doc/vroom-category.rst:111 msgid "**Service time**: The additional time to be spent by a vehicle while serving a task." msgstr "" -#: ../../build/doc/vroom-category.rst:99 +#: ../../build/doc/vroom-category.rst:113 msgid "**Travel time**: The total time the vehicle travels during its route." msgstr "" -#: ../../build/doc/vroom-category.rst:100 +#: ../../build/doc/vroom-category.rst:114 msgid "**Waiting time**: The total time the vehicle is idle, i.e. it is neither traveling nor servicing any task. It is generally the time spent by a vehicle waiting for a task service to open." msgstr "" -#: ../../build/doc/vroom-category.rst:109 +#: ../../build/doc/vroom-category.rst:119 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vroom-category.rst:112 +#: ../../build/doc/vroom-category.rst:122 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +#: ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:78 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:29 msgid "Column" msgstr "" -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:30 msgid "Type" msgstr "" -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:31 msgid "Default" msgstr "" -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 msgid "Description" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:33 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 +#: ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/breaks_input.c:17 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:80 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "Array of non-negative integers describing multidimensional quantities for delivery such as number of items, weight, volume etc." -msgstr "" - -#: ../../src/common/vroom/jobs_input.c:26 -msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" -msgstr "" - -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" -msgstr "" - -#: ../../src/common/vroom/jobs_input.c:29 +#: ../../build/doc/concepts.rst:51 msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:33 +#: ../../build/doc/concepts.rst:54 msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:58 +msgid "Array of non-negative integers describing multidimensional quantities for delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:61 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:65 +#: ../../build/doc/concepts.rst:81 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:85 msgid "``INTEGER``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/concepts.rst:68 +#: ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:69 +#: ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "**data**" -msgstr "" - -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 +#: ../../build/doc/concepts.rst:73 msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/vroom-category.rst:129 +msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:0 -#: ../../src/common/vroom/shipments_input.c:0 -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" msgstr "" -#: ../../build/doc/vroom-category.rst:119 -msgid "Shipments SQL" +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 -msgid "Positive unique identifier of the shipment." +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:36 +msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 -msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:72 +msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" +#: ../../build/doc/concepts.rst:75 +msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/vroom-category.rst:138 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../build/doc/vroom-category.rst:128 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:15 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -msgid "**start_id**" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 +#: ../../build/doc/concepts.rst:45 msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:84 msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 +#: ../../build/doc/concepts.rst:53 msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:54 msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" +msgstr "" + +#: ../../build/doc/concepts.rst:59 msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:60 msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "Max value of speed factor for a vehicle shall not be greater than 5 times the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:46 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../build/sql/vroom/vrp_vroom.sql:73 +#: ../../build/doc/concepts.rst:81 +#: ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "If ``end_id`` is omitted, the resulting route will stop at the last visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "If ``start_id`` is omitted, the resulting route will start at the first visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "To request a round trip, specify both ``start_id`` and ``end_id`` as the same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "A vehicle is only allowed to serve a set of tasks if the resulting load at each route step is lower than the matching value in capacity for each metric. When using multiple components for amounts, it is recommended to put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "It is assumed that all delivery-related amounts for jobs are loaded at vehicle start, while all pickup-related amounts for jobs are brought back at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" +#: ../../build/doc/vroom-category.rst:145 +msgid "Breaks SQL" msgstr "" -#: ../../build/doc/vroom-category.rst:135 -msgid "Breaks SQL" +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../build/doc/vroom-category.rst:142 -msgid "Time Windows SQL" +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." +#: ../../build/doc/vroom-category.rst:152 +msgid "Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**Only required for shipments time windows**. Value in ['p', 'd'] indicating whether the time window is for:" +#: ../../build/doc/concepts.rst:18 +msgid "Positive unique identifier of the: job, pickup/delivery shipment, or break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "**Relative values**, e.g. [0, 14400] for a 4 hours time window starting at the beginning of the planning horizon. In that case all times reported in output with the arrival column are relative to the start of the planning horizon." +#: ../../build/doc/vroom-category.rst:159 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "**Absolute values**, \"real\" timestamps. In that case all times reported in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:149 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" -msgstr "" - -#: ../../build/doc/vroom-category.rst:158 +#: ../../build/doc/vroom-category.rst:168 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." +#: ../../build/doc/concepts.rst:23 +msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "The last step of every vehicle denotes the summary row, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "The last row denotes the summary for the complete problem, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the complete problem," msgstr "" -#: ../../build/doc/vroom-category.rst:169 +#: ../../build/doc/vroom-category.rst:175 msgid "See Also" msgstr "" -#: ../../build/doc/vroom-category.rst:173 +#: ../../build/doc/vroom-category.rst:179 msgid "`Wikipedia: Vehicle Routing problems `__" msgstr "" -#: ../../build/doc/vroom-category.rst:174 +#: ../../build/doc/vroom-category.rst:180 msgid "`VROOM: Vehicle Routing Open-source Optimization Machine `__" msgstr "" -#: ../../build/doc/vroom-category.rst:175 +#: ../../build/doc/vroom-category.rst:181 msgid "`VROOM API Documentation `__" msgstr "" -#: ../../build/doc/vroom-category.rst:180 +#: ../../build/doc/vroom-category.rst:186 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vroom-category.rst:181 +#: ../../build/doc/vroom-category.rst:187 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vroom-category.rst:182 +#: ../../build/doc/vroom-category.rst:188 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/vrp_multiple_knapsack.pot b/locale/pot/vrp_multiple_knapsack.pot index 5c3c2b6a7..8e46c6db9 100644 --- a/locale/pot/vrp_multiple_knapsack.pot +++ b/locale/pot/vrp_multiple_knapsack.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.4.1\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-22 19:34+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -120,11 +120,10 @@ msgstr "" msgid "vrp_knapsack" msgstr "" -#: ../../sql/or_tools/multiple_knapsack.sql:10 #: ../../build/doc/vrp_multiple_knapsack.rst:39 -#: ../../build/doc/vrp_multiple_knapsack.rst:70 -#: ../../build/doc/vrp_multiple_knapsack.rst:89 -#: ../../build/doc/vrp_multiple_knapsack.rst:115 +#: ../../build/doc/vrp_multiple_knapsack.rst:66 +#: ../../build/doc/vrp_multiple_knapsack.rst:85 +#: ../../build/doc/vrp_multiple_knapsack.rst:111 #: ../../build/doc/or_tools-category.rst:10 msgid "Description" msgstr "" @@ -153,86 +152,84 @@ msgstr "" msgid "OR EMPTY SET" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:61 +#: ../../build/doc/vrp_multiple_knapsack.rst:57 msgid "Parameters" msgstr "" -#: ../../sql/or_tools/multiple_knapsack.sql:10 -#: ../../build/doc/vrp_multiple_knapsack.rst:68 -#: ../../build/doc/vrp_multiple_knapsack.rst:86 -#: ../../build/doc/vrp_multiple_knapsack.rst:113 +#: ../../build/doc/vrp_multiple_knapsack.rst:64 +#: ../../build/doc/vrp_multiple_knapsack.rst:82 +#: ../../build/doc/vrp_multiple_knapsack.rst:109 #: ../../build/doc/or_tools-category.rst:8 msgid "Column" msgstr "" -#: ../../sql/or_tools/multiple_knapsack.sql:10 -#: ../../build/doc/vrp_multiple_knapsack.rst:69 -#: ../../build/doc/vrp_multiple_knapsack.rst:87 -#: ../../build/doc/vrp_multiple_knapsack.rst:114 +#: ../../build/doc/vrp_multiple_knapsack.rst:65 +#: ../../build/doc/vrp_multiple_knapsack.rst:83 +#: ../../build/doc/vrp_multiple_knapsack.rst:110 #: ../../build/doc/or_tools-category.rst:9 msgid "Type" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:71 +#: ../../build/doc/vrp_multiple_knapsack.rst:67 msgid "`Weight Costs SQL`_" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:72 +#: ../../build/doc/vrp_multiple_knapsack.rst:68 msgid "``TEXT``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:73 +#: ../../build/doc/vrp_multiple_knapsack.rst:69 msgid "`Weight Costs SQL`_ as described below" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:74 +#: ../../build/doc/vrp_multiple_knapsack.rst:70 msgid "capacities" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:75 +#: ../../build/doc/vrp_multiple_knapsack.rst:71 msgid "``ARRAY[`` **ANY-INTEGER** ``]``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:76 +#: ../../build/doc/vrp_multiple_knapsack.rst:72 msgid "An array describing the capacity of each knapsack." msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:79 +#: ../../build/doc/vrp_multiple_knapsack.rst:75 msgid "Optional Parameters" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:88 +#: ../../build/doc/vrp_multiple_knapsack.rst:84 msgid "Default" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:90 +#: ../../build/doc/vrp_multiple_knapsack.rst:86 msgid "``max_rows``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:91 +#: ../../build/doc/vrp_multiple_knapsack.rst:87 #: ../../build/doc/or_tools-category.rst:12 #: ../../build/doc/or_tools-category.rst:15 #: ../../build/doc/or_tools-category.rst:18 msgid "**ANY-INTEGER**" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:92 +#: ../../build/doc/vrp_multiple_knapsack.rst:88 msgid ":math:`100000`" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:93 +#: ../../build/doc/vrp_multiple_knapsack.rst:89 msgid "Maximum items(rows) to fetch from bin_packing_data table." msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:96 +#: ../../build/doc/vrp_multiple_knapsack.rst:92 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:99 +#: ../../build/doc/vrp_multiple_knapsack.rst:95 msgid "Weight Costs SQL" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:119 +#: ../../build/doc/vrp_multiple_knapsack.rst:115 #: ../../build/doc/or_tools-category.rst:11 msgid "``id``" msgstr "" @@ -269,57 +266,32 @@ msgstr "" msgid "``SMALLINT``, ``INTEGER``, ``BIGINT``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:106 +#: ../../build/doc/vrp_multiple_knapsack.rst:102 msgid "Result Columns" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:116 +#: ../../build/doc/vrp_multiple_knapsack.rst:112 msgid "``knapsak``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:117 -#: ../../build/doc/vrp_multiple_knapsack.rst:120 +#: ../../build/doc/vrp_multiple_knapsack.rst:113 +#: ../../build/doc/vrp_multiple_knapsack.rst:116 msgid "``INTEGER``" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:118 +#: ../../build/doc/vrp_multiple_knapsack.rst:114 msgid "Indentifier of the knapsack." msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:121 +#: ../../build/doc/vrp_multiple_knapsack.rst:117 msgid "Indentifier of an item in the ``knapsack``." msgstr "" -#: ../../sql/or_tools/multiple_knapsack.sql:3 -msgid "Returns set of" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:12 -msgid "**knapsack_number**" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:12 -#: ../../sql/or_tools/multiple_knapsack.sql:14 -msgid "``ANY-INTEGER``" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:12 -msgid "Integer to uniquely identify a knapsack" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:14 -msgid "**item_id**" -msgstr "" - -#: ../../sql/or_tools/multiple_knapsack.sql:14 -msgid "Integer to uniquely identify an item in the bin" -msgstr "" - -#: ../../build/doc/vrp_multiple_knapsack.rst:128 +#: ../../build/doc/vrp_multiple_knapsack.rst:120 msgid "Example" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:135 +#: ../../build/doc/vrp_multiple_knapsack.rst:127 msgid "See Also" msgstr "" @@ -331,14 +303,14 @@ msgstr "" msgid "`OR-Tools: Google OR-Tools `__" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:142 +#: ../../build/doc/vrp_multiple_knapsack.rst:134 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:143 +#: ../../build/doc/vrp_multiple_knapsack.rst:135 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_multiple_knapsack.rst:144 +#: ../../build/doc/vrp_multiple_knapsack.rst:136 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/vrp_pgr_pickDeliver.pot b/locale/pot/vrp_pgr_pickDeliver.pot index 15adbb383..83a6e09cf 100644 --- a/locale/pot/vrp_pgr_pickDeliver.pot +++ b/locale/pot/vrp_pgr_pickDeliver.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-09-28 10:43+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -228,600 +228,659 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:91 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:85 +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:0 +msgid "pgr_pickDeliver(" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:0 +msgid "`Orders SQL`_, `Vehicles SQL`_, `Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:0 +msgid "``[factor, max_cycles, initial_sol]``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:0 +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:0 +msgid "``seq, vehicle_number, vehicle_id, stop, order_id, stop_type, cargo,``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:0 +#: ../../build/doc/concepts.rst:6 +msgid "``travel_time, arrival_time, wait_time, service_time, departure_time``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:96 msgid "Parameters" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 -#: ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:14 -#: ../../src/common/matrixRows_input.c:10 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:104 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:128 +#: ../../build/doc/concepts.rst:11 +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 msgid "Column" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 -#: ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:14 -#: ../../src/common/matrixRows_input.c:10 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:105 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:129 +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 msgid "Type" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 -#: ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:14 -msgid "Default" -msgstr "" - -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 -#: ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:14 -#: ../../src/common/matrixRows_input.c:10 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:4 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:106 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:131 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 msgid "Description" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -msgid "**Orders SQL**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:107 +msgid "`Orders SQL`_" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:108 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:111 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:114 msgid "``TEXT``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -msgid "`Orders SQL`_ query contianing the orders to be processed." +#: ../../build/doc/vrp_pgr_pickDeliver.rst:109 +msgid "`Orders SQL`_ as described below." +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:110 +msgid "`Vehicles SQL`_" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliver.rst:112 +msgid "`Vehicles SQL`_ as described below." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:113 +msgid "`Matrix SQL`_" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -msgid "`Vehicles SQL`_ query containing the vehicles to be used." +#: ../../build/doc/vrp_pgr_pickDeliver.rst:115 +msgid "`Matrix SQL`_ as described below." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:120 +msgid "Optional Parameters" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 -msgid "`Time Matrix SQL`_ query containing the distance or travel times." +#: ../../build/doc/vrp_pgr_pickDeliver.rst:130 +#: ../../build/doc/concepts.rst:15 +msgid "Default" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 -msgid "**factor**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:132 +msgid "``factor``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:133 msgid "``NUMERIC``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:134 +#: ../../build/doc/concepts.rst:29 msgid "1" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:135 msgid "Travel time multiplier. See :ref:`pd_factor`" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 -msgid "**max_cycles**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:136 +msgid "``max_cycles``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:11 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:137 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:141 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:138 msgid "10" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:139 msgid "Maximum number of cycles to perform on the optimization." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:11 -msgid "**initial_sol**" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:140 +msgid "``initial_sol``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:11 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:142 msgid "4" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:11 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:143 msgid "Initial solution to be used." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:13 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:145 msgid "``1`` One order per truck" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:14 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:146 msgid "``2`` Push front order." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:15 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:147 msgid "``3`` Push back order." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:16 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:148 msgid "``4`` Optimize insert." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:17 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:149 msgid "``5`` Push back order that allows more orders to be inserted at the back" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:18 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:150 msgid "``6`` Push front order that allows more orders to be inserted at the front" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:99 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:155 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:103 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:159 msgid "Orders SQL" msgstr "" -#: ../../src/common/orders_input.c:3 -#: ../../src/common/vehicles_input.c:3 -#: ../../src/common/matrixRows_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/orders_input.c:15 -#: ../../src/common/vehicles_input.c:16 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, amount``" msgstr "" -#: ../../src/common/orders_input.c:15 -#: ../../src/common/orders_input.c:17 -#: ../../src/common/orders_input.c:21 -#: ../../src/common/vehicles_input.c:16 -#: ../../src/common/vehicles_input.c:19 -#: ../../src/common/vehicles_input.c:27 -#: ../../src/common/matrixRows_input.c:12 +#: ../../build/doc/concepts.rst:6 +msgid "``p_id, p_tw_open, p_tw_close, [p_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:7 +msgid "``d_id, d_tw_open, d_tw_close, [d_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:17 +msgid "``id``" +msgstr "" + +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:68 msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/orders_input.c:15 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the pick-delivery order pair." msgstr "" -#: ../../src/common/orders_input.c:16 -msgid "**amount**" -msgstr "" - -#: ../../src/common/orders_input.c:16 -#: ../../src/common/orders_input.c:18 -#: ../../src/common/orders_input.c:19 -#: ../../src/common/orders_input.c:20 -#: ../../src/common/orders_input.c:22 -#: ../../src/common/orders_input.c:23 -#: ../../src/common/orders_input.c:24 -#: ../../src/common/vehicles_input.c:17 -#: ../../src/common/vehicles_input.c:18 -#: ../../src/common/vehicles_input.c:20 -#: ../../src/common/vehicles_input.c:23 -#: ../../src/common/vehicles_input.c:26 -#: ../../src/common/vehicles_input.c:28 -#: ../../src/common/vehicles_input.c:31 -#: ../../src/common/vehicles_input.c:34 -#: ../../src/common/matrixRows_input.c:13 -#: ../../src/common/matrixRows_input.c:14 +#: ../../build/doc/concepts.rst:21 +msgid "``amount``" +msgstr "" + +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/orders_input.c:16 -msgid "Number of units in the order" +#: ../../build/doc/concepts.rst:24 +msgid "Number of units in the order." +msgstr "" + +#: ../../build/doc/concepts.rst:25 +msgid "``p_id``" msgstr "" -#: ../../src/common/orders_input.c:17 -msgid "**p_id**" +#: ../../build/doc/concepts.rst:28 +msgid "Identifier of the pickup node." msgstr "" -#: ../../src/common/orders_input.c:17 -msgid "The identifier of the pickup node." +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:56 +msgid "Must match a node identifier in the `Matrix SQL`_." msgstr "" -#: ../../src/common/orders_input.c:18 -msgid "**p_tw_open**" +#: ../../build/doc/concepts.rst:31 +msgid "``p_tw_open``" msgstr "" -#: ../../src/common/orders_input.c:18 +#: ../../build/doc/concepts.rst:34 msgid "The time, relative to 0, when the pickup location opens." msgstr "" -#: ../../src/common/orders_input.c:19 -msgid "**p_tw_close**" +#: ../../build/doc/concepts.rst:35 +msgid "``p_tw_close``" msgstr "" -#: ../../src/common/orders_input.c:19 +#: ../../build/doc/concepts.rst:38 msgid "The time, relative to 0, when the pickup location closes." msgstr "" -#: ../../src/common/orders_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:40 +msgid ":math:`p\\_tw\\_open < p\\_tw\\_close < 9223372036854775807`" msgstr "" -#: ../../src/common/orders_input.c:20 -#: ../../src/common/orders_input.c:24 +#: ../../build/doc/concepts.rst:41 +msgid "``p_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:63 msgid "0" msgstr "" -#: ../../src/common/orders_input.c:20 +#: ../../build/doc/concepts.rst:44 msgid "The duration of the loading at the pickup location." msgstr "" -#: ../../src/common/orders_input.c:21 -msgid "**d_id**" +#: ../../build/doc/concepts.rst:45 +msgid "``d_id``" msgstr "" -#: ../../src/common/orders_input.c:21 -msgid "The identifier of the delivery node." +#: ../../build/doc/concepts.rst:48 +msgid "Identifier of the delivery node." msgstr "" -#: ../../src/common/orders_input.c:22 -msgid "**d_tw_open**" +#: ../../build/doc/concepts.rst:51 +msgid "``d_tw_open``" msgstr "" -#: ../../src/common/orders_input.c:22 +#: ../../build/doc/concepts.rst:54 msgid "The time, relative to 0, when the delivery location opens." msgstr "" -#: ../../src/common/orders_input.c:23 -msgid "**d_tw_close**" +#: ../../build/doc/concepts.rst:55 +msgid "``d_tw_close``" msgstr "" -#: ../../src/common/orders_input.c:23 +#: ../../build/doc/concepts.rst:58 msgid "The time, relative to 0, when the delivery location closes." msgstr "" -#: ../../src/common/orders_input.c:24 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:60 +msgid ":math:`d\\_tw\\_open < d\\_tw\\_close <= 9223372036854775807`" +msgstr "" + +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/orders_input.c:24 +#: ../../build/doc/concepts.rst:64 msgid "The duration of the unloading at the delivery location." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:110 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:166 msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vehicles_input.c:16 -msgid "Identifier of the vehicle" +#: ../../build/doc/concepts.rst:5 +msgid "``id, capacity, [speed,]``" msgstr "" -#: ../../src/common/vehicles_input.c:17 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:6 +msgid "``s_id, [s_tw_open, s_tw_close, s_service,]``" msgstr "" -#: ../../src/common/vehicles_input.c:17 -msgid "Capacity of the vehicle" +#: ../../build/doc/concepts.rst:7 +msgid "``[e_id, e_tw_open, e_tw_close, e_service]``" msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid "**speed**" +#: ../../build/doc/concepts.rst:20 +msgid "Identifier of the vehicle" msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid "`1`" +#: ../../build/doc/concepts.rst:21 +msgid "``capacity``" msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid "Average speed of the vehicle." +#: ../../build/doc/concepts.rst:24 +msgid "Capacity of the vehicle." msgstr "" -#: ../../src/common/vehicles_input.c:19 -msgid "**s_id**" +#: ../../build/doc/concepts.rst:26 +msgid ":math:`0 < capacity <= 4294967295`." msgstr "" -#: ../../src/common/vehicles_input.c:19 -msgid "The node identifier of the starting location, must match a node identifier in the matrix table." +#: ../../build/doc/concepts.rst:27 +msgid "``speed``" msgstr "" -#: ../../src/common/vehicles_input.c:20 -msgid "**s_tw_open**" +#: ../../build/doc/concepts.rst:30 +msgid "Speed of the vehicle." msgstr "" -#: ../../src/common/vehicles_input.c:20 -#: ../../src/common/vehicles_input.c:26 -msgid "`0`" +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:53 +msgid "``s_id``" msgstr "" -#: ../../src/common/vehicles_input.c:20 -msgid "The time, relative to 0, when the starting location opens. When `s_tw_open` column exist then `s_tw_close` column is expected Default value when (`s_tw_open`, s_tw_close) columns do not exist" +#: ../../build/doc/concepts.rst:34 +msgid "The node identifier of the starting location." msgstr "" -#: ../../src/common/vehicles_input.c:23 -msgid "**s_tw_close**" +#: ../../build/doc/concepts.rst:37 +#: ../../build/doc/concepts.rst:59 +msgid "``s_tw_open``" msgstr "" -#: ../../src/common/vehicles_input.c:23 -msgid "`INFINITY`" +#: ../../build/doc/concepts.rst:40 +msgid "The time, relative to 0, when the starting location opens." msgstr "" -#: ../../src/common/vehicles_input.c:23 -msgid "The time, relative to 0, when the starting location closes. When `s_tw_close` column exist then `e_tw_open` column is expected Default value when `(s_tw_open, s_tw_close)` columns do not exist" +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:63 +msgid "``s_tw_close``" msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "**s_service**" +#: ../../build/doc/concepts.rst:43 +msgid "|MAX-BIGINT|" msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "The duration of the loading at the starting location." +#: ../../build/doc/concepts.rst:44 +msgid "The time, relative to 0, when the starting location closes." msgstr "" -#: ../../src/common/vehicles_input.c:27 -msgid "**e_id**" +#: ../../build/doc/concepts.rst:46 +msgid ":math:`s\\_tw\\_open < s\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/vehicles_input.c:27 -msgid "`s_id`" +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:69 +msgid "``s_service``" msgstr "" -#: ../../src/common/vehicles_input.c:27 -msgid "The node identifier of the ending location, must match a node identifier in the matrix table." +#: ../../build/doc/concepts.rst:50 +msgid "Duration of any task at the starting location," msgstr "" -#: ../../src/common/vehicles_input.c:28 -msgid "**e_tw_open**" +#: ../../build/doc/concepts.rst:51 +msgid "``e_id``" msgstr "" -#: ../../src/common/vehicles_input.c:28 -msgid "`s_tw_open`" +#: ../../build/doc/concepts.rst:54 +msgid "The node identifier of the ending location." msgstr "" -#: ../../src/common/vehicles_input.c:28 -msgid "The time, relative to 0, when the ending location opens. When `e_tw_open` column exist then `e__tw_close` column is expected Default value when (`e_tw_open`, e_tw_close) columns do not exist" +#: ../../build/doc/concepts.rst:57 +msgid "``e_tw_open``" msgstr "" -#: ../../src/common/vehicles_input.c:31 -msgid "**e_tw_close**" +#: ../../build/doc/concepts.rst:60 +msgid "The time, relative to 0, when the ending location opens." msgstr "" -#: ../../src/common/vehicles_input.c:31 -msgid "`s_tw_close`" +#: ../../build/doc/concepts.rst:61 +msgid "``e_tw_close``" msgstr "" -#: ../../src/common/vehicles_input.c:31 -msgid "The time, relative to 0, when the ending location closes. When `e_tw_close` column exist then `e_tw_open` column is expected Default value when `(e_tw_open`, e_tw_close)` columns do not exist" +#: ../../build/doc/concepts.rst:64 +msgid "The time, relative to 0, when the ending location closes." msgstr "" -#: ../../src/common/vehicles_input.c:34 -msgid "**e_service**" +#: ../../build/doc/concepts.rst:66 +msgid ":math:`e\\_tw\\_open < e\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/vehicles_input.c:34 -msgid "`s_service`" +#: ../../build/doc/concepts.rst:67 +msgid "``e_service``" msgstr "" -#: ../../src/common/vehicles_input.c:34 -msgid "The duration of the unloading at the ending location." +#: ../../build/doc/concepts.rst:70 +msgid "The duration of any task at the ending location" msgstr "" -#: ../../src/common/vehicles_input.c:37 -msgid "Throws: * When column `id` is missing * When column `capacity` is missing * When column `s_id` is missing * When column `s_tw_open` exists but not `s_tw_close` * When column `s_tw_close`exists but not `s_tw_open` * When column `e_tw_open` exists but not `e_tw_close` * When column `e_tw_close`exists but not `e_tw_open`" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:174 +msgid "Matrix SQL" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:118 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:5 +msgid "``start_vid, end_vid, agg_cost``" msgstr "" -#: ../../src/common/matrixRows_input.c:12 -msgid "**start_vid**" +#: ../../build/doc/concepts.rst:14 +msgid "``start_vid``" msgstr "" -#: ../../src/common/matrixRows_input.c:12 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:19 msgid "Identifier of a node." msgstr "" -#: ../../src/common/matrixRows_input.c:13 -msgid "**end_vid**" +#: ../../build/doc/concepts.rst:17 +msgid "``end_vid``" msgstr "" -#: ../../src/common/matrixRows_input.c:13 -msgid "Identifier of a node" +#: ../../build/doc/concepts.rst:20 +msgid "``agg_cost``" msgstr "" -#: ../../src/common/matrixRows_input.c:14 -msgid "**agg_cost**" +#: ../../build/doc/concepts.rst:22 +msgid "Cost to travel from ``start_vid`` to ``end_vid``" msgstr "" -#: ../../src/common/matrixRows_input.c:14 -msgid "Time to travel from ``start_vid`` to ``end_vid``" +#: ../../build/doc/vrp_pgr_pickDeliver.rst:181 +msgid "Result Columns" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:125 -msgid "Result Columns" +#: ../../build/doc/concepts.rst:3 +msgid "Returns set of" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -msgid "**seq**" +#: ../../build/doc/concepts.rst:5 +msgid "``seq, vehicle_number, vehicle_id, stop_seq, stop_type, stop_id, order_id, cargo,``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:17 -msgid "INTEGER" +#: ../../build/doc/concepts.rst:15 +msgid "``seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:6 +#: ../../build/doc/concepts.rst:17 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:7 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1** for current vehicles. The :math:`n_{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:22 +msgid "``vehicle_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:18 -msgid "BIGINT" +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:54 +#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:60 +#: ../../build/doc/concepts.rst:63 +msgid "``BIGINT``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:8 +#: ../../build/doc/concepts.rst:24 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 -msgid "**stop_seq**" +#: ../../build/doc/concepts.rst:25 +msgid "``stop_seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:9 +#: ../../build/doc/concepts.rst:27 msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m_{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 -msgid "**stop_type**" +#: ../../build/doc/concepts.rst:29 +msgid "``stop_type``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:10 +#: ../../build/doc/concepts.rst:31 msgid "Kind of stop location the vehicle is at:" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:12 +#: ../../build/doc/concepts.rst:33 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:13 +#: ../../build/doc/concepts.rst:34 msgid "``2``: Pickup location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:14 +#: ../../build/doc/concepts.rst:35 msgid "``3``: Delivery location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:15 +#: ../../build/doc/concepts.rst:36 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:17 -msgid "**stop_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``stop_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:18 -msgid "**order_id**" +#: ../../build/doc/concepts.rst:39 +msgid "Identifier of the stop." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:18 -msgid "Pickup-Delivery order pair identifier." +#: ../../build/doc/concepts.rst:40 +msgid "``order_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:20 -msgid "``-1``: When no order is involved on the current stop location." +#: ../../build/doc/concepts.rst:42 +msgid "Pickup-Delivery order pair identifier." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:22 -msgid "**cargo**" +#: ../../build/doc/concepts.rst:44 +msgid "``-1``: When no order is involved on the current stop location." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:22 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:24 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:28 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:29 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:30 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:31 -msgid "FLOAT" +#: ../../build/doc/concepts.rst:45 +msgid "``cargo``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:22 +#: ../../build/doc/concepts.rst:47 msgid "Cargo units of the vehicle when leaving the stop." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:24 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:48 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:24 +#: ../../build/doc/concepts.rst:50 msgid "Travel time from previous ``stop_seq`` to current ``stop_seq``." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:26 +#: ../../build/doc/concepts.rst:52 msgid "``0`` When ``stop_type = 1``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:28 -msgid "**arrival_time**" +#: ../../build/doc/concepts.rst:53 +msgid "``arrival_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:28 +#: ../../build/doc/concepts.rst:55 msgid "Previous ``departure_time`` plus current ``travel_time``." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:29 -msgid "**wait_time**" +#: ../../build/doc/concepts.rst:56 +msgid "``wait_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:29 +#: ../../build/doc/concepts.rst:58 msgid "Time spent waiting for current `location` to open." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:30 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:59 +msgid "``service_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:30 +#: ../../build/doc/concepts.rst:61 msgid "Service time at current `location`." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:31 -msgid "**departure_time**" +#: ../../build/doc/concepts.rst:62 +msgid "``departure_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:31 +#: ../../build/doc/concepts.rst:64 msgid ":math:`arrival\\_time + wait\\_time + service\\_time`." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliver.sql:33 +#: ../../build/doc/concepts.rst:66 msgid "When ``stop_type = 6`` has the `total_time` used for the current vehicle." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:132 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:188 msgid "Example" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:136 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:192 msgid "This example use the following data:" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:144 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:200 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:146 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:202 msgid ":doc:`pgr-category`" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:147 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:203 msgid "The queries use the :doc:`sampledata` network." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:150 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:206 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:151 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:207 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliver.rst:152 +#: ../../build/doc/vrp_pgr_pickDeliver.rst:208 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/vrp_pgr_pickDeliverEuclidean.pot b/locale/pot/vrp_pgr_pickDeliverEuclidean.pot index c9baeebd7..29f346b0d 100644 --- a/locale/pot/vrp_pgr_pickDeliverEuclidean.pot +++ b/locale/pot/vrp_pgr_pickDeliverEuclidean.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-09-28 10:43+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -220,591 +220,641 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:91 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:85 +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:0 +msgid "``pgr_pickDeliverEuclidean(``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:0 +msgid "`Orders SQL`_, `Vehicles SQL`_" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:0 +msgid "``[factor, max_cycles, initial_sol]``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:0 +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:0 +msgid "``seq, vehicle_number, vehicle_id, stop, order_id, stop_type, cargo,``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:0 +#: ../../build/doc/concepts.rst:6 +msgid "``travel_time, arrival_time, wait_time, service_time, departure_time``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:96 msgid "Parameters" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 -#: ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:12 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:105 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:127 +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 msgid "Column" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 -#: ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:12 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:106 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:128 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:15 msgid "Type" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 -#: ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:12 -msgid "Default" -msgstr "" - -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 -#: ../../src/common/orders_input.c:13 -#: ../../src/common/vehicles_input.c:12 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:4 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:107 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:130 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 msgid "Description" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -msgid "**Orders SQL**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:108 +msgid "`Orders SQL`_" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:109 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:112 msgid "``TEXT``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -msgid "`Orders SQL`_ query contianing the orders to be processed." +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:110 +msgid "`Orders SQL`_ as described below." +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:111 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:113 +msgid "`Vehicles SQL`_ as described below." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 -msgid "`Vehicles SQL`_ query containing the vehicles to be used." +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:118 +msgid "Optional Parameters" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 -msgid "**factor**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:129 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +msgid "Default" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:131 +msgid "``factor``" +msgstr "" + +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:132 msgid "``NUMERIC``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:133 +#: ../../build/doc/concepts.rst:27 msgid "1" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:134 msgid "Travel time multiplier. See :ref:`pd_factor`" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 -msgid "**max_cycles**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:135 +msgid "``max_cycles``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:136 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:140 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:137 msgid "10" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:138 msgid "Maximum number of cycles to perform on the optimization." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 -msgid "**initial_sol**" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:139 +msgid "``initial_sol``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:141 msgid "4" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:142 msgid "Initial solution to be used." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:12 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:144 msgid "``1`` One order per truck" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:13 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:145 msgid "``2`` Push front order." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:14 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:146 msgid "``3`` Push back order." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:15 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:147 msgid "``4`` Optimize insert." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:16 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:148 msgid "``5`` Push back order that allows more orders to be inserted at the back" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:17 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:150 msgid "``6`` Push front order that allows more orders to be inserted at the front" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:99 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:156 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:103 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:160 msgid "Orders SQL" msgstr "" -#: ../../src/common/orders_input.c:3 -#: ../../src/common/vehicles_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/orders_input.c:15 -#: ../../src/common/vehicles_input.c:14 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, amount``" msgstr "" -#: ../../src/common/orders_input.c:15 -#: ../../src/common/orders_input.c:16 -#: ../../src/common/orders_input.c:19 -#: ../../src/common/orders_input.c:20 -#: ../../src/common/orders_input.c:21 -#: ../../src/common/orders_input.c:24 -#: ../../src/common/orders_input.c:25 -#: ../../src/common/orders_input.c:26 -#: ../../src/common/vehicles_input.c:14 +#: ../../build/doc/concepts.rst:6 +msgid "``p_x, p_y, p_tw_open, p_tw_close, [p_service,]``" +msgstr "" + +#: ../../build/doc/concepts.rst:7 +msgid "``d_x, d_y, d_tw_open, d_tw_close, [d_service]``" +msgstr "" + +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +msgid "``id``" +msgstr "" + +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:60 +#: ../../build/doc/concepts.rst:61 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:70 msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/orders_input.c:15 +#: ../../build/doc/concepts.rst:21 msgid "Identifier of the pick-delivery order pair." msgstr "" -#: ../../src/common/orders_input.c:16 -msgid "**amount**" +#: ../../build/doc/concepts.rst:22 +msgid "``amount``" msgstr "" -#: ../../src/common/orders_input.c:16 -msgid "Number of units in the order" +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:56 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/orders_input.c:17 -msgid "**p_x**" +#: ../../build/doc/concepts.rst:25 +msgid "Number of units in the order." msgstr "" -#: ../../src/common/orders_input.c:17 -#: ../../src/common/orders_input.c:18 -#: ../../src/common/orders_input.c:22 -#: ../../src/common/orders_input.c:23 -#: ../../src/common/vehicles_input.c:15 -#: ../../src/common/vehicles_input.c:16 -#: ../../src/common/vehicles_input.c:17 -#: ../../src/common/vehicles_input.c:18 -#: ../../src/common/vehicles_input.c:19 -#: ../../src/common/vehicles_input.c:22 -#: ../../src/common/vehicles_input.c:25 -#: ../../src/common/vehicles_input.c:26 -#: ../../src/common/vehicles_input.c:29 -#: ../../src/common/vehicles_input.c:32 -#: ../../src/common/vehicles_input.c:33 -#: ../../src/common/vehicles_input.c:36 -msgid "|ANY-NUMERICAL|" +#: ../../build/doc/concepts.rst:26 +msgid "``p_x``" msgstr "" -#: ../../src/common/orders_input.c:17 -msgid ":math:`x` value of the pick up location" +#: ../../build/doc/concepts.rst:29 +msgid ":math:`x` value of the pickup location." msgstr "" -#: ../../src/common/orders_input.c:18 -msgid "**p_y**" +#: ../../build/doc/concepts.rst:30 +msgid "``p_y``" msgstr "" -#: ../../src/common/orders_input.c:18 -msgid ":math:`y` value of the pick up location" +#: ../../build/doc/concepts.rst:33 +msgid ":math:`y` value of the pickup location." msgstr "" -#: ../../src/common/orders_input.c:19 -msgid "**p_tw_open**" +#: ../../build/doc/concepts.rst:34 +msgid "``p_tw_open``" msgstr "" -#: ../../src/common/orders_input.c:19 +#: ../../build/doc/concepts.rst:37 msgid "The time, relative to 0, when the pickup location opens." msgstr "" -#: ../../src/common/orders_input.c:20 -msgid "**p_tw_close**" +#: ../../build/doc/concepts.rst:38 +msgid "``p_tw_close``" msgstr "" -#: ../../src/common/orders_input.c:20 +#: ../../build/doc/concepts.rst:41 msgid "The time, relative to 0, when the pickup location closes." msgstr "" -#: ../../src/common/orders_input.c:21 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:43 +msgid ":math:`p\\_tw\\_open < p\\_tw\\_close < 9223372036854775807`" msgstr "" -#: ../../src/common/orders_input.c:21 -#: ../../src/common/orders_input.c:26 +#: ../../build/doc/concepts.rst:44 +msgid "``p_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:68 msgid "0" msgstr "" -#: ../../src/common/orders_input.c:21 +#: ../../build/doc/concepts.rst:47 msgid "The duration of the loading at the pickup location." msgstr "" -#: ../../src/common/orders_input.c:22 -msgid "**d_x**" +#: ../../build/doc/concepts.rst:48 +msgid "``d_x``" msgstr "" -#: ../../src/common/orders_input.c:22 -msgid ":math:`x` value of the delivery location" +#: ../../build/doc/concepts.rst:51 +msgid ":math:`x` value of the delivery location." msgstr "" -#: ../../src/common/orders_input.c:23 -msgid "**d_y**" +#: ../../build/doc/concepts.rst:52 +msgid "``d_y``" msgstr "" -#: ../../src/common/orders_input.c:23 -msgid ":math:`y` value of the delivery location" +#: ../../build/doc/concepts.rst:55 +msgid ":math:`y` value of the delivery location." msgstr "" -#: ../../src/common/orders_input.c:24 -msgid "**d_tw_open**" +#: ../../build/doc/concepts.rst:56 +msgid "``d_tw_open``" msgstr "" -#: ../../src/common/orders_input.c:24 +#: ../../build/doc/concepts.rst:59 msgid "The time, relative to 0, when the delivery location opens." msgstr "" -#: ../../src/common/orders_input.c:25 -msgid "**d_tw_close**" +#: ../../build/doc/concepts.rst:60 +msgid "``d_tw_close``" msgstr "" -#: ../../src/common/orders_input.c:25 +#: ../../build/doc/concepts.rst:63 msgid "The time, relative to 0, when the delivery location closes." msgstr "" -#: ../../src/common/orders_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:65 +msgid ":math:`d\\_tw\\_open < d\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/orders_input.c:26 -msgid "The duration of the loading at the delivery location." +#: ../../build/doc/concepts.rst:66 +msgid "``d_service``" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:110 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:69 +msgid "The duration of the unloading at the delivery location." msgstr "" -#: ../../src/common/vehicles_input.c:14 -msgid "Identifier of the vehicle" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:167 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vehicles_input.c:15 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, capacity, [speed,]``" msgstr "" -#: ../../src/common/vehicles_input.c:15 -msgid "Capacity of the vehicle" +#: ../../build/doc/concepts.rst:6 +msgid "``s_x, s_y, [s_tw_open, s_tw_close, s_service]``" msgstr "" -#: ../../src/common/vehicles_input.c:16 -msgid "**speed**" +#: ../../build/doc/concepts.rst:7 +msgid "``[e_x, e_y, e_tw_open, e_tw_close, e_service]``" msgstr "" -#: ../../src/common/vehicles_input.c:16 -msgid "`1`" +#: ../../build/doc/concepts.rst:20 +msgid "Identifier of the vehicle." msgstr "" -#: ../../src/common/vehicles_input.c:16 -msgid "Average speed of the vehicle." +#: ../../build/doc/concepts.rst:21 +msgid "``capacity``" msgstr "" -#: ../../src/common/vehicles_input.c:17 -msgid "**s_x**" +#: ../../build/doc/concepts.rst:24 +msgid "Capacity of the vehicle. :math:`0 < capacity <= 4294967295`." msgstr "" -#: ../../src/common/vehicles_input.c:17 -msgid ":math:`x` value of the coordinate of the starting location." +#: ../../build/doc/concepts.rst:25 +msgid "``speed``" msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid "**s_y**" +#: ../../build/doc/concepts.rst:28 +msgid "Speed of the vehicle." msgstr "" -#: ../../src/common/vehicles_input.c:18 -msgid ":math:`y` value of the coordinate of the starting location." +#: ../../build/doc/concepts.rst:29 +msgid "``s_x``" msgstr "" -#: ../../src/common/vehicles_input.c:19 -msgid "**s_tw_open**" -msgstr "" - -#: ../../src/common/vehicles_input.c:19 -#: ../../src/common/vehicles_input.c:25 -msgid "`0`" +#: ../../build/doc/concepts.rst:32 +msgid ":math:`x` value of the coordinate of the starting location." msgstr "" -#: ../../src/common/vehicles_input.c:19 -msgid "The time, relative to 0, when the starting location opens. When `s_tw_open` column exist then `s_tw_close` column is expected Default value when (`s_tw_open`, s_tw_close) columns do not exist" +#: ../../build/doc/concepts.rst:33 +msgid "``s_y``" msgstr "" -#: ../../src/common/vehicles_input.c:22 -msgid "**s_tw_close**" +#: ../../build/doc/concepts.rst:36 +msgid ":math:`y` value of the coordinate of the starting location." msgstr "" -#: ../../src/common/vehicles_input.c:22 -msgid "`INFINITY`" +#: ../../build/doc/concepts.rst:37 +#: ../../build/doc/concepts.rst:61 +msgid "``s_tw_open``" msgstr "" -#: ../../src/common/vehicles_input.c:22 -msgid "The time, relative to 0, when the starting location closes. When `s_tw_close` column exist then `e_tw_open` column is expected Default value when `(s_tw_open, s_tw_close)` columns do not exist" +#: ../../build/doc/concepts.rst:40 +msgid "The time, relative to 0, when the starting location opens." msgstr "" -#: ../../src/common/vehicles_input.c:25 -msgid "**s_service**" +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:65 +msgid "``s_tw_close``" msgstr "" -#: ../../src/common/vehicles_input.c:25 -msgid "The duration of the loading at the starting location." +#: ../../build/doc/concepts.rst:43 +msgid "|MAX-BIGINT|" msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "**e_tw_open**" +#: ../../build/doc/concepts.rst:44 +msgid "The time, relative to 0, when the starting location closes." msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "`s_tw_open`" +#: ../../build/doc/concepts.rst:46 +msgid ":math:`s\\_tw\\_open < s\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/vehicles_input.c:26 -msgid "The time, relative to 0, when the ending location opens. When `e_tw_open` column exist then `e__tw_close` column is expected Default value when (`e_tw_open`, e_tw_close) columns do not exist" +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:71 +msgid "``s_service``" msgstr "" -#: ../../src/common/vehicles_input.c:29 -msgid "**e_tw_close**" +#: ../../build/doc/concepts.rst:50 +msgid "Duration of any task at the ending location," msgstr "" -#: ../../src/common/vehicles_input.c:29 -msgid "`s_tw_close`" +#: ../../build/doc/concepts.rst:51 +msgid "``e_x``" msgstr "" -#: ../../src/common/vehicles_input.c:29 -msgid "The time, relative to 0, when the ending location closes. When `e_tw_close` column exist then `e_tw_open` column is expected Default value when `(e_tw_open`, e_tw_close)` columns do not exist" +#: ../../build/doc/concepts.rst:54 +msgid ":math:`x` value of the coordinate of the ending location." msgstr "" -#: ../../src/common/vehicles_input.c:32 -msgid "**e_service**" +#: ../../build/doc/concepts.rst:55 +msgid "``e_y``" msgstr "" -#: ../../src/common/vehicles_input.c:32 -msgid "`s_service`" +#: ../../build/doc/concepts.rst:58 +msgid ":math:`y` value of the coordinate of the ending location." msgstr "" -#: ../../src/common/vehicles_input.c:32 -msgid "The duration of the loading at the ending location." +#: ../../build/doc/concepts.rst:59 +msgid "``e_tw_open``" msgstr "" -#: ../../src/common/vehicles_input.c:33 -msgid "**e_x**" +#: ../../build/doc/concepts.rst:62 +msgid "The time, relative to 0, when the ending location opens." msgstr "" -#: ../../src/common/vehicles_input.c:33 -msgid "`s_x`" +#: ../../build/doc/concepts.rst:63 +msgid "``e_tw_close``" msgstr "" -#: ../../src/common/vehicles_input.c:33 -msgid ":math:`x` value of the coordinate of the ending location. Default value when `(e_x, e_y)` columns do not exist Default value when `e_y` column does not exist" +#: ../../build/doc/concepts.rst:66 +msgid "The time, relative to 0, when the ending location closes." msgstr "" -#: ../../src/common/vehicles_input.c:36 -msgid "**e_y**" +#: ../../build/doc/concepts.rst:68 +msgid ":math:`e\\_tw\\_open < e\\_tw\\_close <= 9223372036854775807`" msgstr "" -#: ../../src/common/vehicles_input.c:36 -msgid "`s_y`" +#: ../../build/doc/concepts.rst:69 +msgid "``e_service``" msgstr "" -#: ../../src/common/vehicles_input.c:36 -msgid ":math:`y` value of the coordinate of the ending location. When `e_y` column exist then `e_x` column is expected Default value when `(e_x, e_y)` columns do not exist" +#: ../../build/doc/concepts.rst:72 +msgid "The duration of any task at the ending location" msgstr "" -#: ../../src/common/vehicles_input.c:41 -msgid "Throws: * When column `id` is missing * When column `capacity` is missing * When column `s_x` is missing * When column `s_y` is missing * When column `s_tw_open` exists but not `s_tw_close` * When column `s_tw_close`exists but not `s_tw_open` * When column `e_y` exists but not `e_x` * When column `e_x` exists but not `e_y` * When column `e_tw_open` exists but not `e_tw_close` * When column `e_tw_close`exists but not `e_tw_open`" +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:175 +msgid "Result Columns" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:118 -msgid "Result Columns" +#: ../../build/doc/concepts.rst:3 +msgid "Returns set of" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -msgid "**seq**" +#: ../../build/doc/concepts.rst:5 +msgid "``seq, vehicle_seq, vehicle_id, stop_seq, stop_type, order_id, cargo,``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 -msgid "INTEGER" +#: ../../build/doc/concepts.rst:15 +msgid "``seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:6 +#: ../../build/doc/concepts.rst:17 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:7 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1** for current vehicles. The :math:`n_{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:22 +msgid "``vehicle_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:17 -msgid "BIGINT" +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:54 +#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:60 +msgid "``BIGINT``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:8 +#: ../../build/doc/concepts.rst:24 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 -msgid "**stop_seq**" +#: ../../build/doc/concepts.rst:25 +msgid "``stop_seq``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:9 +#: ../../build/doc/concepts.rst:27 msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m_{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 -msgid "**stop_type**" +#: ../../build/doc/concepts.rst:29 +msgid "``stop_type``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:10 +#: ../../build/doc/concepts.rst:31 msgid "Kind of stop location the vehicle is at:" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:12 +#: ../../build/doc/concepts.rst:33 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:13 +#: ../../build/doc/concepts.rst:34 msgid "``2``: Pickup location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:14 +#: ../../build/doc/concepts.rst:35 msgid "``3``: Delivery location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:15 +#: ../../build/doc/concepts.rst:36 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:17 -msgid "**order_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``order_id``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:17 +#: ../../build/doc/concepts.rst:39 msgid "Pickup-Delivery order pair identifier." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:19 +#: ../../build/doc/concepts.rst:41 msgid "``-1``: When no order is involved on the current stop location." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:21 -msgid "**cargo**" -msgstr "" - -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:21 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:23 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:27 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:28 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:29 -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:30 -msgid "FLOAT" +#: ../../build/doc/concepts.rst:42 +msgid "``cargo``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:21 +#: ../../build/doc/concepts.rst:44 msgid "Cargo units of the vehicle when leaving the stop." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:23 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:45 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:23 +#: ../../build/doc/concepts.rst:47 msgid "Travel time from previous ``stop_seq`` to current ``stop_seq``." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:25 +#: ../../build/doc/concepts.rst:49 msgid "``0`` When ``stop_type = 1``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:27 -msgid "**arrival_time**" +#: ../../build/doc/concepts.rst:50 +msgid "``arrival_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:27 +#: ../../build/doc/concepts.rst:52 msgid "Previous ``departure_time`` plus current ``travel_time``." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:28 -msgid "**wait_time**" +#: ../../build/doc/concepts.rst:53 +msgid "``wait_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:28 +#: ../../build/doc/concepts.rst:55 msgid "Time spent waiting for current `location` to open." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:29 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:56 +msgid "``service_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:29 +#: ../../build/doc/concepts.rst:58 msgid "Service time at current `location`." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:30 -msgid "**departure_time**" +#: ../../build/doc/concepts.rst:59 +msgid "``departure_time``" msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:30 +#: ../../build/doc/concepts.rst:61 msgid ":math:`arrival\\_time + wait\\_time + service\\_time`." msgstr "" -#: ../../build/sql/pgr_pickDeliver/pgr_pickDeliverEuclidean.sql:32 +#: ../../build/doc/concepts.rst:63 msgid "When ``stop_type = 6`` has the `total_time` used for the current vehicle." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:126 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:183 msgid "Example" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:130 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:187 msgid "This example use the following data:" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:139 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:196 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:140 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:197 msgid ":doc:`pgr-category`" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:141 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:198 msgid "The queries use the :doc:`sampledata` network." msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:144 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:201 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:145 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:202 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:146 +#: ../../build/doc/vrp_pgr_pickDeliverEuclidean.rst:203 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/vrp_vroom.pot b/locale/pot/vrp_vroom.pot index 99613cbdc..e1d32e22c 100644 --- a/locale/pot/vrp_vroom.pot +++ b/locale/pot/vrp_vroom.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -121,15 +121,15 @@ msgid "New **experimental** function" msgstr "" #: ../../build/doc/vrp_vroom.rst:39 -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:85 +#: ../../build/doc/vrp_vroom.rst:125 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 msgid "Description" msgstr "" @@ -141,963 +141,1030 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_vroom.rst:53 -msgid "Summary" +#: ../../build/doc/vrp_vroom.rst:52 +msgid "\\ \\" msgstr "" -#: ../../build/doc/vrp_vroom.rst:58 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroom.rst:0 +msgid "vrp_vroom(" msgstr "" -#: ../../build/doc/vrp_vroom.rst:61 -msgid "Using defaults" +#: ../../build/doc/vrp_vroom.rst:0 +msgid "`Jobs SQL`_, `Jobs Time Windows SQL`_," msgstr "" -#: ../../build/doc/vrp_vroom.rst:66 +#: ../../build/doc/vrp_vroom.rst:0 +msgid "`Shipments SQL`_, `Shipments Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:0 +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:0 +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:0 +#: ../../build/doc/vrp_vroom.rst:107 +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:0 +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:0 +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:0 +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:0 +msgid "task_data, arrival, travel_time, service_time, waiting_time, departure, load)" +msgstr "" + +#: ../../build/doc/vrp_vroom.rst:67 msgid "**Example**: This example is based on the modified VROOM Data of the :doc:`sampledata` network. The modification in the tables is mentioned at the end of the :doc:`sampledata`." msgstr "" -#: ../../build/doc/vrp_vroom.rst:80 +#: ../../build/doc/vrp_vroom.rst:75 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:4 +#: ../../build/doc/vrp_vroom.rst:83 +#: ../../build/doc/vrp_vroom.rst:122 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:84 +#: ../../build/doc/vrp_vroom.rst:123 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:30 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**Jobs SQL**" +#: ../../build/doc/vrp_vroom.rst:86 +msgid "`Jobs SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -#: ../../build/sql/vroom/vrp_vroom.sql:8 -#: ../../build/sql/vroom/vrp_vroom.sql:10 -#: ../../build/sql/vroom/vrp_vroom.sql:12 -#: ../../build/sql/vroom/vrp_vroom.sql:14 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:16 -#: ../../build/sql/vroom/vrp_vroom.sql:18 +#: ../../build/doc/vrp_vroom.rst:87 +#: ../../build/doc/vrp_vroom.rst:90 +#: ../../build/doc/vrp_vroom.rst:93 +#: ../../build/doc/vrp_vroom.rst:96 +#: ../../build/doc/vrp_vroom.rst:99 +#: ../../build/doc/vrp_vroom.rst:102 +#: ../../build/doc/vrp_vroom.rst:105 +#: ../../build/doc/vrp_vroom.rst:108 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "`Jobs SQL`_ query describing the single-location pickup and/or delivery tasks." +#: ../../build/doc/vrp_vroom.rst:88 +msgid "Query describing the single-location pickup and/or delivery" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 -msgid "**Jobs Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:89 +msgid "`Jobs Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for job service start." +#: ../../build/doc/vrp_vroom.rst:91 +msgid "Query describing valid slots for job service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:10 -msgid "**Shipments SQL**" +#: ../../build/doc/vrp_vroom.rst:92 +msgid "`Shipments SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:10 -msgid "`Shipments SQL`_ query describing pickup and delivery tasks that should happen within same route." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:12 -msgid "**Shipments Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:94 +msgid "Query describing pickup and delivery tasks that should happen within same route." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for pickup and delivery service start." +#: ../../build/doc/vrp_vroom.rst:95 +msgid "`Shipments Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:14 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroom.rst:97 +msgid "Query describing valid slots for pickup and delivery service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:14 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroom.rst:98 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroom.rst:100 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroom.rst:101 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:103 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroom.rst:104 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroom.rst:106 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -msgid "`Time Matrix SQL`_ query containing the distance or travel times between the locations." +#: ../../build/doc/vrp_vroom.rst:109 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/doc/vrp_vroom.rst:87 +#: ../../build/doc/vrp_vroom.rst:114 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 +#: ../../build/doc/vrp_vroom.rst:124 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:31 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroom.rst:126 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/vrp_vroom.rst:127 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:85 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:128 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:129 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 +#: ../../build/doc/vrp_vroom.rst:131 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:9 +#: ../../build/doc/vrp_vroom.rst:132 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroom.rst:133 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:134 msgid "``INTERVAL``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:135 msgid "'-00:00:01'::INTERVAL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:136 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/vrp_vroom.rst:138 msgid "Gives the best possible solution within a time limit. Note that some additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 +#: ../../build/doc/vrp_vroom.rst:140 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroom.rst:94 +#: ../../build/doc/vrp_vroom.rst:145 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroom.rst:97 +#: ../../build/doc/vrp_vroom.rst:148 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +#: ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:78 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:29 msgid "Column" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:33 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 +#: ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/breaks_input.c:17 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:80 +msgid "``[]``" +msgstr "" + +#: ../../build/doc/concepts.rst:51 +msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." +msgstr "" + +#: ../../build/doc/concepts.rst:54 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 +#: ../../build/doc/concepts.rst:58 msgid "Array of non-negative integers describing multidimensional quantities for delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:26 +#: ../../build/doc/concepts.rst:61 msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:65 +#: ../../build/doc/concepts.rst:81 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." +#: ../../build/doc/concepts.rst:68 +#: ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:33 -msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +#: ../../build/doc/concepts.rst:69 +#: ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" +#: ../../build/doc/concepts.rst:73 +msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/vrp_vroom.rst:155 +msgid "Jobs Time Windows SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +msgid "Positive unique identifier of the: job, pickup/delivery shipment, or break." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "**data**" +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -msgid "Any metadata information of the job." +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/jobs_input.c:0 -#: ../../src/common/vroom/shipments_input.c:0 -msgid "ANY-INTEGER" +#: ../../build/doc/vrp_vroom.rst:162 +msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" msgstr "" -#: ../../build/doc/vrp_vroom.rst:104 -msgid "Shipments SQL" +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:72 msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 +#: ../../build/doc/concepts.rst:75 msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" +#: ../../build/doc/vrp_vroom.rst:169 +msgid "Shipments Time Windows SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -msgid "**start_id**" +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/vrp_vroom.rst:176 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|tw_close_default|" +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:59 +msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" +msgstr "" + +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "Max value of speed factor for a vehicle shall not be greater than 5 times the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:46 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../build/sql/vroom/vrp_vroom.sql:73 +#: ../../build/doc/concepts.rst:81 +#: ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "If ``end_id`` is omitted, the resulting route will stop at the last visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "If ``start_id`` is omitted, the resulting route will start at the first visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "To request a round trip, specify both ``start_id`` and ``end_id`` as the same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "A vehicle is only allowed to serve a set of tasks if the resulting load at each route step is lower than the matching value in capacity for each metric. When using multiple components for amounts, it is recommended to put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "It is assumed that all delivery-related amounts for jobs are loaded at vehicle start, while all pickup-related amounts for jobs are brought back at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroom.rst:183 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." -msgstr "" - -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**Only required for shipments time windows**. Value in ['p', 'd'] indicating whether the time window is for:" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroom.rst:190 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "**Relative values**, e.g. [0, 14400] for a 4 hours time window starting at the beginning of the planning horizon. In that case all times reported in output with the arrival column are relative to the start of the planning horizon." +#: ../../build/doc/vrp_vroom.rst:197 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "**Absolute values**, \"real\" timestamps. In that case all times reported in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" -msgstr "" - -#: ../../build/doc/vrp_vroom.rst:115 +#: ../../build/doc/vrp_vroom.rst:204 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." +#: ../../build/doc/concepts.rst:23 +msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "The last step of every vehicle denotes the summary row, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "The last row denotes the summary for the complete problem, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroom.rst:122 +#: ../../build/doc/vrp_vroom.rst:211 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroom.rst:124 +#: ../../build/doc/vrp_vroom.rst:213 msgid "Problem involving 2 jobs and 1 shipment, using a single vehicle, similar to the VROOM Documentation `Example 2 `__ with a shipment." msgstr "" -#: ../../build/doc/vrp_vroom.rst:132 +#: ../../build/doc/vrp_vroom.rst:221 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroom.rst:134 +#: ../../build/doc/vrp_vroom.rst:223 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroom.rst:135 +#: ../../build/doc/vrp_vroom.rst:224 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -1113,14 +1180,14 @@ msgstr "" msgid "`VROOM API Documentation `__" msgstr "" -#: ../../build/doc/vrp_vroom.rst:142 +#: ../../build/doc/vrp_vroom.rst:231 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroom.rst:143 +#: ../../build/doc/vrp_vroom.rst:232 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroom.rst:144 +#: ../../build/doc/vrp_vroom.rst:233 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/vrp_vroomJobs.pot b/locale/pot/vrp_vroomJobs.pot index cd8aef4fe..bbfb7602b 100644 --- a/locale/pot/vrp_vroomJobs.pot +++ b/locale/pot/vrp_vroomJobs.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -121,14 +121,13 @@ msgid "New **experimental** function" msgstr "" #: ../../build/doc/vrp_vroomJobs.rst:39 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroomJobs.rst:82 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/vrp_vroom.rst:10 msgid "Description" msgstr "" @@ -140,827 +139,843 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:52 -msgid "Summary" +#: ../../build/doc/vrp_vroomJobs.rst:51 +msgid "\\ \\" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:57 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomJobs.rst:0 +msgid "vrp_vroom(" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:60 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomJobs.rst:0 +msgid "`Jobs SQL`_, `Jobs Time Windows SQL`_," msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:65 +#: ../../build/doc/vrp_vroomJobs.rst:0 +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst:0 +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst:0 +#: ../../build/doc/vrp_vroomJobs.rst:98 +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst:0 +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst:0 +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst:0 +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst:0 +msgid "task_data, arrival, travel_time, service_time, waiting_time, departure, load)" +msgstr "" + +#: ../../build/doc/vrp_vroomJobs.rst:64 msgid "**Example**: This example is based on the modified VROOM Data of the :doc:`sampledata` network. The modification in the tables is mentioned at the end of the :doc:`sampledata`." msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:79 +#: ../../build/doc/vrp_vroomJobs.rst:72 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:4 +#: ../../build/doc/vrp_vroomJobs.rst:80 +#: ../../build/doc/vrp_vroom.rst:7 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroomJobs.rst:81 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/vrp_vroom.rst:8 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -msgid "**Jobs SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:83 +msgid "`Jobs SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 +#: ../../build/doc/vrp_vroomJobs.rst:84 +#: ../../build/doc/vrp_vroomJobs.rst:87 +#: ../../build/doc/vrp_vroomJobs.rst:90 +#: ../../build/doc/vrp_vroomJobs.rst:93 +#: ../../build/doc/vrp_vroomJobs.rst:96 +#: ../../build/doc/vrp_vroomJobs.rst:99 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -msgid "`Jobs SQL`_ query describing the single-location pickup and/or delivery tasks." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -msgid "**Jobs Time Windows SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:85 +msgid "Query describing the single-location pickup and/or delivery" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for job service start." +#: ../../build/doc/vrp_vroomJobs.rst:86 +msgid "`Jobs Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:88 +msgid "Query describing valid slots for job service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroomJobs.rst:89 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:91 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroomJobs.rst:92 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:94 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroomJobs.rst:95 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:97 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 -msgid "`Time Matrix SQL`_ query containing the distance or travel times between the locations." +#: ../../build/doc/vrp_vroomJobs.rst:100 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:86 +#: ../../build/doc/vrp_vroomJobs.rst:105 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/vrp_vroom.rst:9 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroom.rst:11 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/vehicles_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/vrp_vroom.rst:12 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:13 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:14 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 +#: ../../build/doc/vrp_vroom.rst:16 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:9 +#: ../../build/doc/vrp_vroom.rst:17 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroom.rst:18 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:19 msgid "``INTERVAL``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:20 msgid "'-00:00:01'::INTERVAL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:21 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/vrp_vroom.rst:23 msgid "Gives the best possible solution within a time limit. Note that some additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 +#: ../../build/doc/vrp_vroom.rst:25 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:93 +#: ../../build/doc/vrp_vroomJobs.rst:112 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:96 +#: ../../build/doc/vrp_vroomJobs.rst:115 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:62 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:66 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:20 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:27 msgid "Column" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "**id**" +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:31 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:36 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 +#: ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/breaks_input.c:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:46 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/breaks_input.c:17 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "Array of non-negative integers describing multidimensional quantities for delivery such as number of items, weight, volume etc." +#: ../../build/doc/concepts.rst:51 +msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:26 -msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" +#: ../../build/doc/concepts.rst:54 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." +#: ../../build/doc/concepts.rst:58 +msgid "Array of non-negative integers describing multidimensional quantities for delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:33 -msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +#: ../../build/doc/concepts.rst:61 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:65 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:68 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:69 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "**priority**" +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "0" +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:73 +msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "**data**" +#: ../../build/doc/vrp_vroomJobs.rst:122 +msgid "Jobs Time Windows SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:17 +msgid "Positive unique identifier of the: job, pickup/delivery shipment, or break." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -msgid "Any metadata information of the job." +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -msgid "Where:" +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:0 -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/vrp_vroomJobs.rst:129 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -msgid "**start_id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:42 +msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 +#: ../../build/doc/concepts.rst:59 msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "Max value of speed factor for a vehicle shall not be greater than 5 times the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:46 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../build/sql/vroom/vrp_vroom.sql:73 +#: ../../build/doc/concepts.rst:81 +#: ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "If ``end_id`` is omitted, the resulting route will stop at the last visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "If ``start_id`` is omitted, the resulting route will start at the first visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "To request a round trip, specify both ``start_id`` and ``end_id`` as the same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "A vehicle is only allowed to serve a set of tasks if the resulting load at each route step is lower than the matching value in capacity for each metric. When using multiple components for amounts, it is recommended to put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "It is assumed that all delivery-related amounts for jobs are loaded at vehicle start, while all pickup-related amounts for jobs are brought back at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomJobs.rst:136 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." -msgstr "" - -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**Only required for shipments time windows**. Value in ['p', 'd'] indicating whether the time window is for:" +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomJobs.rst:143 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "**Relative values**, e.g. [0, 14400] for a 4 hours time window starting at the beginning of the planning horizon. In that case all times reported in output with the arrival column are relative to the start of the planning horizon." +#: ../../build/doc/vrp_vroomJobs.rst:150 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "**Absolute values**, \"real\" timestamps. In that case all times reported in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" -msgstr "" - -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:107 +#: ../../build/doc/vrp_vroomJobs.rst:157 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" +#: ../../build/doc/concepts.rst:23 +msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "The last step of every vehicle denotes the summary row, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "The last row denotes the summary for the complete problem, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:114 +#: ../../build/doc/vrp_vroomJobs.rst:164 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:116 +#: ../../build/doc/vrp_vroomJobs.rst:166 msgid "Problem involving 2 jobs, using a single vehicle, corresponding to the VROOM Documentation `Example 2 `__." msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:124 +#: ../../build/doc/vrp_vroomJobs.rst:174 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:126 +#: ../../build/doc/vrp_vroomJobs.rst:176 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:127 +#: ../../build/doc/vrp_vroomJobs.rst:177 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -976,14 +991,14 @@ msgstr "" msgid "`VROOM API Documentation `__" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:134 +#: ../../build/doc/vrp_vroomJobs.rst:184 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:135 +#: ../../build/doc/vrp_vroomJobs.rst:185 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomJobs.rst:136 +#: ../../build/doc/vrp_vroomJobs.rst:186 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/vrp_vroomJobsPlain.pot b/locale/pot/vrp_vroomJobsPlain.pot index ec1820529..11286f302 100644 --- a/locale/pot/vrp_vroomJobsPlain.pot +++ b/locale/pot/vrp_vroomJobsPlain.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -100,864 +100,879 @@ msgstr "" msgid "Might depend on a deprecated function of vrpRouting" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:28 +#: ../../build/doc/vrp_vroomJobsPlain.rst:29 msgid "Availability" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:29 +#: ../../build/doc/vrp_vroomJobsPlain.rst:30 msgid "Version 0.3.0" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:31 +#: ../../build/doc/vrp_vroomJobsPlain.rst:32 msgid "Function **modified** for VROOM 1.11.0" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:33 +#: ../../build/doc/vrp_vroomJobsPlain.rst:34 msgid "Version 0.2.0" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:35 +#: ../../build/doc/vrp_vroomJobsPlain.rst:36 msgid "New **experimental** function" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:39 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroomJobsPlain.rst:40 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/vrp_vroomJobs.rst:9 +#: ../../build/doc/vrp_vroomPlain.rst:10 msgid "Description" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:41 +#: ../../build/doc/vrp_vroomJobsPlain.rst:42 msgid "VROOM is an open-source optimization engine that aims at providing good solutions to various real-life vehicle routing problems (VRP) within a small computing time. This function can be used to get the solution to a problem involving only jobs." msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:49 +#: ../../build/doc/vrp_vroomJobsPlain.rst:50 msgid "Signature" msgstr "" #: ../../build/doc/vrp_vroomJobsPlain.rst:52 -msgid "Summary" +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst:0 +msgid "vrp_vroom(" +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst:0 +msgid "`Jobs SQL`_, `Jobs Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst:0 +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst:0 +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst:0 +#: ../../build/doc/vrp_vroomJobs.rst:25 +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst:0 +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" +msgstr "" + +#: ../../build/doc/vrp_vroomJobsPlain.rst:0 +msgid "RETURNS SET OF" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:57 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomJobsPlain.rst:0 +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:60 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomJobsPlain.rst:0 +msgid "task_data, arrival, travel_time, service_time, waiting_time, departure, load)" msgstr "" #: ../../build/doc/vrp_vroomJobsPlain.rst:65 msgid "**Example**: This example is based on the VROOM Data of the :doc:`sampledata` network:" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:78 +#: ../../build/doc/vrp_vroomJobsPlain.rst:72 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 +#: ../../build/doc/vrp_vroomJobs.rst:7 +#: ../../build/doc/vrp_vroomPlain.rst:7 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/vrp_vroomJobs.rst:8 +#: ../../build/doc/vrp_vroomPlain.rst:8 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -msgid "**Jobs SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:10 +msgid "`Jobs SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 +#: ../../build/doc/vrp_vroomJobs.rst:11 +#: ../../build/doc/vrp_vroomJobs.rst:14 +#: ../../build/doc/vrp_vroomJobs.rst:17 +#: ../../build/doc/vrp_vroomJobs.rst:20 +#: ../../build/doc/vrp_vroomJobs.rst:23 +#: ../../build/doc/vrp_vroomJobs.rst:26 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:6 -msgid "`Jobs SQL`_ query describing the single-location pickup and/or delivery tasks." +#: ../../build/doc/vrp_vroomJobs.rst:12 +msgid "Query describing the single-location pickup and/or delivery" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -msgid "**Jobs Time Windows SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:13 +msgid "`Jobs Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for job service start." +#: ../../build/doc/vrp_vroomJobs.rst:15 +msgid "Query describing valid slots for job service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:16 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:10 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroomJobs.rst:18 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:19 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:11 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroomJobs.rst:21 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:22 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroomJobs.rst:24 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroomJobs.rst:27 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/sql/vroom/vrp_vroomJobs.sql:14 -msgid "`Time Matrix SQL`_ query containing the distance or travel times between the locations." -msgstr "" - -#: ../../build/doc/vrp_vroomJobsPlain.rst:85 +#: ../../build/doc/vrp_vroomJobsPlain.rst:79 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/vrp_vroomPlain.rst:9 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroomPlain.rst:11 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/vehicles_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/vrp_vroomPlain.rst:12 +#: ../../build/doc/vrp_vroomPlain.rst:19 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:13 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:14 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:8 +#: ../../build/doc/vrp_vroomPlain.rst:16 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:9 +#: ../../build/doc/vrp_vroomPlain.rst:17 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroomPlain.rst:18 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:20 msgid ":math:`-1`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:21 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:13 +#: ../../build/doc/vrp_vroomPlain.rst:23 msgid "Gives the best possible solution within a time limit. Note that some additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:16 +#: ../../build/doc/vrp_vroomPlain.rst:25 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:92 +#: ../../build/doc/vrp_vroomJobsPlain.rst:86 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:95 +#: ../../build/doc/vrp_vroomJobsPlain.rst:89 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:62 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:66 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:20 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:27 msgid "Column" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "**id**" +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:31 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:36 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 +#: ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/breaks_input.c:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:46 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/breaks_input.c:17 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "Array of non-negative integers describing multidimensional quantities for delivery such as number of items, weight, volume etc." +#: ../../build/doc/concepts.rst:51 +msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:26 -msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" +#: ../../build/doc/concepts.rst:54 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." +#: ../../build/doc/concepts.rst:58 +msgid "Array of non-negative integers describing multidimensional quantities for delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:33 -msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +#: ../../build/doc/concepts.rst:61 +msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:65 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:68 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:69 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "**priority**" +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "0" +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:73 +msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "**data**" +#: ../../build/doc/vrp_vroomJobsPlain.rst:96 +msgid "Jobs Time Windows SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:17 +msgid "Positive unique identifier of the: job, pickup/delivery shipment, or break." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -msgid "Any metadata information of the job." +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -msgid "Where:" +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:0 -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/vrp_vroomJobsPlain.rst:103 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -msgid "**start_id**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:42 +msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 +#: ../../build/doc/concepts.rst:59 msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "Max value of speed factor for a vehicle shall not be greater than 5 times the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:46 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../build/sql/vroom/vrp_vroom.sql:73 +#: ../../build/doc/concepts.rst:81 +#: ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "If ``end_id`` is omitted, the resulting route will stop at the last visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "If ``start_id`` is omitted, the resulting route will start at the first visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "To request a round trip, specify both ``start_id`` and ``end_id`` as the same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "A vehicle is only allowed to serve a set of tasks if the resulting load at each route step is lower than the matching value in capacity for each metric. When using multiple components for amounts, it is recommended to put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "It is assumed that all delivery-related amounts for jobs are loaded at vehicle start, while all pickup-related amounts for jobs are brought back at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomJobsPlain.rst:110 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**Only required for shipments time windows**. Value in ['p', 'd'] indicating whether the time window is for:" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomJobsPlain.rst:117 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "**Relative values**, e.g. [0, 14400] for a 4 hours time window starting at the beginning of the planning horizon. In that case all times reported in output with the arrival column are relative to the start of the planning horizon." +#: ../../build/doc/vrp_vroomJobsPlain.rst:124 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "**Absolute values**, \"real\" timestamps. In that case all times reported in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" -msgstr "" - -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:106 +#: ../../build/doc/vrp_vroomJobsPlain.rst:131 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" +#: ../../build/doc/concepts.rst:23 +msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "The last step of every vehicle denotes the summary row, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "The last row denotes the summary for the complete problem, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:113 +#: ../../build/doc/vrp_vroomJobsPlain.rst:138 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:115 +#: ../../build/doc/vrp_vroomJobsPlain.rst:140 msgid "Problem involving 2 jobs, using a single vehicle, corresponding to the VROOM Documentation `Example 2 `__." msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:123 +#: ../../build/doc/vrp_vroomJobsPlain.rst:148 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:125 +#: ../../build/doc/vrp_vroomJobsPlain.rst:150 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:126 +#: ../../build/doc/vrp_vroomJobsPlain.rst:151 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -973,14 +988,14 @@ msgstr "" msgid "`VROOM API Documentation `__" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:133 +#: ../../build/doc/vrp_vroomJobsPlain.rst:158 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:134 +#: ../../build/doc/vrp_vroomJobsPlain.rst:159 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomJobsPlain.rst:135 +#: ../../build/doc/vrp_vroomJobsPlain.rst:160 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/vrp_vroomPlain.pot b/locale/pot/vrp_vroomPlain.pot index e0f62da21..0f7a53e66 100644 --- a/locale/pot/vrp_vroomPlain.pot +++ b/locale/pot/vrp_vroomPlain.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -100,1001 +100,1068 @@ msgstr "" msgid "Might depend on a deprecated function of vrpRouting" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:28 +#: ../../build/doc/vrp_vroomPlain.rst:29 msgid "Availability" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:29 +#: ../../build/doc/vrp_vroomPlain.rst:30 msgid "Version 0.3.0" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:31 +#: ../../build/doc/vrp_vroomPlain.rst:32 msgid "Function **modified** for VROOM 1.11.0" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:33 +#: ../../build/doc/vrp_vroomPlain.rst:34 msgid "Version 0.2.0" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:35 +#: ../../build/doc/vrp_vroomPlain.rst:36 msgid "New **experimental** function" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:39 -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:40 +#: ../../build/doc/vrp_vroomPlain.rst:93 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/vrp_vroom.rst:9 msgid "Description" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:41 +#: ../../build/doc/vrp_vroomPlain.rst:42 msgid "VROOM is an open-source optimization engine that aims at providing good solutions to various real-life vehicle routing problems (VRP) within a small computing time. This function can be used to get the solution to a problem involving both jobs and shipments." msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:50 +#: ../../build/doc/vrp_vroomPlain.rst:51 msgid "Signature" msgstr "" #: ../../build/doc/vrp_vroomPlain.rst:53 -msgid "Summary" +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:0 +msgid "vrp_vroom(" +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:0 +msgid "`Jobs SQL`_, `Jobs Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:0 +msgid "`Shipments SQL`_, `Shipments Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:0 +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:0 +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:0 +#: ../../build/doc/vrp_vroom.rst:31 +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:0 +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:58 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomPlain.rst:0 +msgid "RETURNS SET OF" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:61 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomPlain.rst:0 +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:66 +#: ../../build/doc/vrp_vroomPlain.rst:0 +msgid "task_data, arrival, travel_time, service_time, waiting_time, departure, load)" +msgstr "" + +#: ../../build/doc/vrp_vroomPlain.rst:68 msgid "**Example**: This example is based on the VROOM Data of the :doc:`sampledata` network:" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:79 +#: ../../build/doc/vrp_vroomPlain.rst:75 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 +#: ../../build/doc/vrp_vroomPlain.rst:90 +#: ../../build/doc/vrp_vroom.rst:7 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:91 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/vrp_vroom.rst:8 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**Jobs SQL**" +#: ../../build/doc/vrp_vroom.rst:10 +msgid "`Jobs SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -#: ../../build/sql/vroom/vrp_vroom.sql:8 -#: ../../build/sql/vroom/vrp_vroom.sql:10 -#: ../../build/sql/vroom/vrp_vroom.sql:12 -#: ../../build/sql/vroom/vrp_vroom.sql:14 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:16 -#: ../../build/sql/vroom/vrp_vroom.sql:18 +#: ../../build/doc/vrp_vroom.rst:11 +#: ../../build/doc/vrp_vroom.rst:14 +#: ../../build/doc/vrp_vroom.rst:17 +#: ../../build/doc/vrp_vroom.rst:20 +#: ../../build/doc/vrp_vroom.rst:23 +#: ../../build/doc/vrp_vroom.rst:26 +#: ../../build/doc/vrp_vroom.rst:29 +#: ../../build/doc/vrp_vroom.rst:32 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "`Jobs SQL`_ query describing the single-location pickup and/or delivery tasks." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:8 -msgid "**Jobs Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:12 +msgid "Query describing the single-location pickup and/or delivery" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for job service start." +#: ../../build/doc/vrp_vroom.rst:13 +msgid "`Jobs Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:10 -msgid "**Shipments SQL**" +#: ../../build/doc/vrp_vroom.rst:15 +msgid "Query describing valid slots for job service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:10 -msgid "`Shipments SQL`_ query describing pickup and delivery tasks that should happen within same route." +#: ../../build/doc/vrp_vroom.rst:16 +msgid "`Shipments SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:12 -msgid "**Shipments Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:18 +msgid "Query describing pickup and delivery tasks that should happen within same route." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for pickup and delivery service start." +#: ../../build/doc/vrp_vroom.rst:19 +msgid "`Shipments Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:14 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroom.rst:21 +msgid "Query describing valid slots for pickup and delivery service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:14 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroom.rst:22 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroom.rst:24 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroom.rst:25 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroom.rst:27 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroom.rst:28 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroom.rst:30 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -msgid "`Time Matrix SQL`_ query containing the distance or travel times between the locations." +#: ../../build/doc/vrp_vroom.rst:33 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:86 +#: ../../build/doc/vrp_vroomPlain.rst:82 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 +#: ../../build/doc/vrp_vroomPlain.rst:92 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:31 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroomPlain.rst:94 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/vrp_vroomPlain.rst:95 +#: ../../build/doc/vrp_vroomPlain.rst:102 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:85 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:96 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:97 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:8 +#: ../../build/doc/vrp_vroomPlain.rst:99 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:9 +#: ../../build/doc/vrp_vroomPlain.rst:100 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroomPlain.rst:101 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:103 msgid ":math:`-1`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:104 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:13 +#: ../../build/doc/vrp_vroomPlain.rst:106 msgid "Gives the best possible solution within a time limit. Note that some additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:16 +#: ../../build/doc/vrp_vroomPlain.rst:108 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:93 +#: ../../build/doc/vrp_vroomPlain.rst:113 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:96 +#: ../../build/doc/vrp_vroomPlain.rst:116 msgid "Jobs SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:3 -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:12 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/concepts.rst:5 +msgid "``id, location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``[setup, service, delivery, pickup, skills, priority, data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +#: ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +msgid "``setup`` and ``service``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:78 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:29 msgid "Column" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "**id**" +#: ../../build/doc/concepts.rst:5 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:33 +msgid "``id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:14 +#: ../../build/doc/concepts.rst:34 msgid "Positive unique identifier of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:16 -msgid "Positive identifier of the job location." +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the location of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "**setup**" +#: ../../build/doc/concepts.rst:39 +msgid "``setup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:45 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 +#: ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:18 -msgid "Job setup duration." +#: ../../build/doc/concepts.rst:42 +msgid "The Job setup duration." msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -#: ../../src/common/vroom/breaks_input.c:17 -msgid "**service**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:44 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:20 -msgid "Job service duration." +#: ../../build/doc/concepts.rst:47 +msgid "The Job service duration. Max value:" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -msgid "**delivery**" +#: ../../build/doc/concepts.rst:48 +msgid "``pickup``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:63 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 -#: ../../src/common/vroom/jobs_input.c:29 -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:57 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:80 +msgid "``[]``" +msgstr "" + +#: ../../build/doc/concepts.rst:51 +msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." +msgstr "" + +#: ../../build/doc/concepts.rst:54 +msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +msgstr "" + +#: ../../build/doc/concepts.rst:55 +msgid "``delivery``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:22 +#: ../../build/doc/concepts.rst:58 msgid "Array of non-negative integers describing multidimensional quantities for delivery such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/jobs_input.c:26 +#: ../../build/doc/concepts.rst:61 msgid "All jobs must have the same value of :code:`array_length(delivery, 1)`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "**pickup**" +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:65 +#: ../../build/doc/concepts.rst:81 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/jobs_input.c:29 -msgid "Array of non-negative integers describing multidimensional quantities for pickup such as number of items, weight, volume etc." +#: ../../build/doc/concepts.rst:68 +#: ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:33 -msgid "All jobs must have the same value of :code:`array_length(pickup, 1)`" +#: ../../build/doc/concepts.rst:69 +#: ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:36 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:72 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" +#: ../../build/doc/concepts.rst:73 +msgid "Any metadata information of the job." msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/vrp_vroomPlain.rst:123 +msgid "Jobs Time Windows SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:39 -msgid "Priority level of the job" +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:41 -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +msgid "Positive unique identifier of the: job, pickup/delivery shipment, or break." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "**data**" +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/jobs_input.c:43 -msgid "Any metadata information of the job." +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../src/common/vroom/jobs_input.c:46 -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/jobs_input.c:0 -#: ../../src/common/vroom/shipments_input.c:0 -msgid "ANY-INTEGER" +#: ../../build/doc/vrp_vroomPlain.rst:130 +msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/jobs_input.c:48 -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:103 -msgid "Shipments SQL" +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" +msgstr "" + +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:72 msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 +#: ../../build/doc/concepts.rst:75 msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" +#: ../../build/doc/vrp_vroomPlain.rst:137 +msgid "Shipments Time Windows SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -msgid "**start_id**" +#: ../../build/doc/vrp_vroomPlain.rst:144 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|tw_close_default|" +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:59 +msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "Max value of speed factor for a vehicle shall not be greater than 5 times the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:46 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../build/sql/vroom/vrp_vroom.sql:73 +#: ../../build/doc/concepts.rst:81 +#: ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "If ``end_id`` is omitted, the resulting route will stop at the last visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "If ``start_id`` is omitted, the resulting route will start at the first visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "To request a round trip, specify both ``start_id`` and ``end_id`` as the same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "A vehicle is only allowed to serve a set of tasks if the resulting load at each route step is lower than the matching value in capacity for each metric. When using multiple components for amounts, it is recommended to put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "It is assumed that all delivery-related amounts for jobs are loaded at vehicle start, while all pickup-related amounts for jobs are brought back at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomPlain.rst:151 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -msgid "**vehicle_id**" +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." -msgstr "" - -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**Only required for shipments time windows**. Value in ['p', 'd'] indicating whether the time window is for:" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomPlain.rst:158 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "**Relative values**, e.g. [0, 14400] for a 4 hours time window starting at the beginning of the planning horizon. In that case all times reported in output with the arrival column are relative to the start of the planning horizon." +#: ../../build/doc/vrp_vroomPlain.rst:165 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "**Absolute values**, \"real\" timestamps. In that case all times reported in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" -msgstr "" - -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:114 +#: ../../build/doc/vrp_vroomPlain.rst:171 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" +#: ../../build/doc/concepts.rst:23 +msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" +msgstr "" + +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "The last step of every vehicle denotes the summary row, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "The last row denotes the summary for the complete problem, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:121 +#: ../../build/doc/vrp_vroomPlain.rst:178 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:123 +#: ../../build/doc/vrp_vroomPlain.rst:180 msgid "Problem involving 2 jobs and 1 shipment, using a single vehicle, similar to the VROOM Documentation `Example 2 `__ with a shipment." msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:131 +#: ../../build/doc/vrp_vroomPlain.rst:188 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:133 +#: ../../build/doc/vrp_vroomPlain.rst:190 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:134 +#: ../../build/doc/vrp_vroomPlain.rst:191 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -1110,14 +1177,14 @@ msgstr "" msgid "`VROOM API Documentation `__" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:141 +#: ../../build/doc/vrp_vroomPlain.rst:198 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:142 +#: ../../build/doc/vrp_vroomPlain.rst:199 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomPlain.rst:143 +#: ../../build/doc/vrp_vroomPlain.rst:200 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/vrp_vroomShipments.pot b/locale/pot/vrp_vroomShipments.pot index 9ad4257c4..af1761421 100644 --- a/locale/pot/vrp_vroomShipments.pot +++ b/locale/pot/vrp_vroomShipments.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -121,14 +121,14 @@ msgid "New **experimental** function" msgstr "" #: ../../build/doc/vrp_vroomShipments.rst:39 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroomShipments.rst:82 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/vrp_vroom.rst:10 msgid "Description" msgstr "" @@ -140,858 +140,910 @@ msgstr "" msgid "Signature" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:52 -msgid "Summary" +#: ../../build/doc/vrp_vroomShipments.rst:51 +msgid "\\ \\" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:57 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomShipments.rst:0 +msgid "vrp_vroomShipments(" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:60 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomShipments.rst:0 +msgid "`Shipments SQL`_, `Shipments Time Windows SQL`_," msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:65 +#: ../../build/doc/vrp_vroomShipments.rst:0 +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst:0 +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst:0 +#: ../../build/doc/vrp_vroomShipments.rst:98 +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst:0 +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst:0 +msgid "RETURNS SET OF" +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst:0 +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst:0 +msgid "task_data, arrival, travel_time, service_time, waiting_time, departure, load)" +msgstr "" + +#: ../../build/doc/vrp_vroomShipments.rst:64 msgid "**Example**: This example is based on the modified VROOM Data of the :doc:`sampledata` network. The modification in the tables is mentioned at the end of the :doc:`sampledata`." msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:79 +#: ../../build/doc/vrp_vroomShipments.rst:72 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:4 +#: ../../build/doc/vrp_vroomShipments.rst:80 +#: ../../build/doc/vrp_vroom.rst:7 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroomShipments.rst:81 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/vrp_vroom.rst:8 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -msgid "**Shipments SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:83 +msgid "`Shipments SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 +#: ../../build/doc/vrp_vroomShipments.rst:84 +#: ../../build/doc/vrp_vroomShipments.rst:87 +#: ../../build/doc/vrp_vroomShipments.rst:90 +#: ../../build/doc/vrp_vroomShipments.rst:93 +#: ../../build/doc/vrp_vroomShipments.rst:96 +#: ../../build/doc/vrp_vroomShipments.rst:99 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -msgid "`Shipments SQL`_ query describing pickup and delivery tasks that should happen within same route." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -msgid "**Shipments Time Windows SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:85 +msgid "Query describing pickup and delivery tasks that should happen within same route." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for pickup and delivery service start." +#: ../../build/doc/vrp_vroomShipments.rst:86 +msgid "`Shipments Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:88 +msgid "Query describing valid slots for pickup and delivery service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroomShipments.rst:89 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:91 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroomShipments.rst:92 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:94 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroomShipments.rst:95 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:97 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 -msgid "`Time Matrix SQL`_ query containing the distance or travel times between the locations." +#: ../../build/doc/vrp_vroomShipments.rst:100 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:86 +#: ../../build/doc/vrp_vroomShipments.rst:105 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:4 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/vrp_vroom.rst:9 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroom.rst:11 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:85 +#: ../../build/doc/vrp_vroom.rst:12 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:13 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:6 +#: ../../build/doc/vrp_vroom.rst:14 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:8 +#: ../../build/doc/vrp_vroom.rst:16 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:9 +#: ../../build/doc/vrp_vroom.rst:17 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroom.rst:18 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:19 msgid "``INTERVAL``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:20 msgid "'-00:00:01'::INTERVAL" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroom.rst:21 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/vrp_vroom.rst:23 msgid "Gives the best possible solution within a time limit. Note that some additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:16 +#: ../../build/doc/vrp_vroom.rst:25 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:93 +#: ../../build/doc/vrp_vroomShipments.rst:112 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:96 +#: ../../build/doc/vrp_vroomShipments.rst:115 msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 -msgid "Column" +#: ../../build/doc/concepts.rst:5 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:33 +msgid "``id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" +msgstr "" + +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "**id**" +#: ../../build/doc/concepts.rst:8 +#: ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 +#: ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:78 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:29 +msgid "Column" +msgstr "" + +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 +#: ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" +msgstr "" + +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" +msgstr "" + +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:80 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:72 msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 +#: ../../build/doc/concepts.rst:75 msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:81 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" +#: ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/vrp_vroomShipments.rst:122 +msgid "Shipments Time Windows SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +msgid "Positive unique identifier of the: job, pickup/delivery shipment, or break." msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:0 -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -msgid "**start_id**" +#: ../../build/doc/vrp_vroomShipments.rst:129 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|tw_close_default|" +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:59 +msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "Max value of speed factor for a vehicle shall not be greater than 5 times the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "**data**" +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:46 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../build/sql/vroom/vrp_vroom.sql:73 +#: ../../build/doc/concepts.rst:81 +#: ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "If ``end_id`` is omitted, the resulting route will stop at the last visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "If ``start_id`` is omitted, the resulting route will start at the first visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "To request a round trip, specify both ``start_id`` and ``end_id`` as the same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "A vehicle is only allowed to serve a set of tasks if the resulting load at each route step is lower than the matching value in capacity for each metric. When using multiple components for amounts, it is recommended to put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "It is assumed that all delivery-related amounts for jobs are loaded at vehicle start, while all pickup-related amounts for jobs are brought back at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomShipments.rst:136 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -msgid "**vehicle_id**" -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:17 -msgid "**service**" +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." -msgstr "" - -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**Only required for shipments time windows**. Value in ['p', 'd'] indicating whether the time window is for:" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." +#: ../../build/doc/concepts.rst:25 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomShipments.rst:143 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "**Relative values**, e.g. [0, 14400] for a 4 hours time window starting at the beginning of the planning horizon. In that case all times reported in output with the arrival column are relative to the start of the planning horizon." +#: ../../build/doc/vrp_vroomShipments.rst:150 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "**Absolute values**, \"real\" timestamps. In that case all times reported in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" -msgstr "" - -#: ../../build/doc/vrp_vroomShipments.rst:107 +#: ../../build/doc/vrp_vroomShipments.rst:157 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" +#: ../../build/doc/concepts.rst:23 +msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "The last step of every vehicle denotes the summary row, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "The last row denotes the summary for the complete problem, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:114 +#: ../../build/doc/vrp_vroomShipments.rst:164 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:116 +#: ../../build/doc/vrp_vroomShipments.rst:166 msgid "Problem involving 1 shipment, using a single vehicle, similar to the VROOM Documentation `Example 2 `__ without jobs and with a shipment." msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:125 +#: ../../build/doc/vrp_vroomShipments.rst:175 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:127 +#: ../../build/doc/vrp_vroomShipments.rst:177 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:128 +#: ../../build/doc/vrp_vroomShipments.rst:178 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -1007,14 +1059,14 @@ msgstr "" msgid "`VROOM API Documentation `__" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:135 +#: ../../build/doc/vrp_vroomShipments.rst:185 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:136 +#: ../../build/doc/vrp_vroomShipments.rst:186 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomShipments.rst:137 +#: ../../build/doc/vrp_vroomShipments.rst:187 msgid ":ref:`search`" msgstr "" diff --git a/locale/pot/vrp_vroomShipmentsPlain.pot b/locale/pot/vrp_vroomShipmentsPlain.pot index 006a1a628..00ff9b3d3 100644 --- a/locale/pot/vrp_vroomShipmentsPlain.pot +++ b/locale/pot/vrp_vroomShipmentsPlain.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: vrpRouting v0.3.0-dev\n" +"Project-Id-Version: vrpRouting v0.4.2\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-12-23 17:37+0000\n" +"POT-Creation-Date: 2024-08-04 15:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -100,895 +100,947 @@ msgstr "" msgid "Might depend on a deprecated function of vrpRouting" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:28 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:29 msgid "Availability" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:29 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:30 msgid "Version 0.3.0" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:31 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:32 msgid "Function **modified** for VROOM 1.11.0" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:33 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:34 msgid "Version 0.2.0" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:35 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:36 msgid "New **experimental** function" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:39 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:40 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/vrp_vroomPlain.rst:10 +#: ../../build/doc/vrp_vroomShipments.rst:9 msgid "Description" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:41 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:42 msgid "VROOM is an open-source optimization engine that aims at providing good solutions to various real-life vehicle routing problems (VRP) within a small computing time. This function can be used to get the solution to a problem involving only shipments." msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:49 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:50 msgid "Signature" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:52 -msgid "Summary" +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:53 +msgid "\\ \\" +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:0 +msgid "vrp_vroomShipmentsPlain(" +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:0 +msgid "`Shipments SQL`_, `Shipments Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:0 +msgid "`Vehicles SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:0 +msgid "`Breaks SQL`_, `Breaks Time Windows SQL`_," +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:0 +#: ../../build/doc/vrp_vroomShipments.rst:25 +msgid "`Time Matrix SQL`_" +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:0 +msgid "[, exploration_level] [, timeout]) -- Experimental on v0.2" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:57 -msgid "Optional parameters are `named parameters` and have a default value." +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:0 +msgid "RETURNS SET OF" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:60 -msgid "Using defaults" +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:0 +msgid "(seq, vehicle_seq, vehicle_id, vehicle_data, step_seq, step_type, task_id," msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:65 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:0 +msgid "task_data, arrival, travel_time, service_time, waiting_time, departure, load)" +msgstr "" + +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:67 msgid "**Example**: This example is based on the VROOM Data of the :doc:`sampledata` network:" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:78 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:74 msgid "Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 +#: ../../build/doc/vrp_vroomPlain.rst:7 +#: ../../build/doc/vrp_vroomShipments.rst:7 msgid "Parameter" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:4 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/vrp_vroomPlain.rst:8 +#: ../../build/doc/vrp_vroomShipments.rst:8 msgid "Type" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -msgid "**Shipments SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:10 +msgid "`Shipments SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 +#: ../../build/doc/vrp_vroomShipments.rst:11 +#: ../../build/doc/vrp_vroomShipments.rst:14 +#: ../../build/doc/vrp_vroomShipments.rst:17 +#: ../../build/doc/vrp_vroomShipments.rst:20 +#: ../../build/doc/vrp_vroomShipments.rst:23 +#: ../../build/doc/vrp_vroomShipments.rst:26 msgid "``TEXT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:6 -msgid "`Shipments SQL`_ query describing pickup and delivery tasks that should happen within same route." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -msgid "**Shipments Time Windows SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:12 +msgid "Query describing pickup and delivery tasks that should happen within same route." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:8 -msgid "`Time Windows SQL`_ query describing valid slots for pickup and delivery service start." +#: ../../build/doc/vrp_vroomShipments.rst:13 +msgid "`Shipments Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -msgid "**Vehicles SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:15 +msgid "Query describing valid slots for pickup and delivery service start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:10 -msgid "`Vehicles SQL`_ query describing the available vehicles." +#: ../../build/doc/vrp_vroomShipments.rst:16 +msgid "`Vehicles SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -msgid "**Breaks SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:18 +msgid "Query describing the available vehicles." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:11 -msgid "`Breaks SQL`_ query describing the driver breaks." +#: ../../build/doc/vrp_vroomShipments.rst:19 +msgid "`Breaks SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -msgid "**Breaks Time Windows SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:21 +msgid "Query describing the driver breaks." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:12 -msgid "`Time Windows SQL`_ query describing valid slots for break start." +#: ../../build/doc/vrp_vroomShipments.rst:22 +msgid "`Breaks Time Windows SQL`_" msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 -msgid "**Matrix SQL**" +#: ../../build/doc/vrp_vroomShipments.rst:24 +msgid "Query describing valid slots for break start." msgstr "" -#: ../../build/sql/vroom/vrp_vroomShipments.sql:14 -msgid "`Time Matrix SQL`_ query containing the distance or travel times between the locations." +#: ../../build/doc/vrp_vroomShipments.rst:27 +msgid "Query containing the distance or travel times between the locations." msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:85 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:81 msgid "Optional Parameters" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:4 -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/vrp_vroomPlain.rst:9 msgid "Default" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -msgid "**exploration_level**" +#: ../../build/doc/vrp_vroomPlain.rst:11 +msgid "``exploration_level``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -#: ../../src/common/vroom/shipments_input.c:38 -#: ../../src/common/vroom/vehicles_input.c:39 -#: ../../src/common/vroom/matrix_input.c:18 -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:85 +#: ../../build/doc/vrp_vroomPlain.rst:12 +#: ../../build/doc/vrp_vroomPlain.rst:19 msgid "``INTEGER``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:13 msgid ":math:`5`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:6 +#: ../../build/doc/vrp_vroomPlain.rst:14 msgid "Exploration level to use while solving." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:8 +#: ../../build/doc/vrp_vroomPlain.rst:16 msgid "Ranges from ``[0, 5]``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:9 +#: ../../build/doc/vrp_vroomPlain.rst:17 msgid "A smaller exploration level gives faster result." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 -msgid "**timeout**" +#: ../../build/doc/vrp_vroomPlain.rst:18 +msgid "``timeout``" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:20 msgid ":math:`-1`" msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:11 +#: ../../build/doc/vrp_vroomPlain.rst:21 msgid "Timeout value to stop the solving process." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:13 +#: ../../build/doc/vrp_vroomPlain.rst:23 msgid "Gives the best possible solution within a time limit. Note that some additional seconds may be required to return back the data." msgstr "" -#: ../../build/sql/vroom/vrp_vroomPlain.sql:16 +#: ../../build/doc/vrp_vroomPlain.rst:25 msgid "Any negative timeout value is ignored." msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:92 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:88 msgid "Inner Queries" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:95 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:91 msgid "Shipments SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:3 -#: ../../src/common/vroom/vehicles_input.c:3 -#: ../../src/common/vroom/breaks_input.c:3 -#: ../../src/common/vroom/time_windows_input.c:3 -#: ../../src/common/vroom/matrix_input.c:3 +#: ../../build/doc/concepts.rst:3 msgid "A ``SELECT`` statement that returns the following columns:" msgstr "" -#: ../../src/common/vroom/shipments_input.c:12 -#: ../../src/common/vroom/vehicles_input.c:12 -#: ../../src/common/vroom/breaks_input.c:10 -#: ../../src/common/vroom/time_windows_input.c:10 -#: ../../src/common/vroom/matrix_input.c:10 -#: ../../build/sql/vroom/vrp_vroom.sql:11 -msgid "Column" +#: ../../build/doc/concepts.rst:5 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:33 +msgid "``id``" +msgstr "" + +#: ../../build/doc/concepts.rst:6 +msgid "``p_location_id, [p_setup, p_service, p_data]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "**id**" +#: ../../build/doc/concepts.rst:7 +msgid "``d_location_id, [d_setup, d_service, d_data]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 -#: ../../src/common/vroom/shipments_input.c:16 -#: ../../src/common/vroom/shipments_input.c:22 -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/breaks_input.c:12 -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../src/common/vroom/time_windows_input.c:12 -#: ../../src/common/vroom/matrix_input.c:12 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "``ANY-INTEGER``" +#: ../../build/doc/concepts.rst:8 +msgid "``[amount, skills, priority]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:14 +#: ../../build/doc/concepts.rst:8 +#: ../../build/doc/concepts.rst:10 +msgid "Maximum values apply from vroom" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +msgid "``p_setup``, ``p_service``, ``d_setup``, ``d_service``" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +msgid "|intervalmax|" +msgstr "" + +#: ../../build/doc/concepts.rst:10 +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:78 +msgid "``skills``" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:72 +msgid ":math:`2147483647`" +msgstr "" + +#: ../../build/doc/concepts.rst:14 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:84 +msgid "``priority``" +msgstr "" + +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:22 +msgid ":math:`100`" +msgstr "" + +#: ../../build/doc/concepts.rst:12 +#: ../../build/doc/concepts.rst:13 +#: ../../build/doc/concepts.rst:15 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:29 +msgid "Column" +msgstr "" + +#: ../../build/doc/concepts.rst:16 +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:28 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:34 +#: ../../build/doc/concepts.rst:36 +#: ../../build/doc/concepts.rst:38 +#: ../../build/doc/concepts.rst:54 +msgid "|ANY-INTEGER|" +msgstr "" + +#: ../../build/doc/concepts.rst:36 msgid "Positive unique identifier of the shipment." msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "**p_location_id**" +#: ../../build/doc/concepts.rst:37 +msgid "``p_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:16 -msgid "Positive identifier of the pickup location." +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:56 +msgid "Positive unique identifier of the pickup location." msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "**p_setup**" +#: ../../build/doc/concepts.rst:41 +msgid "``p_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 -#: ../../src/common/vroom/matrix_input.c:16 -#: ../../build/sql/vroom/vrp_vroom.sql:56 -#: ../../build/sql/vroom/vrp_vroom.sql:60 -#: ../../build/sql/vroom/vrp_vroom.sql:62 -#: ../../build/sql/vroom/vrp_vroom.sql:64 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:46 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:62 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:75 +#: ../../build/doc/concepts.rst:78 +#: ../../build/doc/concepts.rst:81 msgid "|interval|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -#: ../../src/common/vroom/shipments_input.c:20 -#: ../../src/common/vroom/shipments_input.c:24 -#: ../../src/common/vroom/shipments_input.c:26 -#: ../../src/common/vroom/breaks_input.c:17 +#: ../../build/doc/concepts.rst:27 +#: ../../build/doc/concepts.rst:43 +#: ../../build/doc/concepts.rst:47 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:63 msgid "|interval0|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:18 -msgid "Pickup setup duration." +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:60 +msgid "The pickup setup duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "**p_service**" +#: ../../build/doc/concepts.rst:45 +msgid "``p_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:20 -msgid "Pickup service duration." +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:64 +msgid "The pickup service duration" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "**d_location_id**" +#: ../../build/doc/concepts.rst:49 +msgid "``p_data``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:22 -msgid "Positive identifier of the delivery location." +#: ../../build/doc/concepts.rst:30 +#: ../../build/doc/concepts.rst:32 +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:64 +#: ../../build/doc/concepts.rst:66 +#: ../../build/doc/concepts.rst:77 +msgid "``JSONB``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "**d_setup**" +#: ../../build/doc/concepts.rst:31 +#: ../../build/doc/concepts.rst:51 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:78 +msgid "``'{}'::JSONB``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:24 -msgid "Delivery setup duration." +#: ../../build/doc/concepts.rst:52 +msgid "Any metadata information of the pickup." msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "**d_service**" +#: ../../build/doc/concepts.rst:53 +msgid "``d_location_id``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:26 -msgid "Delivery service duration." +#: ../../build/doc/concepts.rst:57 +msgid "``d_setup``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -msgid "**amount**" +#: ../../build/doc/concepts.rst:61 +msgid "``d_service``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:65 +msgid "``d_data``" +msgstr "" + +#: ../../build/doc/concepts.rst:68 +msgid "Any metadata information of the delivery." +msgstr "" + +#: ../../build/doc/concepts.rst:69 +msgid "``amount``" +msgstr "" + +#: ../../build/doc/concepts.rst:40 +#: ../../build/doc/concepts.rst:48 +#: ../../build/doc/concepts.rst:70 +#: ../../build/doc/concepts.rst:79 msgid "``ARRAY[ANY-INTEGER]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:20 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Empty Array" +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:49 +#: ../../build/doc/concepts.rst:71 +#: ../../build/doc/concepts.rst:80 +msgid "``[]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:28 -#: ../../src/common/vroom/vehicles_input.c:20 +#: ../../build/doc/concepts.rst:42 +#: ../../build/doc/concepts.rst:72 msgid "Array of non-negative integers describing multidimensional quantities such as number of items, weight, volume etc." msgstr "" -#: ../../src/common/vroom/shipments_input.c:32 +#: ../../build/doc/concepts.rst:75 msgid "All shipments must have the same value of :code:`array_length(amount, 1)`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "**skills**" +#: ../../build/doc/concepts.rst:50 +#: ../../build/doc/concepts.rst:81 +msgid "Array of non-negative integers defining mandatory skills." msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "``ARRAY[INTEGER]``" +#: ../../build/doc/concepts.rst:83 +msgid ":math:`values \\leq 2147483647`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:35 -#: ../../src/common/vroom/vehicles_input.c:27 -msgid "Array of non-negative integers defining mandatory skills." +#: ../../build/doc/concepts.rst:86 +msgid ":math:`0`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "**priority**" +#: ../../build/doc/concepts.rst:87 +msgid "Value range: :math:`[0, 100]`" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "0" +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:98 +msgid "Shipments Time Windows SQL" msgstr "" -#: ../../src/common/vroom/shipments_input.c:38 -msgid "Priority level of the shipment." +#: ../../build/doc/concepts.rst:5 +msgid "``id, tw_open, tw_close``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:40 -msgid "Ranges from ``[0, 100]``" +#: ../../build/doc/concepts.rst:6 +msgid "``[kind]``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "**p_data**" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:18 +msgid "Positive unique identifier of the: job, pickup/delivery shipment, or break." msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -#: ../../build/sql/vroom/vrp_vroom.sql:25 -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "``JSONB``" +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:51 +msgid "``tw_open``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -#: ../../src/common/vroom/shipments_input.c:44 -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "'{}'::JSONB" +#: ../../build/doc/concepts.rst:20 +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:52 +#: ../../build/doc/concepts.rst:58 +#: ../../build/doc/concepts.rst:67 +#: ../../build/doc/concepts.rst:84 +msgid "|timestamp|" msgstr "" -#: ../../src/common/vroom/shipments_input.c:42 -msgid "Any metadata information of the pickup shipment." +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:54 +msgid "Time window opening time." msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "**d_data**" +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:23 +#: ../../build/doc/concepts.rst:57 +msgid "``tw_close``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:44 -msgid "Any metadata information of the delivery shipment." +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:60 +msgid "Time window closing time." msgstr "" -#: ../../src/common/vroom/shipments_input.c:47 -msgid "Where:" +#: ../../build/doc/concepts.rst:26 +msgid "``kind``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:0 -msgid "ANY-INTEGER" +#: ../../build/doc/concepts.rst:27 +msgid "``CHAR``" msgstr "" -#: ../../src/common/vroom/shipments_input.c:49 -msgid "SMALLINT, INTEGER, BIGINT" +#: ../../build/doc/concepts.rst:28 +msgid "Value in ['p', 'd'] indicating whether the time window is for:" msgstr "" -#: ../../build/doc/vroom-category.rst:4 -msgid "Vehicles SQL" +#: ../../build/doc/concepts.rst:30 +msgid "Pickup shipment, or" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:14 -#: ../../src/common/vroom/breaks_input.c:15 -msgid "Positive unique identifier of the vehicle." +#: ../../build/doc/concepts.rst:31 +msgid "Delivery shipment." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -#: ../../src/common/vroom/matrix_input.c:12 -msgid "**start_id**" +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:105 +msgid "Vehicles SQL" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:16 -msgid "Positive identifier of the vehicle start location." +#: ../../build/doc/concepts.rst:5 +msgid "``id, start_id, end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -#: ../../src/common/vroom/matrix_input.c:14 -msgid "**end_id**" +#: ../../build/doc/concepts.rst:6 +msgid "``[capacity, skills, tw_open, tw_close, speed_factor, max_tasks, data]``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:18 -msgid "Positive identifier of the vehicle end location." +#: ../../build/doc/concepts.rst:24 +#: ../../build/doc/concepts.rst:30 +msgid "Positive unique identifier of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:20 -msgid "**capacity**" +#: ../../build/doc/concepts.rst:17 +#: ../../build/doc/concepts.rst:31 +msgid "``start_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:24 -msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" +#: ../../build/doc/concepts.rst:34 +msgid "Positive unique identifier of the start location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "**tw_open**" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:35 +msgid "``end_id``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:22 -#: ../../src/common/vroom/time_windows_input.c:24 -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "|timestamp|" +#: ../../build/doc/concepts.rst:38 +msgid "Positive unique identifier of the end location." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -msgid "|tw_open_default|" +#: ../../build/doc/concepts.rst:39 +msgid "``capacity``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:30 -#: ../../src/common/vroom/time_windows_input.c:22 -msgid "Time window opening time." +#: ../../build/doc/concepts.rst:45 +msgid "All vehicles must have the same value of :code:`array_length(capacity, 1)`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "**tw_close**" +#: ../../build/doc/concepts.rst:53 +msgid "|tw_open_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -msgid "|tw_close_default|" +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 +msgid ":code:`tw_open \\leq tw_close`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:32 -#: ../../src/common/vroom/time_windows_input.c:24 -msgid "Time window closing time." +#: ../../build/doc/concepts.rst:59 +msgid "|tw_close_default|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "**speed_factor**" +#: ../../build/doc/concepts.rst:63 +msgid "``speed_factor``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 -msgid "``ANY-NUMERICAL``" +#: ../../build/doc/concepts.rst:64 +msgid "|ANY-NUMERICAL|" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:65 msgid ":math:`1.0`" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:34 +#: ../../build/doc/concepts.rst:66 msgid "Vehicle travel time multiplier." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:36 +#: ../../build/doc/concepts.rst:68 msgid "Max value of speed factor for a vehicle shall not be greater than 5 times the speed factor of any other vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid "**max_tasks**" +#: ../../build/doc/concepts.rst:70 +msgid "``max_tasks``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:39 -msgid ":math:`2147483647`" -msgstr "" - -#: ../../src/common/vroom/vehicles_input.c:39 +#: ../../build/doc/concepts.rst:73 msgid "Maximum number of tasks in a route for the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:41 +#: ../../build/doc/concepts.rst:75 msgid "A job, pickup, or delivery is counted as a single task." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 -#: ../../src/common/vroom/breaks_input.c:19 -msgid "**data**" +#: ../../build/doc/concepts.rst:29 +#: ../../build/doc/concepts.rst:76 +msgid "``data``" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:43 +#: ../../build/doc/concepts.rst:79 msgid "Any metadata information of the vehicle." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:46 -#: ../../src/common/vroom/time_windows_input.c:27 -#: ../../build/sql/vroom/vrp_vroom.sql:73 +#: ../../build/doc/concepts.rst:81 +#: ../../build/doc/concepts.rst:92 msgid "**Note**:" msgstr "" -#: ../../src/common/vroom/vehicles_input.c:48 +#: ../../build/doc/concepts.rst:83 msgid "At least one of the ``start_id`` or ``end_id`` shall be present." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:49 +#: ../../build/doc/concepts.rst:84 msgid "If ``end_id`` is omitted, the resulting route will stop at the last visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:50 +#: ../../build/doc/concepts.rst:86 msgid "If ``start_id`` is omitted, the resulting route will start at the first visited task, whose choice is determined by the optimization process." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:51 +#: ../../build/doc/concepts.rst:88 msgid "To request a round trip, specify both ``start_id`` and ``end_id`` as the same index." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:52 +#: ../../build/doc/concepts.rst:90 msgid "A vehicle is only allowed to serve a set of tasks if the resulting load at each route step is lower than the matching value in capacity for each metric. When using multiple components for amounts, it is recommended to put the most important/limiting metrics first." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:53 +#: ../../build/doc/concepts.rst:94 msgid "It is assumed that all delivery-related amounts for jobs are loaded at vehicle start, while all pickup-related amounts for jobs are brought back at vehicle end." msgstr "" -#: ../../src/common/vroom/vehicles_input.c:54 -msgid ":code:`tw_open ≤ tw_close`" -msgstr "" - -#: ../../build/doc/vroom-category.rst:11 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:112 msgid "Breaks SQL" msgstr "" -#: ../../src/common/vroom/breaks_input.c:12 -msgid "Positive unique identifier of the break. (unique for the same vehicle)." -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -msgid "**vehicle_id**" -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:17 -msgid "**service**" -msgstr "" - -#: ../../src/common/vroom/breaks_input.c:17 -msgid "The break duration." +#: ../../build/doc/concepts.rst:5 +msgid "``id, vehicle_id``" msgstr "" -#: ../../src/common/vroom/breaks_input.c:19 -msgid "Any metadata information of the break." -msgstr "" - -#: ../../build/doc/vroom-category.rst:18 -msgid "Time Windows SQL" -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:12 -msgid "Positive unique identifier of the job, pickup/delivery shipment, or break." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**kind**" +#: ../../build/doc/concepts.rst:6 +msgid "``[service, data]``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "``CHAR``" +#: ../../build/doc/concepts.rst:20 +msgid "Positive unique identifier of the break. Unique for the same vehicle." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:15 -msgid "**Only required for shipments time windows**. Value in ['p', 'd'] indicating whether the time window is for:" +#: ../../build/doc/concepts.rst:21 +#: ../../build/doc/concepts.rst:25 +msgid "``vehicle_id``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:19 -msgid "Pickup shipment, or" +#: ../../build/doc/concepts.rst:25 +msgid "``service``" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:20 -msgid "Delivery shipment." +#: ../../build/doc/concepts.rst:28 +msgid "The break duration" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:29 -msgid "All timings are in **seconds** when represented as an ``INTEGER``." -msgstr "" - -#: ../../src/common/vroom/time_windows_input.c:30 -msgid "Every row must satisfy the condition: :code:`tw_open ≤ tw_close`." +#: ../../build/doc/concepts.rst:32 +msgid "Any metadata information of the break." msgstr "" -#: ../../src/common/vroom/time_windows_input.c:31 -msgid "It is up to users to decide how to describe time windows:" +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:119 +msgid "Breaks Time Windows SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:33 -msgid "**Relative values**, e.g. [0, 14400] for a 4 hours time window starting at the beginning of the planning horizon. In that case all times reported in output with the arrival column are relative to the start of the planning horizon." +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:126 +msgid "Time Matrix SQL" msgstr "" -#: ../../src/common/vroom/time_windows_input.c:34 -msgid "**Absolute values**, \"real\" timestamps. In that case all times reported in output with the arrival column can be interpreted as timestamps." +#: ../../build/doc/concepts.rst:5 +msgid "``start_id, end_id, duration``" msgstr "" -#: ../../build/doc/vroom-category.rst:25 -msgid "Time Matrix SQL" +#: ../../build/doc/concepts.rst:6 +msgid "``[ cost]``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:12 +#: ../../build/doc/concepts.rst:20 msgid "Identifier of the start node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:14 +#: ../../build/doc/concepts.rst:24 msgid "Identifier of the end node." msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 -msgid "**duration**" +#: ../../build/doc/concepts.rst:25 +#: ../../build/doc/concepts.rst:31 +msgid "``duration``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:16 +#: ../../build/doc/concepts.rst:28 msgid "Time to travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "**cost**" -msgstr "" - -#: ../../src/common/vroom/matrix_input.c:18 -msgid "*duration*" +#: ../../build/doc/concepts.rst:29 +msgid "``cost``" msgstr "" -#: ../../src/common/vroom/matrix_input.c:18 -msgid "Cost to travel from ``start_id`` to ``end_id``" +#: ../../build/doc/concepts.rst:32 +msgid "Cost of travel from ``start_id`` to ``end_id``" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:106 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:133 msgid "Result Columns" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:3 +#: ../../build/doc/concepts.rst:3 msgid "Returns set of" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -msgid "**seq**" +#: ../../build/doc/concepts.rst:18 +msgid "``seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 -#: ../../build/sql/vroom/vrp_vroom.sql:15 -#: ../../build/sql/vroom/vrp_vroom.sql:20 -#: ../../build/sql/vroom/vrp_vroom.sql:27 -#: ../../build/sql/vroom/vrp_vroom.sql:43 -#: ../../build/sql/vroom/vrp_vroom.sql:48 -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:19 +#: ../../build/doc/concepts.rst:22 +#: ../../build/doc/concepts.rst:26 +#: ../../build/doc/concepts.rst:35 +#: ../../build/doc/concepts.rst:41 +#: ../../build/doc/concepts.rst:53 +#: ../../build/doc/concepts.rst:59 +#: ../../build/doc/concepts.rst:89 msgid "``BIGINT``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:13 +#: ../../build/doc/concepts.rst:20 msgid "Sequential value starting from **1**." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "**vehicle_seq**" +#: ../../build/doc/concepts.rst:21 +msgid "``vehicle_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:15 -msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." -msgstr "" - -#: ../../build/sql/vroom/vrp_vroom.sql:18 -#: ../../build/sql/vroom/vrp_vroom.sql:23 -msgid "``0``: Summary row for the complete problem" +#: ../../build/doc/concepts.rst:23 +msgid "Sequential value starting from **1** for current vehicles. The :math:`n^{th}` vehicle in the solution." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:20 +#: ../../build/doc/concepts.rst:27 msgid "Current vehicle identifier." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:22 +#: ../../build/doc/concepts.rst:29 msgid "``-1``: Vehicle denoting all the unallocated tasks." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "**vehicle_data**" +#: ../../build/doc/concepts.rst:30 +msgid "``0``: Summary row for the complete problem" +msgstr "" + +#: ../../build/doc/concepts.rst:31 +msgid "``vehicle_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:25 -msgid "Metadata information of the vehicle" +#: ../../build/doc/concepts.rst:33 +msgid "Metadata information of the vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 -msgid "**step_seq**" +#: ../../build/doc/concepts.rst:34 +msgid "``step_seq``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:27 +#: ../../build/doc/concepts.rst:36 msgid "Sequential value starting from **1** for the stops made by the current vehicle. The :math:`m^{th}` stop of the current vehicle." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:31 -#: ../../build/sql/vroom/vrp_vroom.sql:35 -#: ../../build/sql/vroom/vrp_vroom.sql:45 -#: ../../build/sql/vroom/vrp_vroom.sql:50 +#: ../../build/doc/concepts.rst:39 +#: ../../build/doc/concepts.rst:44 +#: ../../build/doc/concepts.rst:56 +#: ../../build/doc/concepts.rst:62 msgid "``0``: Summary row" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 -msgid "**step_type**" +#: ../../build/doc/concepts.rst:40 +msgid "``step_type``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:33 +#: ../../build/doc/concepts.rst:42 msgid "Kind of the step location the vehicle is at:" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:36 +#: ../../build/doc/concepts.rst:45 msgid "``1``: Starting location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:37 +#: ../../build/doc/concepts.rst:46 msgid "``2``: Job location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:38 +#: ../../build/doc/concepts.rst:47 msgid "``3``: Pickup location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:39 +#: ../../build/doc/concepts.rst:48 msgid "``4``: Delivery location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:40 +#: ../../build/doc/concepts.rst:49 msgid "``5``: Break location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:41 +#: ../../build/doc/concepts.rst:50 msgid "``6``: Ending location" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 -msgid "**task_id**" +#: ../../build/doc/concepts.rst:52 +msgid "``task_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:43 +#: ../../build/doc/concepts.rst:54 msgid "Identifier of the task performed at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:46 +#: ../../build/doc/concepts.rst:57 msgid "``-1``: If the step is starting/ending location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 -msgid "**location_id**" +#: ../../build/doc/concepts.rst:58 +msgid "``location_id``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:48 +#: ../../build/doc/concepts.rst:60 msgid "Identifier of the task location." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "**task_data**" +#: ../../build/doc/concepts.rst:63 +msgid "``task_data``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:52 -msgid "Metadata information of the task" +#: ../../build/doc/concepts.rst:65 +msgid "Metadata information of the task." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -msgid "**arrival**" +#: ../../build/doc/concepts.rst:66 +msgid "``arrival``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:54 -#: ../../build/sql/vroom/vrp_vroom.sql:66 +#: ../../build/doc/concepts.rst:68 msgid "Estimated time of arrival at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 -msgid "**travel_time**" +#: ../../build/doc/concepts.rst:69 +msgid "``travel_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:56 +#: ../../build/doc/concepts.rst:71 msgid "Travel time from previous ``step_seq`` to current ``step_seq``." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:58 +#: ../../build/doc/concepts.rst:73 msgid "``0``: When ``step_type = 1``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 -msgid "**setup_time**" +#: ../../build/doc/concepts.rst:74 +msgid "``setup_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:60 +#: ../../build/doc/concepts.rst:76 msgid "Setup time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 -msgid "**service_time**" +#: ../../build/doc/concepts.rst:77 +msgid "``service_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:62 +#: ../../build/doc/concepts.rst:79 msgid "Service time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "**waiting_time**" +#: ../../build/doc/concepts.rst:80 +msgid "``waiting_time``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:64 -msgid "Waiting time upon arrival at this step." +#: ../../build/doc/concepts.rst:82 +msgid "Waiting time at this step." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:66 -msgid "**departure**" +#: ../../build/doc/concepts.rst:83 +msgid "``departure``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:68 +#: ../../build/doc/concepts.rst:85 +msgid "Estimated time of departure at this step." +msgstr "" + +#: ../../build/doc/concepts.rst:87 msgid ":math:`arrival + service\\_time + waiting\\_time`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 -msgid "**load**" +#: ../../build/doc/concepts.rst:88 +msgid "``load``" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:70 +#: ../../build/doc/concepts.rst:90 msgid "Vehicle load after step completion (with capacity constraints)" msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:75 +#: ../../build/doc/concepts.rst:94 msgid "Unallocated tasks are mentioned at the end with :code:`vehicle_id = -1`." msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:76 +#: ../../build/doc/concepts.rst:95 msgid "The last step of every vehicle denotes the summary row, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the corresponding vehicle," msgstr "" -#: ../../build/sql/vroom/vrp_vroom.sql:77 +#: ../../build/doc/concepts.rst:98 msgid "The last row denotes the summary for the complete problem, where the columns ``travel_time``, ``service_time`` and ``waiting_time`` denote the total time for the complete problem," msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:113 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:140 msgid "Additional Example" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:115 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:142 msgid "Problem involving 1 shipment, using a single vehicle, similar to the VROOM Documentation `Example 2 `__ without jobs and with a shipment." msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:124 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:151 msgid "See Also" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:126 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:153 msgid ":doc:`vroom-category`" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:127 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:154 msgid "The queries use the :doc:`sampledata` network." msgstr "" @@ -1004,14 +1056,14 @@ msgstr "" msgid "`VROOM API Documentation `__" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:134 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:161 msgid "Indices and tables" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:135 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:162 msgid ":ref:`genindex`" msgstr "" -#: ../../build/doc/vrp_vroomShipmentsPlain.rst:136 +#: ../../build/doc/vrp_vroomShipmentsPlain.rst:163 msgid ":ref:`search`" msgstr "" From c9f666931f02bb5bfaaa12979ba0c4aa2108f747 Mon Sep 17 00:00:00 2001 From: cvvergara Date: Sun, 4 Aug 2024 09:57:55 -0600 Subject: [PATCH 24/24] (docq/general) Adjusting timestamp to CI test --- docqueries/general/concepts.result | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docqueries/general/concepts.result b/docqueries/general/concepts.result index 66a8824cc..26df9d8f2 100644 --- a/docqueries/general/concepts.result +++ b/docqueries/general/concepts.result @@ -7,7 +7,7 @@ SELECT to_timestamp(0)::timestamp without time zone as ZERO_TIMESTAMP, to_timestamp(4294967295)::timestamp without time zone AS MAX_TIMESTAMP; zero_timestamp | max_timestamp ---------------------+--------------------- - 1969-12-31 18:00:00 | 2106-02-07 00:28:15 + 1970-01-01 00:00:00 | 2106-02-07 06:28:15 (1 row) /* q2 */