= CS-Map RFC 1 - Creation of a GDC file to handle French grid files = This page contains an change request (RFC) for the CS-Map Open Source project. More CS-Map RFCs can be found on the [wiki:CsMapRfcs RFCs] page. == Status == ||RFC Template Version||(1.0)|| ||Submission Date||Mon Oct 27 20:00:00 2008|| ||Last Modified||Hugues Wisniewski [[Timestamp]]|| ||Author||Hugues Wisniewski|| ||RFC Status||implemented|| ||Implementation Status||implemented|| ||Proposed Milestone||12.1|| ||Assigned PSC guide(s)||Hugues Wisniewski, Norm Olsen|| ||'''Voting History'''||11/11/08|| ||+1|| Norm, Frank, Mark, Hugues || ||+0|| || ||-0|| || ||-1|| || ||no vote|| || == Overview == Currently, the French systems that use the datum NTF-G-Grid use the datum conversion technique RGF93 that uses a single grid file gr3df97a.txt, a choice that is hard coded inside the CS-Map code. While this single grid file covers the whole country of France there are now new grid files for the metropolitan areas of this country that offer a greater precision and there is a strong need to support these new grid files. == Motivation == All French cities that need to use a dedicated transformation grid file can currently not use such grid files with CS-Map. Those cities include but are not limited to: Bordeaux, Nice, Toulouse, Marseille, Nates. == Proposed Solution == The concept of a Geodetic Data Catalog file (.gdc) is already in use in CS-Map for the North American continent for instance, through the use of text files that list the grid files to be used for a particular datum conversion technique. The extension of these files is .gdc and the files are editable by the users to add more files, comment out a grid they don’t want to use, or change the order in which the grid files are used. The order matters only when two grid files overlap and a point is located right in this region. In this case we need to make a choice of what grid file needs to be used, this choice is made depending on the order the grid files are listed in this GDC file and other options. So, if the order is not the one that is needed, the end user can change it by just editing the text of the .gdc file. The new IGN grid files cover only the metropolitan areas and use the NTV2 file format. The new gdc file will list the existing gr3df97a.txt file and these new NTV2 grid files, knowing that more can be added as they become available. == Implications == Since the redistribution of the NTV2 grid files is not allowed, the reference to these files will be commented out by default and users will have to contact the IGN to get them and then edit their copy of the gdc file to uncomment them. That means that by default the behavior will be the same as it is today. This NTV2 situation and its non-distribution is similar to the Canadian NTV2 grid file that is currently not distributed. Systems that use the datum NTF-G-Grid are systems like: NTF.Lambert-1, NTF.Lambert-3, NTF.Lambert-3, … The existing grid file is used when a conversion occurs from one of these system to, for instance, Lambert93, RGF93.CC42 or RGF93.CC50 After the code change, and the use of the new gdc file, nothing will change at the level of the coordinate system definitions inside the dictionaries. What will decide the use of the metropolitan grid files to get a greater accuracy is the order in which the grid files will be listed in the new gdc file for these same conversions. == Test Plan == Test points will be provided and added to the test point file TEST.DAT and will be taken into account when the regress test is executed before each new future code submission. Since the grid files cannot be redistributed, the test points will be commented out by default in the test file. == Funding/Resources == Provided by Autodesk.