1 新增说明文件

docker/ubuntu1804/readme.md

@@ -7,19 +7,77 @@ docker exec -it <container_id> /usr/bin/jfhdconvertor --help
 Usage:
   /usr/bin/jfhdconvertor [OPTION...]
 
-  -m, --mode arg  pcd2las,pcd2las.auto (default: pcd2las.auto)
+  -m, --mode arg  pcd2las : must args --workdir; pcd2las.auto: must args
+                  --pcdfile,--lasfile; pcd2las.stationfiles : must args
+                  --pcdfile,--lasfile,--jf_station_file, --jd_station_file (default:
+                  pcd2las.stationfiles)
   -h, --help      Print help
 
- pcd2las.auto options:
-      --workdir arg  自动化的任务根目录
+ options options:
+      --workdir arg          自动化的任务根目录
+      --pcdfile arg          输入pcd文件路径
+      --lasfile arg          输出las文件路径
+      --offsetxyz arg        A list of doubles (default: 0.0,0.0,0.0)
+      --jf_station_file arg  JF 站心定义文件,必须包含 E0_PROJECT:*
+                             N0_PROJECT:* H0_PROJECT:* 三对UTM
+                             站心(偏移)信息
+      --jd_station_file arg  JD 站心和校正,必须包含E0_UTM_JD:*
+                             N0_UTM_JD:* H0_UTM_JD:* 三对UTM
+                             站心(偏移)信息, 可包含E_OFFSET:* N_OFFSET:* H_OFFSET:*
+                             的校正信息
+例子(指定输入pcd,输出las文件,jf站心文件，jd站心文件)：
+说明：此模式必须指定 --pcdfile,--lasfile,--jf_station_file,--jd_station_file 四个参数，下方是一条真实的使用命令:
 
- pcd2las options:
-      --pcdfile arg    输入pcd文件路径
-      --lasfile arg    输出las文件路径
-      --offsetxyz arg  A list of doubles (default: 0.0,0.0,0.0)
+    -m pcd2las.stationfiles --pcdfile E:/data/jd/10-1/pcd_utm_merge/12_ground_utm_add_object.pcd --lasfile E:/data/jd/10-1/submit/jd/0107/12_ground_utm_add_object.las --jf_station_file E:/data/jd/10-1/10-1_station_jf.txt --jd_station_file E:/data/jd/10-1/10-1_station_jd.txt
+
+    路径使用 posix 的 / 作为分级符号，输出的las文件的目标文件加不存在会自动创建
 
 ##生成京东元数据信息
 
 docker exec -it <container_id> python3 /usr/local/jd_metadata_generator.py --help
 
-程序的详细使用请参考命令行提示信息,目录模式请参考《点云作业线目录规则.png》
+程序的帮助信息:
+
+usage: jd_metadata_generator.py [-h] [--workdir [WORKDIR]]
+                                [--jdstationfile [JDSTATIONFILE]]
+                                [--no_offset]
+                                [--jdpublishinfofile [JDPUBLISHINFOFILE]]
+                                [--inpututmshpdir [INPUTUTMSHPDIR]]
+                                [--input_pcddir [INPUT_PCDDIR]]
+                                [--verb_all_pcd]
+                                [--output_jdmetafile [OUTPUT_JDMETAFILE]]
+                                [--output_jdutmshp_dir [OUTPUT_JDUTMSHP_DIR]]
+                                [--output_customutmshp_dir [OUTPUT_CUSTOMUTMSHP_DIR]]
+                                {dir,args}
+
+Process some intergers
+
+positional arguments:
+  {dir,args}            程序运行模式,目录模式，全参数模式
+
+optional arguments:
+  -h, --help            show this help message and exit
+
+mode=dir:
+  --workdir [WORKDIR]   执行根目录
+
+mode=args:
+  --jdstationfile [JDSTATIONFILE]
+                        描述觉非到京东数据校正信息和京东站心的文件
+  --no_offset           指定此标记:不进行矢量校正，否则使用jdstationfile中的校正信息进行矢量校正
+  --jdpublishinfofile [JDPUBLISHINFOFILE]
+                        京东发布信息文件,发布信息json文件中定义京东数据的政区，数据编号，数据名称，数据内容，数据描述
+  --inpututmshpdir [INPUTUTMSHPDIR]
+                        输入的utm坐标系的shp数据
+  --input_pcddir [INPUT_PCDDIR]
+                        输入统计点数的pcd文件夹路径，不搜索子文件夹
+  --verb_all_pcd        指定此标记:统计所有pcd文件中点数,否则:只统计后缀为 _groud.pcd _object.pcd 点数
+  --output_jdmetafile [OUTPUT_JDMETAFILE]
+                        输出的京东元数据文件(发布给京东的原数据信息)
+  --output_jdutmshp_dir [OUTPUT_JDUTMSHP_DIR]
+                        输出京东偏移要求的shp(最终发布给京东的矢量)
+  --output_customutmshp_dir [OUTPUT_CUSTOMUTMSHP_DIR]
+                        输出自定义utm坐标系的shp(jf内部使用的验证矢量)
+
+实例，使用args(参数模式)执行程序，该模式必须指定 --jdstationfile --jdpublishinfofile,--inpututmshpdir,--input_pcddir,--output_jdmetafile,--output_jdutmshp_dir
+,--output_customshp_dir

docker/ubuntu1804/样例数据/10-1/10-1_station_jd.txt

+SRID:32651
+E_OFFSET:0.0
+N_OFFSET:0.0
+H_OFFSET:0.0
+E0_UTM_JD:280000.0
+N0_UTM_JD:3490000.0
+H0_UTM_JD:0.0
+
+#E_OFFSET,N_OFFSET,H_OFFSET 觉非数据在原始基础上偏移的值
+#E0_UTM_jd,N0_UTM_jd,H0_UTM_jd 京东认为的站心，照杰出给京东tiff时拿到的 merge_utm 时使用的站心信息
+#任务6,9需要对咱们的矢量数据做校正，所以有OFFSET的需求，除6、9外其他任务的数据直接使用sation_jf.txt的站心信息
+#任务6 对觉非的数据做偏移(+) 偏移值  (x,y,z) = str(-0.464125,-2.039542,-0.703573)

docker/ubuntu1804/样例数据/10-1/10-1_station_jf.txt

+LON_WGS84:113.54 
+LAT_WGS84:40.256
+HIGH_WGS84:13.06
+SRID:32651
+E0_PROJECT:280000.0
+N0_PROJECT:3490000.0
+H0_PROJECT:0.0
+
+#此文件描述觉非内部点云的站心坐标(经度、纬度、高度)的投影坐标系的点云站心坐标(东坐标，北坐标，高坐标)

docker/ubuntu1804/样例数据/10-1/submit/jd/publish_info.json

+{
+    "firstname": "ChangShu",
+    "secondname": "Road101",
+    "dataversion_major": 1,
+    "dataversion_minor": 5,
+    "metadata": {
+        "数据编号": "QD001",
+        "数据名称": "",
+        "规格版本": "",
+        "数据内容": "vct,pcd",
+        "数据描述信息": "",
+        "城市": "苏州市",
+        "区县": "常熟市"
+    }
+}
\ No newline at end of file