From 19be188c760ad2b225a93967eb6298d04a855b16 Mon Sep 17 00:00:00 2001 From: Piero Toffanin Date: Wed, 1 Mar 2017 17:06:55 -0500 Subject: [PATCH] Docs additions, changed site title --- app/api/processingnodes.py | 6 +- app/templates/app/base.html | 2 +- slate/source/images/logo.png | Bin 2278 -> 4286 bytes slate/source/includes/_introduction.md | 2 + slate/source/includes/_quickstart.md | 9 +- .../source/includes/reference/_permissions.md | 36 ++++++ .../includes/reference/_processingnode.md | 119 ++++++++++++++++++ slate/source/includes/reference/_task.md | 75 ++++++++--- slate/source/includes/reference/temp.md | 1 - slate/source/index.html.md | 3 + 10 files changed, 224 insertions(+), 29 deletions(-) create mode 100644 slate/source/includes/reference/_permissions.md create mode 100644 slate/source/includes/reference/_processingnode.md delete mode 100644 slate/source/includes/reference/temp.md diff --git a/app/api/processingnodes.py b/app/api/processingnodes.py index a8b1d469..ed4fe6d7 100644 --- a/app/api/processingnodes.py +++ b/app/api/processingnodes.py @@ -44,10 +44,7 @@ class ProcessingNodeViewSet(viewsets.ModelViewSet): class ProcessingNodeOptionsView(APIView): """ - Display the intersection of all ProcessingNode's available_options fields. - Each ProcessingNode has its own set of available_options. When a user relies on the - automatic node selection feature, it's better to have a list of available_options that - is common among all ProcessingNode. + Display the common options available among all online processing nodes. This is calculated by intersecting the available_options field of all online processing nodes visible to the current user. """ queryset = ProcessingNode.objects.all() @@ -55,7 +52,6 @@ class ProcessingNodeOptionsView(APIView): def get(self, request): nodes = get_objects_for_user(request.user, 'view_processingnode', ProcessingNode, accept_global_perms=False) - common_options = [] for node in nodes: diff --git a/app/templates/app/base.html b/app/templates/app/base.html index a3a8b698..ccbf1d1e 100644 --- a/app/templates/app/base.html +++ b/app/templates/app/base.html @@ -63,7 +63,7 @@ {% block navbar-top-links %}{% endblock %} WebODM -

OpenDroneMap

+

WebODM

