Added documentation on how to create jobs from job IDs.

Signed-off-by: Daniel Scheffler <danschef@gfz-potsdam.de>

HISTORY.rst

@@ -9,6 +9,7 @@ History
 * Added URL checker and corresponding CI job.
 * Removed travis related files.
 * Fixed dead URLs.
+* Added documentation on how to create jobs from job IDs.
 
 
 0.19.3 (2020-12-03)

docs/usage/create_new_jobs.rst

@@ -30,7 +30,8 @@ There are multiple ways to create new jobs depending on what you have. The secti
 Create a job from a list of filenames
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The list of filenames refers to the filenames of the previously downloaded provider archive data.
+The list of filenames refers to the filenames of the previously downloaded provider archive data
+(see :meth:`gms_preprocessing.misc.database_tools.GMS_JOB.from_filenames` for details).
 
 .. code-block:: python
 
@@ -60,16 +61,38 @@ The list of filenames refers to the filenames of the previously downloaded provi
 Create a job from a list of entity IDs
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-- TODO
+- TODO (see :meth:`gms_preprocessing.misc.database_tools.GMS_JOB.from_entityIDlist` for details)
 
 
 Create a job from a list of scene IDs
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-- TODO
+If you have a list of GeoMultiSens scene IDs, you can also create a new processing job for them
+(see :meth:`gms_preprocessing.misc.database_tools.GMS_JOB.from_sceneIDlist` for details):
+
+.. code-block:: python
+
+    from gms_preprocessing.options.config import get_conn_database
+    from gms_preprocessing.misc.database_tools import GMS_JOB
+
+    job = GMS_JOB(conn_db=get_conn_database('localhost'))
+    job.from_sceneIDlist(list_sceneIDs=[9390928,],
+                         virtual_sensor_id=1
+                         comment='Example job for only one scene with the ID 9390928.')
+
+    # write the job into the GeoMultiSens metadata database
+    job.create()
+
+
+.. code-block:: bash
+
+    OUT:
+    New job created successfully. job-ID: 26193458
+    The job contains:
+        - 1 Landsat-5 TM scene
 
 
 Create a job from a dictionary
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-- TODO
+- TODO (see :meth:`gms_preprocessing.misc.database_tools.GMS_JOB.from_dictlist` for details)

gms_preprocessing/version.py

@@ -24,5 +24,5 @@
 # You should have received a copy of the GNU Lesser General Public License along
 # with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-__version__ = '0.19.3'
-__versionalias__ = '20201203.01'
+__version__ = '0.19.4'
+__versionalias__ = '20201210.01'