{% block navbar-sidebar %}{% endblock %} diff --git a/slate/source/images/logo.png b/slate/source/images/logo.png index 559c4d0dd4a8ee7eddd97ea445cda583e263a43f..826f0bbf9586f985ef914b12c56d59607bb884d0 100644 GIT binary patch delta 4284 zcmV;t5JT_g5xyZIiBL{Q4GJ0x0000DNk~Le0002U0000$2m}BC0QIu)pphXgf8hfG z6+0pw@33_M01!_}L_t(|+U=ZqbW}yY$3NBG*%PuM5J6A@ZxRv+67dlhGqOHe+y>Oq zBg}J#WnfUi8F}DCKm`G1z)=J}BO}f@3OX=`$fgLGfcPSiK$2TTMYgaeF&kOC>;2I; zNq5rebigy`ymRjNk3OgC*01ipfAy{U{eJcPRb4P)!h{JECQO(x@$*CYT2Wf@Cz1$) zu~0)fMO10EKFIkKL^NT9V5fo-N~qQBX2;(UAyRNNqj;PFL>NVO3fRUL^0g{2azVuL z8258KR->qdEZ%1?g_<%u|2hegk)*Pa0Uj?t&sKEJ;gQ5R9^@sDQdulxf1g%jcK>w{ zB5&qto+bc*B8sWPP5@za!4H6gtmMyXi!A6Jc%++=@lN-Zo;sD4blMF6Wi;bH#dRt*g z8$;;@z%i2qUkN!+1`x@^bobJ+;Eeue>J=gz!0945gzHVFo-1peAy6O(HtCSKLAU(TY79?M(~sod|cDIQP)3^ zN-F*H#csAp|Fdq_&*Zrck-R7LN~!ekf1WNm7OwwZ->sjOHL_gK)?Yo=+x>b@gb}Gz zQc0!T^-KCU`7h<%;i;DH(5JWZcIi?{rSEG8A)137f2;%iSitkLyZd;TLIyK|O~e2- z9OiPP+&TWrIpAjAV}cBJH}29VyR(S@#tN)skC)ZTb^tMaV&A5stY~Hki?~HhaeIkb zA{a#4&p}82Z-agiuZxkQ8~%ifzG7aW%>Vnokk;x8i|8covMlt^%U^#eu*Fru5>K+Z zqs4vgf1e>}6|7|+U}GL{^0Pc_%dJG>?BiLe}6cv1tp!j%=X|3Ep2@b;T76RIiJOh z0mdm&rU!*U*yCx|A} z$Pl{XbGC9TbFk5$b@CZ)ubjp*qJUh|xQpRHFN3-!6!8IXYi+MU(ijE|$qGuY0>}BPtEEmU z2Z%XY(M@HKJSh4DnXT9)-$suVgwc~Y`qBX_HJl;`or}(tuI$KievK8V!w)Fr_iWV^ zNGn~?=*R5@;GmS_9oDq2SlwTcD@?0Qv}FY`*P8D`O?!8I8W&PB6|{mdhzheciWs;y~Y05e`8k+2phuYAakh z5K}}nBQipBt5vFKe_XS`W)+yEi66L)hjzr%e)!WV3nUvUB}PqK^% z;5=E3#YO_J%b8>mOA7Zh#@$l0f!*?J?XoX-o>V7yGZ8GKe-^*b1mJYsQAoAx>EcNd z7&&I>CD8%YskmHc{X1?Y1c>fum#)1T(cq^w>*X^5>K1_HGQC;^g6P_^-e!w48!Eg$ zbMGi2036NqLvoS6l9xq*ZQ;IIVi8bpUwlJemP}+RAMy;%_lFGU4c=lhlUYs_aGrTg z;awa+603Ngf46w68699_CLi&lO!QG{r2(iB6O%~5JNms z1TvM|0&Tgp2%8~+$?ErxUvOFUKg_B0RXi>wZ)c@e%JIRV!a5o{0UTz{Y7uBv_XjM%_~M2 zFpVu_e^G=T5CqeU(fknzCmhh3@62pySLISFnA*5ceib_@pb7=ph$5MZj0Z;IFQ;lJ z+v>FBB6*0xpdJ&bs~0mGUQzC00x?7a<)`*H)J`gt7wJNLc5uIIKKLem061=hYSu^2 z7aa%<-JCTp*~Kx>e?~kE;8^Lct(>mnNdR8;e{^;KUsC6ChX??*q0iatCPaoZmwSLZ z*6`;h6AmEHa)^VxN-v;}_u1KCsI^P-sIlYZJDz2?+ku5kvVbqiXAXYc!yNesZ_%s< zPs=hGL=dR7)JCUSZ4(nf1OmJ6b5Tf+&6e3Bz<)NcGzRiII~~qONkjE+u!%mbFY<+q4uEGnEArS+_Oy|hw;DNuk{)`!+{vQ$sYHRFnPuHi_=PtBu0d>u> z?7GA6(#m+I1GT)&%i3A3-hE}FRguPI3IRU`(CF;R?o6a3aDmCBH9tS1)obTi#>>EU2(h)PuqsU%{%04Y}sSbA*&`%^XOx3wj8@zpVBc~3<18an9|xy z^!Zq=QAZrp+y_VdjJiM0RL%i5X{D_M=)b|~Q4b^0nfs6y5*P-+|L~3H;JQ}If8UJI z!A#oRN*b4|PC3m*la) z{%6Hw!0GzQZefx+YC0{?t$bWOD5=HKiGbr$N!8CDbY5%}w=0MGOZBj1FENPNIk5v8 zq5{`PNH1+l%f0Af;D>f472z*4k*1F$*nk|$7DRlF}vEL4$b`Eme zT4Wgb!~L4MnQ;dy`>54ORjsNh;9Zr{5VioI+@7LVs58{5vyRtG?`*EoV>cA{bj(#> zP)IE$9A|C)KyBinRu2~`hq}tQYK1)^_BX!Rts8*+l~hv6!!q7$Et{Mnf9s@@dt^5N z*;Ve8O4i94(z|_%lV3|Em3$NvKF*MFKn;gD?X?9v`FsZqH>^k}MgRrmX>DyK&7=kx zZ<63EA@M*Rr@d~qMpG113J3zEkb)qrKpAbEAk?ZjL!EIK6Fw2*2PoP;`dn{hN?f;+ z+Nt+JP66im5T6Mt1T2KLf7wQmaU@h3Q~(4J)TUe*7UM1^d?Ms)Adn;(r$1Ndy{qG2s&-djTs+^zhn(A4%K-q;mm)3#0?LkkrOD?H(jy z1->vz@Rg90lmp$lPlkG_)r-;2&;maJP{ua^jBc^D!96H*AKig+e+o?7}>$?kgc$Eh{Ml`ml`t9*;$b zFbijTbPxH?;G(9;<8uI>Wrhs#Xm$Ftj6Ogq%Qf?Sh#S10;jr-=-oOfEvYaf6nihL9 zgxi>6(6NuFwHz0@e}1en5Z=XMkZC9cB>0=(wRbAm}I>0=Q6W;(|-X zB~_M*OJdxWh#H9+qZP$18Zed>V=6{XSxMBGhz1oGl*J_|BI^}55CO#j8NhLd>FNC7 zW1Jqldmxp6;r{3!-`D4!_kQ=>e{sf6m$iwP!%?kdMaG87 zo$QWwr-5LG8KzsQMMe*UjWWz0X!SccgwIL>h~>^RQ5w_SVwQ%l!Y5YR)#X0J<6 zxYK>%ivm_{=D5auR2dh$6$M}iqtWCsZxlW>ghuz9fx!+)j#|c0e}nO=KYsP;J6Ywt z;W14()(*u1?5zq*O%5AM?9=FU`WuZU=4dTx_o26BNw%vXfD!o8oUpRgJfY1ppQ5*3F%?sKsX>F4g`%c|-AZ$O zN%Fl40_cY}>$*($e_v|uaEMdMvoE`}Tc<7YQUpK?Qc1omHOi9k%XRq8v}ga~qq`Id z_<{iDq1-O9qGYv8sj)qpG=*HqB@ii~1{r{ttOB2S z4g(D8;v4L0xbAqOIDj{j!+3ZswGDlYQiiEE<@HsjAY)Yie+loj{xXLc0NyGN;A7L# z+sW!mOmw_cvC7*vW%X8bt->ir$Fiab>U>`fUbd__fM$1rgPjqp3%XAm?gsGU=42h( z%=Hqu!LULVgjnszNwJzxA_zm9$?ie9t6dxG^4Aknv8NL}s6U#$=F@h&W&UItcJhD| zV$b|wjAgOTe|3H?gL_QL&lX?j1ADvIDDb35{ab^qoU{siImYGff1K&cFtfenp5~_Z zZM(zM-qEBDWomuPDMlwn{3l^?*NkYG>m8l&xdm4ELYr=C?U@A82CcToY?p@V5P#&B zya0UHdm6MzskD&SU z3R*RI*zd!;&olf>-kDBg1eO%{!X)H3?8EUb_rKYGe(kYI~v&x$2UuK8Z zTcrzPN|ikgw6E=CH2c8Y7FoH8qQyRLcD4*QD#vn{cs%5Y8T|zN*+X}2)|zX+_d?@; zAxx6+f67Q9r%kpaNr{#2cT)0&mKYoUo(Dc7o!DiIi;}PBfvr$bVS`s}rY((0QvP2` zvzSt4cZ2P#T1KykbGv z*D!~>P#%HwyvI#5PsSN;Q-hDqGFlnla*QrvZ-gv-UqOGH$a% ze~ddC>)du7eY>YE)+C2AH4b#D_rP*rrcpJi&y4rhjgb?f4uY2;wCqRk3ws{xCl)q zIn#2K8>(-+U7b_)!3t-Z)VY5UTEjBqf8C@7=Q|;0isylDE(R}qFsv;?$zOLJIMk3$ zwLhi}b}0CT*9%kgu-2c=02e7C&2}~dt36_AQFhRB3EsisX!VlMO30E{Q*8>sp~V3lhi0!>QZjpHe=YPb zj!2@QuOqS8g3y&To1vNHL=*%t2pcUaDNTi()z%`VdrZZY3K=w7Q#$L1CQEHhyc7XY zj-0MrajmjnlV;g2r0FKR9HoMAInt`SoTwscVdWCnn`Bo-mv&XsiI*Y(UPTY}v42U9 zkhZhFSZ#gCg`9OhMPEC|lEppte^;+Z;-v_H7m!hJ*OKcfS8o?QWd&H_DeR)Y3t79X zdKo-l9Kbu)q0X_fSBZ%RI4Y@&pC@$Wb#PR|nhUSLmt)moU49=WAHXV4qQXfID5iAd zcFr~&^Sqhte%5UBFx*+OswllVz)33bOn$b=S4J&v(};bHw|~JlU8Rc?e{nL!!cD~} zXg+<<#&GxF4S#Pb+D!1awrpESqXtmxN ijis(^wvBCL+xQQigYV_E&dgT;0000RbIgW diff --git a/slate/source/includes/_introduction.md b/slate/source/includes/_introduction.md index eaf5d8f0..35b8b86a 100644 --- a/slate/source/includes/_introduction.md +++ b/slate/source/includes/_introduction.md @@ -3,3 +3,5 @@ [WebODM](https://github.com/OpenDroneMap/WebODM) is a free, user-friendly, extendable application and API for drone image processing. It generates georeferenced maps, point clouds and textured 3D models from aerial images. Developers can leverage this API to extend the functionality of [WebODM](https://github.com/OpenDroneMap/WebODM) or integrate it with existing software like [QGIS](http://www.qgis.org/) or [AutoCAD](http://www.autodesk.com/products/autocad/overview). + +![Point Cloud](https://raw.githubusercontent.com/OpenDroneMap/WebODM/master/screenshots/pointcloud.png) \ No newline at end of file diff --git a/slate/source/includes/_quickstart.md b/slate/source/includes/_quickstart.md index c40ea830..36f62607 100644 --- a/slate/source/includes/_quickstart.md +++ b/slate/source/includes/_quickstart.md @@ -2,7 +2,7 @@ ## How To Process Images -In this tutorial we'll explore how to process an orthophoto from a set of aerial images. To do that we'll need to: +In this tutorial we'll explore how to process an orthophoto from a set of aerial images using Python. To do that we'll need to: - Authenticate - Create a [Project](#project). Projects are a way to group together related [Task](#task) items @@ -49,8 +49,7 @@ images = [ # ... ] options = json.dumps([ - {'name': "use-opensfm-pointcloud", 'value': True}, - {'name': "orthophoto-resolution", 'value': 24}, + {'name': "orthophoto-resolution", 'value': 24} ]) res = requests.post('http://localhost:8000/api/projects/{}/tasks/'.format(project_id), @@ -64,7 +63,7 @@ task_id = res['id'] ``` We can then create a [Task](#task). The only required parameter is a list of multiple, multipart-encoded `images`. Processing will start automatically -as soon as a [Processing Node](#processingnode) is available. It is possible to specify additional options by passing an `options` value, which is a JSON-encoded list of name/value pairs. Several other options are available. See the [Task](#task) reference for more information. +as soon as a [Processing Node](#processing-node) is available. It is possible to specify additional options by passing an `options` value, which is a JSON-encoded list of name/value pairs. Several other options are available. See the [Task - Processing Options](#processing-options) reference for more information.
```python @@ -97,7 +96,7 @@ with open("orthophoto.tif", 'wb') as f: print("Saved ./orthophoto.tif") ``` -Our orthophoto is ready to be downloaded. A variety of other assets, including a dense 3D point cloud and a textured model [are also available](#download). +Our orthophoto is ready to be downloaded. A variety of other assets, including a dense 3D point cloud and a textured model [are also available](#download-assets). Congratulations! You just processed some images. diff --git a/slate/source/includes/reference/_permissions.md b/slate/source/includes/reference/_permissions.md new file mode 100644 index 00000000..a6fea15d --- /dev/null +++ b/slate/source/includes/reference/_permissions.md @@ -0,0 +1,36 @@ +# Reference + +## Authentication + +> Get authentication token: + +```bash +curl -X POST -d "username=testuser&password=testpass" http://localhost:8000/api/token-auth/ + +{"token":"eyJ0eXAiO..."} +``` + +> Use authentication token: + +```bash +curl -H "Authorization: JWT " http://localhost:8000/api/projects/ + +{"count":13, ...} +``` + +`POST /api/token-auth/` + +Field | Type | Description +----- | ---- | ----------- +username | string | Username +password | string | Password + +To access the API, you need to provide a valid username and password. You can create users from WebODM's Administration page. + +If authentication is successful, you will be issued a token. All API calls should include the following header: + +Header | +------ | +Authorization: JWT `your_token` | + +The token expires after a set amount of time. The expiration time is dependent on WebODM's settings. You will need to request another token when a token expires. diff --git a/slate/source/includes/reference/_processingnode.md b/slate/source/includes/reference/_processingnode.md new file mode 100644 index 00000000..c62c352e --- /dev/null +++ b/slate/source/includes/reference/_processingnode.md @@ -0,0 +1,119 @@ +## Processing Node + +> Example processing node: + +```json +{ + "id": 2, + "hostname": "nodeodm.masseranolabs.com", + "port": 80, + "api_version": "1.0.1", + "last_refreshed": "2017-03-01T21:14:49.918276Z", + "queue_count": 0, + "available_options": [ + { + "help": "Oct-tree depth at which the Laplacian equation is solved in the surface reconstruction step. Increasing this value increases computation times slightly but helps reduce memory usage. Default: 9", + "name": "mesh-solver-divide", + "type": "int", + "value": "9", + "domain": "positive integer" + }, + ... +``` + +Processing nodes are associated with zero or more tasks and +take care of processing input images. Processing nodes are computers or virtual machines running [node-OpenDroneMap](https://github.com/OpenDroneMap/node-OpenDroneMap/) or any other API compatible with it. + +Field | Type | Description +----- | ---- | ----------- +id | int | Unique Identifier +hostname | string | Hostname/IP address +port | int | Port +api_version | string | Version of node-OpenDroneMap currently running +last_refreshed | string | Date and time this node was last seen online. This value is typically refreshed every 15-30 seconds and is used to decide whether a node is offline or not +queue_count | int | Number of [Task](#task) items currently being processed/queued on this node. +available_options | JSON[] | JSON-encoded list of name/value pairs that represent the list of options that this node is capable of handling. + + +### Add a processing node + +`POST /api/processingnodes/` + +Parameter | Required | Default | Description +--------- | -------- | ------- | ----------- +hostname | * | "" | Hostname/IP address +port | * | | Port + +All other fields are automatically populated, and shouldn't generally be specified. + +### Update a processing node + +`PATCH /api/processingnodes/` + +Parameters are the same as above. + +### Delete a processing node + +`DELETE /api/processingnodes/` + +Upon deletion, all [Task](#task) items associated with the node will continue to exist. You might get errors (duh!) if you delete a processing node in the middle of processing a [Task](#task). + + +### Get list of processing nodes + +`GET /api/processingnodes/` + +Parameter | Required | Default | Description +--------- | -------- | ------- | ----------- +id | | "" | Filter by id +hostname | | "" | Filter by hostname +port | | "" | Filter by port +api_version | | "" | Filter by API version +queue_count | | "" | Filter by queue count +ordering | | "" | Ordering field to sort results by +has_available_options | | "" | Return only processing nodes that have a valid set of processing options (check that the `available_options` field is populated). Either `true` or `false`. + +#### Example: Show only nodes that have a valid set of options + +`GET /api/processingnodes/?has_available_options=true` + +#### Example: Sorting + +`GET /api/processingnodes/?ordering=-hostname` + +Sort by hostname, descending order. + + + + +### Processing Options + +> Processing options example: + +```json +[ + { + "help": "Oct-tree depth at which the Laplacian equation is solved in the surface reconstruction step. Increasing this value increases computation times slightly but helps reduce memory usage. Default: 9", + "name": "mesh-solver-divide", + "type": "int", + "value": "9", + "domain": "positive integer" + }, + { + "help": "Ignore matched keypoints if the two images share less than percent of keypoints. Default: 2", + "name": "matcher-threshold", + "type": "float", + "value": "2", + "domain": "percent" + }, + ... +``` + +`GET /api/processingnodes/options/` + +Display the common options available among all online processing nodes. This is calculated by intersecting the `available_options` field of all online processing nodes visible to the current user. + +Use this list of options to check whether a particular option is supported by all online processing nodes. If you use the automatic processing node assignment feature for processing tasks, this is the list you want to display to the user for choosing the options to use during processing. + + + diff --git a/slate/source/includes/reference/_task.md b/slate/source/includes/reference/_task.md index 77e4d85f..47b5d4ab 100644 --- a/slate/source/includes/reference/_task.md +++ b/slate/source/includes/reference/_task.md @@ -32,15 +32,15 @@ Field | Type | Description ----- | ---- | ----------- id | int | Unique identifier project | int | [Project](#project) ID the task belongs to -processing_node | int | The ID of the [Processing Node](#processingnode) this task has been assigned to, or `null` if no [Processing Node](#processingnode) has been assigned. +processing_node | int | The ID of the [Processing Node](#processing-node) this task has been assigned to, or `null` if no [Processing Node](#processing-node) has been assigned. images_count | int | Number of images -uuid | string | Unique identifier assigned by a [Processing Node](#processingnode) once processing has started. +uuid | string | Unique identifier assigned by a [Processing Node](#processing-node) once processing has started. name | string | User defined name for the task processing_time | int | Milliseconds that have elapsed since the start of processing, or `-1` if no information is available. Useful for displaying a time status report to the user. -auto_processing_node | boolean | Whether WebODM should automatically assign the next available [Processing Node](#processingnode) to process this [Task](#task). A user can set this to `false` to manually choose a [Processing Node](#processingnode). +auto_processing_node | boolean | Whether WebODM should automatically assign the next available [Processing Node](#processing-node) to process this [Task](#task). A user can set this to `false` to manually choose a [Processing Node](#processing-node). status | int | One of [Status Codes](#status-codes), or `null` if no status is available. -last_error | string | The last error message reported by a [Processing Node](#processingnode) in case of processing failure. -options | JSON[] | JSON-encoded list of name/value pairs, where each pair represents a command line option to be passed to a [Processing Node](#processingnode). +last_error | string | The last error message reported by a [Processing Node](#processing-node) in case of processing failure. +options | JSON[] | JSON-encoded list of name/value pairs, where each pair represents a command line option to be passed to a [Processing Node](#processing-node). ground_control_points | string | Currently unused. See [#37](https://github.com/OpenDroneMap/WebODM/issues/37) created_at | string | Creation date and time pending_action | int | One of [Pending Actions](#pending-actions), or `null` if no pending action is set. @@ -54,10 +54,10 @@ pending_action | int | One of [Pending Actions](#pending-actions), or `null` if Parameter | Required | Default | Description --------- | -------- | ------- | ----------- images[] | * | "" | List of multipart-encoded images (2 minimum) -processing_node | | null | The ID of the [Processing Node](#processingnode) this [Task](#task) should be assigned to. If not specified, and auto_processing_node is `true`, a [Processing Node](#processingnode) will be automatically assigned. +processing_node | | null | The ID of the [Processing Node](#processing-node) this [Task](#task) should be assigned to. If not specified, and auto_processing_node is `true`, a [Processing Node](#processing-node) will be automatically assigned. name | | "" | User defined name for the task -auto_processing_node | | true | Whether WebODM should automatically assign the next available [Processing Node](#processingnode) to process this [Task](#task). -options | | "[]" | JSON-encoded list of name/value pairs, where each pair represents a command line option to be passed to a [Processing Node](#processingnode). +auto_processing_node | | true | Whether WebODM should automatically assign the next available [Processing Node](#processing-node) to process this [Task](#task). +options | | "[]" | JSON-encoded list of name/value pairs, where each pair represents a command line option to be passed to a [Processing Node](#processing-node). You assign a [Task](#task) to a [Project](#project) by passing the proper `project_id` path in the URL. @@ -107,31 +107,72 @@ Retrieves all [Task](#task) items associated with `project_id`. ### Download assets -TODO +`GET /api/projects/{project_id}/tasks/{task_id}/download/{asset}/` -### Download assets (raw) +After a task has been successfully processed, the user can download several assets from this URL. -TODO +Asset | Description +----- | ----------- +all | Archive (.zip) containing all assets, including an orthophoto, TMS tiles, a textured 3D model and point cloud in various formats. +geotiff | GeoTIFF orthophoto. +las | Point cloud in .LAS format. +ply | Point cloud in .PLY format. +csv | Point cloud in .CSV format. + +### Download assets (raw path) + +`GET /api/projects/{project_id}/tasks/{task_id}/assets/{path}/` + +After a task has been successfully processed, its assets are stored in a directory on the file system. This API call allows direct access to the files in that directory (by default: `WebODM/app/media/project/{project_id}/task/{task_id}/assets`). This can be useful to those applications that want to stream a `Potree` dataset, or render a textured 3D model on the fly. + + ### Retrieve console output -TODO +> Console output example: + +```bash +curl -H "Authorization: JWT " http://localhost:8000/api/projects/2/tasks/1/output/?line=5 + +[DEBUG] /var/www/data/e453747f-5fd4-4654-9622-b02727b29fc5/images\n[DEBUG] Loaded DJI_0219.JPG | camera: dji fc300s ... +``` + + +`GET /api/projects/{project_id}/tasks/{task_id}/output/` + +As a [Task](#task) is being processed, processing nodes will return an output string that can be used for debugging and informative purposes. Output is only available after processing has started. + +Parameter | Required | Default | Description +--------- | -------- | ------- | ----------- +line | | 0 | Only display the output starting from a certain line number. This can be useful to display output in realtime to the user by keeping track of the number of lines that have been displayed to the user so far and thus avoiding to download all output at every request. ### Cancel task -TODO +`POST /api/projects/{project_id}/tasks/{task_id}/cancel/` + +Stop processing a [Task](#task). Canceled tasks can be restarted. ### Remove task -TODO +`POST /api/projects/{project_id}/tasks/{task_id}/remove/` + +All assets associated with it will be destroyed also. If the [Task](#task) is currently being processed, processing will stop. ### Restart task -TODO +`POST /api/projects/{project_id}/tasks/{task_id}/restart/` + +If a [Task](#task) has been canceled or has failed processing, or has completed but the user decided to change processing options, it can be restarted. If the [Processing Node](#processing-node) assigned to the [Task](#task) has not changed, processing will happen more quickly compared to creating a new [Task](#task), since the [Processing Node](#processing-node) remembers the `uuid` of the [Task](#task) and will attempt to reuse previous results from the computation pipeline. ### Orthophoto TMS layer -TODO +`GET /api/projects/{project_id}/tasks/{task_id}/tiles.json` + +`GET /api/projects/{project_id}/tasks/{task_id}/tiles/{Z}/{X}/{Y}.png` + +After a task has been successfully processed, a TMS layer is made available for inclusion in programs such as [Leaflet](http://leafletjs.com/) or [Cesium](http://cesiumjs.org). ### Pending Actions @@ -147,7 +188,7 @@ RESTART | 3 | [Task](#task) is being restarted Status | Code | Description ----- | ---- | ----------- -QUEUED | 10 | [Task](#task)'s files have been uploaded to a [ProcessingNode](#processingnode) and are waiting to be processed. +QUEUED | 10 | [Task](#task)'s files have been uploaded to a [#processing-node](#processing-node) and are waiting to be processed. RUNNING | 20 | [Task](#task) is currently being processed. FAILED | 30 | [Task](#task) has failed for some reason (not enough images, out of memory, Piero forgot to close a parenthesis, etc.) COMPLETED | 40 | [Task](#task) has completed. Assets are be ready to be downloaded. diff --git a/slate/source/includes/reference/temp.md b/slate/source/includes/reference/temp.md deleted file mode 100644 index 93ad6c7b..00000000 --- a/slate/source/includes/reference/temp.md +++ /dev/null @@ -1 +0,0 @@ -At this point a TMS layer is also made available at `http://localhost:8000/api/projects/{project_id}/tasks/{task_id}/tiles.json` for inclusion in programs such as [Leaflet](http://leafletjs.com/) or [Cesium](http://cesiumjs.org). \ No newline at end of file diff --git a/slate/source/index.html.md b/slate/source/index.html.md index d8047076..6906ab48 100644 --- a/slate/source/index.html.md +++ b/slate/source/index.html.md @@ -7,6 +7,7 @@ language_tabs: toc_footers: - WebODM on GitHub - OpenDroneMap on GitHub + - node-OpenDroneMap on GitHub search: true @@ -16,4 +17,6 @@ includes: - reference/authentication - reference/project - reference/task + - reference/processingnode + ---