movinglines


Namemovinglines JSON
Version 1.50 PyPI version JSON
download
home_pagehttps://github.com/samuelleblanc/fp
SummaryMoving Lines - Research flight planner
upload_time2024-04-13 07:41:19
maintainerSamuel LeBlanc
docs_urlNone
authorSamuel LeBlanc
requires_pythonNone
licenseGPL-3.0
keywords ml
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Name:

Moving Lines, version 1.50

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1478125.svg)](https://doi.org/10.5281/zenodo.1478125)

~~Get the compiled versions for MAC OS and Windows at:
[https://github.com/samuelleblanc/fp/releases/tag/v1.44]~~   compiled versions not longer maintained, use conda install now (see below)
    
# Purpose:
    
Flight Planning software for creating flight plans for Airborne Science
    
Creates a visual map interface and backend calculations to a spreadsheet flight planning tool
Takes advantage of clickable map for creating a flight plan, and already existing Excel software
    
# Install: 

## Install code from the anaconda package manager (recomended):
1)  If you don't have a anaconda / miniconda / mamba install, please do so. Recommendation to install miniconda following this link [https://www.rho-signal-effective-analytics.com/modules/pre-course/miniconda-installation/].  
    Ensure that the base environment is activated: `conda activate`  
2)  From the command line, create a new environment based on python 3.9, activate it, then install the movinglines package (using mamba is faster than conda).
	```
	conda create -n ml python=3.9
	conda activate ml
	mamba install -c samuelleblanc movinglines
	```  
   *for current conda/anaconda install, without mamba/miniconda/miniforge replace last line with*
	```
	conda install samuelleblanc::movinglines
	```    
 if you encounter errors with conda, ensure that you have the conda-froge channel in conda (it is automatic for mamba)
	```
 	conda config --add channels conda-forge
 	```    
  
3)  Go through and accept the install of the required packages
4)  at the command line, start the lines software by typing `ml`

   *or*

## For compiled versions: **No longer Maintained**
1) Download appropriate zip file and extract to desired location
2) run the executable (ml for OSX, ml.exe for Win)
        for OSX:
            - ~~run from command line, must cd to directory hosting the ml exectuable~~
            - executable version of OSX is being phased out, please use the conda install method above
        for Windows:
            - double click the ml.exe icon  

   *or*  
## For python installs:
1) `pip install movinglines`
2) at a command line, start the moving lines software by typing `ml`  
	
# Quick Start: 
    1) Select the mapping profile (defaults to ORACLES), can change the map boundaries, take-off time, utc offset
    2) wait about 30seconds
    3) Enter date of planned flight in dialog in format yyyy-mm-dd
    4) wait for map to initialize and excel to load
	5) move cursor over map to refresh map
    6) create points, move points by clicking, or by manually entering in excel spreadsheet
    7) Once happy save all the figures, files, excel files, kml files by either selecting each point, or by pressing the 'saveall' button
    
## Adding points:
    1) click and drag on map to create new point 
    2) modify altitudes, speed, or other properties of new point in excel spreadsheet
  *or*
  
    1) enter lat and lon in excel spreadsheet, optionally altitude and speed, delay time, start time
    2) move cursor over map area to refresh *or* press green refresh button
  *or*
  
    1) Press the 'add' button next to 'points:'
    2) Follow the dialog
  *or*
	
	1) add a flight module with the button 'flt_module'
	2) see below or follow dialogs
    
## Moving points
    1) Click on point on map, and then drag
*or*
    
    1) change coordinates in Excel spreadsheet
    2) move cursor over map area to refresh
*or*

    1) Use the 'Move' button and select points to move, then follow dialog
    
## Delete points
    1) delete line from the excel spreadsheet
    2) move cursor over map to refresh
    
## Use flt modules for prepared flight plans (similarly to macros)
    1) Select button: 'Add flt module'
    2) select the flt module from the radiobutton list
    3) enter the quantities demanded from the flt file
    
## Creating a flt module (or macro)
    1) in the flt_module folder create a text file
    2) the text file name should be descriptive of the macro with an extension '.flt'
    3) first line starts with the percent sign '%' then a list of variables to be used
    4) Comments can be included, but only at the start of the line, denoted with a hash '#' sign
    5) each subsequent line is a move command, which can use simple math and the variables defined in the first line
    6) format of the lines are: bearing,distance,altitude
        where the bearing is the azimuth angle of the plane
        where the distance is the length of that leg
        where the altitude (which can be omitted) is the altitude of the plane for the next waypoint
    7) enter number of points desired for macro then save in the flt_module directory. It is ready to be used in the software without the need for a restart.
    8) if desired, make a screenshot of the resulting flt_module and save it with the same name in the flt_module folder as a .png
    
## Adding other planes or flight paths:
    1) Press the 'New Flight Path' button
    2) Enter name of new flight path. If it contains the name of a plane (e.g. p3, er2, dc8, c130,baer), will use the predefined speeds for that plane
    3) New flight path will have different color

## Adding figures and model maps:
	1) select add WMS
	2) choose which website to load the web map service. For MSS select that one which has the corresponding title
	3) follow dialogs for selecting the right times, layer, level, etc.
    
## Adding platform default information:
    1) locate the platform.txt file.
    2) in the file, there is a series of python dict formats with each a defined list of variables that sets the flight characteristics of the plane/platform
    3) modify exisiting pltform dict, or create a new one based on the template and the guidance shown in the file.
    
## Change which flight path is active:
    1) Press the button related to the flight path desired just above the 'New Flight Path' button
**do not switch with Excel Spreadsheet**
    
## Move, zoom the map around:
    1) Buttons at the bottom of the map are used for navigation
    2) from left to right: Home screen (first image seen), Previous view, Next view, Pan, Zoom, subplots properties, save map
	3) Can use the scroll in to zoom into point, or scroll out.
**If zoom is selected, draw rectangle to desired location, will not be able to make new points until zoom unselected**
    
## Saving flight paths for sharing
    1) Press the 'Save all' button to create all figures and save them
    2) Follow dialog to find the desired saving location
    
## Opening previously saved flight plans:
    1) Press the Excel File: 'Open' button. 
    2) select the Excel file
    3) will take some time to populate the flight paths
    4) Might need to press refresh button after loading
    
## Save flight plans:
    1) Press the 'Save' button next to Excel File
*or*

    1) Save the Excel file, from Excel using normal dialog
    
## Change definitions of platform speeds, and altitudes
    1) open the platform.txt file
    2) follow the documentation in the header for creating or modifying any line defining the platform
    3) save the file as platform.txt and share
    4) put the new platform.txt in the sam folder as the ml.py script or ml executable
    
# Notes and tips about usage:

    - clicking on the first point will create a waypoint to it
    - second point to be added will have the default transit altitude for that aircraft (if available)
    - when holding down the mouse button, range circles will appear, along with the sun's azimuthal location at that time denoted by the yellow star and dashed lines
    - Saving to: ICT button will create a sample ict file with 60 seconds points interpolated between each waypoint
    - plots of solar angle and altitude profiles is created with the Plots buttons
    
# Requirements:

## Windows:
        - compiled version run windows 64 bit, (32 bit not tested) (Windows 7,8,10)
        - Microsoft Excel
        - optionally Google Earth
    
## OSX:
        - compiled version tested on El Capitan Mac OSX v10.11, 64bit (others not tested)
        - Microsoft Excel
        - optionally Google Earth
    
## source:
        - Python 3.9
        - Numpy
        - Scipy
        - matplotlib
        - ~~basemap from matplotlib (http://matplotlib.org/basemap/)~~ cartopy
        - Tkinter (usually included in python)
        - simplekml, pykml
        - gpxpy
        - owslib
        - xlwings
        - Pysolar (distributed with source)
        - See requirements.txt for full modules dependencies
        
# Required files (included in distribution):

    - labels.txt : csv files with points on map to be labelled. Each line represent one point, Format: name, longitude, latitude, marker and color symbol
    - aeronet_locations.txt: csv files with location of aeronet sites. found from : http://aeronet.gsfc.nasa.gov/aeronet_locations.txt
    - sat.tle: Selected data for satellite tracks in form of Two Line Element set from http://www.celestrak.com
    - profiles.txt: text file containing dictionary assignment for map setup defaults. each profile linked to a field mission, python dict format.
    - platform.txt: text file containing dictionary assignment for details on each platform: max altitude, max speed, speed profile, vertical speed profile, turning rate
    - WMS.txt: list of possible WMS servers for getting map images from the internet.
    - arc.ico: icon file
    - file.rc: plotting defaults file (python matplotlib.rc format)
    - map_icons: folder with icons for use on google earth (optional)
    - flt_modules: folder with multiple flt files. To use when creating the flt_module paths. 
    - ~~map_???.pkl: files to enable faster initial loading of the basemap~~
    
# Source files:

    - ml.py : Main program. Used to setup the interface, link to the excel spreadsheet and start the program
    - map_interactive.py: Basemap plotting and interactive map clicking support
    - excel_interface.py: interfaces with Excel, Core of the calculations, *contains speed and altitude calculations*
    - gui.py: Handling the button events and functions. Has the saving routines interfaces
    - map_utils.py: various map utilities, like bearing calculations, great circle calculations
    - write_utils.py: writing utitlies, expecially for ICT file creation
    - load_utils.py: loading of various format utilities and conversion of input formats
    - aeronet.py: loading and presenting the aeronet real time AOD on the map

# To do/wish list:

    - add platform info button next to flight paths (to change its settings)
    - add ship tracks, or position of ships
    - add capabilities to load hdf files and put contour as background
    - add remove flight button

# Known Bugs:

    - Sometime slow starting up, especiallly when excel is not open 
	- Adding figures when not in platecaree / cylindrical / mercator projections is buggy
    
# Modification History:

    Written: Samuel LeBlanc, 2015-08-07, at NASA Ames Research Center, from Santa Cruz, CA
                Copyright 2015 Samuel LeBlanc 
    Modified (v0.7b): Samuel LeBlanc, NASA Ames, 2015-09-06
                       Initial presentation of software. Added smooth dragging and some calculations, with image overlay
    Modified (v0.8b): Samuel LeBlanc, NASA Ames, 2016-06-15
                       Corrected speed trace. 
                       Added sun position calculations
                       Modified some gui placement
                       Added ICT file creation, and save all button
    Modified (v0.9b): Samuel LeBlanc, NASA Ames, 2016-06-22
                       Added flt_module command for creating parts of flights via macros
    Modified (v0.95b): Samuel LeBlanc, NASA Ames, in transit to WFF, 2016-07-11
                       Added platform information file to facilitate modification of
                        default platform parameters (cruising altitude, speed profile, climb time, turning rate)
                       Added button to remove the satellite tracks
                       updated the sat.tle file 
                       bug fix for recognizing platform after excel file load, tried to fix bug in altitude and speed calculations
                       Added selections for altitude in feet/meter and distance in nm/km for flt_module loading.
    Modified (v0.97b): Samuel LeBlanc, NASA Ames, at Santa Cruz, CA, 2016-07-18
                       bug fix for improper parallels and meridians drawing. 
                       Some speed improvements
                       updated aeronet site locations and sat.tle satellite predictions and icon
    Modified (v1.00): Samuel LeBlanc, NASA Ames, CA, 2016-07-22
                       bug fix to sza and azimuth calculations
                       bug fix to aircraft bearing calculations
                       new icons and kmz saving
                       new modes for WMS loading with GEOS and other
                       extracted definitions of platform speeds and altitude to a seperate file
    Modified (v1.03): Samuel LeBlanc, NASA Ames, CA, 2016-07-22
                       bug fix to excel file loading and improper time zone correction
                       new Special Use Airspace button
                       generalized WMS interface for loading maps from the internet
                       special excel spreadsheet fiel saving for pilots 
    Modified (v1.1): Samuel LeBlanc, NASA 
                       bug fixes to presentation and file saving
                       faster updating of the map screen and draggable legend
                       User modifiable default aircraft propeties (platform.txt) and map properties (profiles.txt)
                       Included loading of special map severs (special use airspace, WMS, GEOS)
    Modified (v1.2): Samuel LeBlanc, Sao Tomé, 2017-08-16
                        for_pilots spreadsheet now can be configured to save either in decimal minutes or decimal seconds (defaults to decimal minutes)
                        bug fix in add point button
                        saveall button on mac now has error control
    Modified (v1.21): Samuel LeBlanc, Sao Tomé, 2017-08-16         
                        map plotting bug fixes, and Special Use Airspace (SUA) error mitigation. Bug fix when using 'save all' button
    Modified (v1.22): Samuel LeBlanc, 2019-06-03, Santa Cruz, CA
                        - Bug fixes for line picking and climb time calculations.
    Modified (v1.23): Samuel LeBlanc, 2019-08-05, Bathurst, NB, Canada
                        - added one line saving for pilots.
    Modified (v1.25): Samuel LeBlanc, 2021-04-08, Santa Cruz, CA
                        - added buttons for quick adding the IMPACTS "tropicaltidbits.com" imagery
	Modified (v1.28): Samuel LeBlanc, v1.28, 2021-11-08, Santa Cruz, CA  
						- bug fix for deletion points
	Modified (v1.29): Samuel LeBlanc, v1.29, 2022-01-11, Santa Cruz, CA
						- bug fix for saving multiple excel sheets
						- adding scroll to zoom 
						- adding custom color to labels.txt points
	Modified: Samuel LeBlanc, v1.30, 2022-02-03, Santa Cruz, CA
			- bug fix to for_pilots excel spreadsheet
	Modified: Samuel LeBlanc, v1.40, 2023-05-30, Santa Cruz, CA
			- added new projections
			- added new variables to the profiles.txt format
	Modified: Samuel LeBlanc, v1.41, 2023-06-08, Santa Cruz, CA
			- added surface elevation to elevation plots
			- added plotting of select kml files
			- added FIR boundaries plotting.
			- added the AERONET v3 debugging and defaults
			- modified plotting of satellite tracks for esthetics
	Modified: Samuel LeBlanc, v1.42, 2023-07-20, Santa Cruz, CA 
			- added support for the MSWMS from MSS
			- added extra selections options for the WMS loading.
	Modified: Samuel LeBlanc, v1.43, 2023-07-27, Hampton, VA 
			- bugfix for Mac OS laoding of files, and pkl map files.
	Modified: Samuel LeBlanc, v1.44, 2023-08-04, Snta Cruz, CA 
			- Adding the loading and compatibility with setuptools for pip integration and reglar python modules
    Modified: Samuel LeBlanc, v1.45, 2023-08-10, Santa Cruz, CA
                - Debugging and change of folder systems for pip install
    Modified: Samuel LeBlanc, v1.46, 2023-08-15, Santa Cruz, CA
                - Debugging for MACos and newer matplotlibs
				- Added conda deployment
    Modified: Samuel LeBlanc, v1.47, 2023-11-03, Santa Cruz, CA 
                - adding simple version output from command line (used for testing on conda deployments)
    Modified: Samuel LeBlanc, v1.48, 2024-02-22, Santa Cruz, CA
                - bug fix for forcing max speed, and base speed as start.
                - Added error handling during 'save all'
                - sped up interactivity and point adding
                - Added init time parsing for the MSS models in WMS.
                - upgraded plotting of figures under map for better viewing of text
                - added plot vs alt for all combined platforms and highlight of coordinated points
                - refined speed parameters for G3 and Learjet
	Modified: Samuel LeBlanc, v1.49, 2024-04-09, Santa Cruz, CA
                - bug fix for speeds of turns and timing
                - bug fix for missing comments
                - Added file format outputs in csv for FOREFLIGHT and UFP
	Modified: Samuel LeBlanc, v1.50, 2024-04-10, Santa Cruz, CA
				- general speedup of software
                - new pilot files bug fix for waypoint naming (only 5 digits) and lat/long flip
                - added file output for honeywell FMS for GIII
				- added better handling of satellite tracks defaulting to not visible for speed
                - speeded up interactions with changing labels update
				- added snapping to labeled points
				- added midpoint between 2 points
				- added waypoint name row in excel
			
# To cite:

Cite as:

Samuel LeBlanc and millercommamatt (2024) “samuelleblanc/fp: Moving Lines: Turn speed bug fix and new pilot formats”. (v1.49) Zenodo. doi: 10.5281/zenodo.10951716.

BibTex:
@misc{samuel_leblanc_2023_1478125,
author = {LeBlanc, Samuel},
doi = {10.5281/zenodo.1478125},
publisher = {Zenodo},
title = {{samuelleblanc/fp: Moving Lines: NASA airborne research flight planning tool release (v1.44)}},
url = {https://doi.org/10.5281/zenodo.1478125},
year = {2023}
}

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/samuelleblanc/fp",
    "name": "movinglines",
    "maintainer": "Samuel LeBlanc",
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": "samuel.leblanc@nasa.gov",
    "keywords": "ml",
    "author": "Samuel LeBlanc",
    "author_email": "samuel.leblanc@nasa.gov",
    "download_url": "https://files.pythonhosted.org/packages/db/51/9441fdc9bbebabd18e2b53545c1024b73f3df6c5782dbd8dd993f91667d5/movinglines-1.50.tar.gz",
    "platform": "any",
    "description": "# Name:\n\nMoving Lines, version 1.50\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1478125.svg)](https://doi.org/10.5281/zenodo.1478125)\n\n~~Get the compiled versions for MAC OS and Windows at:\n[https://github.com/samuelleblanc/fp/releases/tag/v1.44]~~   compiled versions not longer maintained, use conda install now (see below)\n    \n# Purpose:\n    \nFlight Planning software for creating flight plans for Airborne Science\n    \nCreates a visual map interface and backend calculations to a spreadsheet flight planning tool\nTakes advantage of clickable map for creating a flight plan, and already existing Excel software\n    \n# Install: \n\n## Install code from the anaconda package manager (recomended):\n1)  If you don't have a anaconda / miniconda / mamba install, please do so. Recommendation to install miniconda following this link [https://www.rho-signal-effective-analytics.com/modules/pre-course/miniconda-installation/].  \n    Ensure that the base environment is activated: `conda activate`  \n2)  From the command line, create a new environment based on python 3.9, activate it, then install the movinglines package (using mamba is faster than conda).\n\t```\n\tconda create -n ml python=3.9\n\tconda activate ml\n\tmamba install -c samuelleblanc movinglines\n\t```  \n   *for current conda/anaconda install, without mamba/miniconda/miniforge replace last line with*\n\t```\n\tconda install samuelleblanc::movinglines\n\t```    \n if you encounter errors with conda, ensure that you have the conda-froge channel in conda (it is automatic for mamba)\n\t```\n \tconda config --add channels conda-forge\n \t```    \n  \n3)  Go through and accept the install of the required packages\n4)  at the command line, start the lines software by typing `ml`\n\n   *or*\n\n## For compiled versions: **No longer Maintained**\n1) Download appropriate zip file and extract to desired location\n2) run the executable (ml for OSX, ml.exe for Win)\n        for OSX:\n            - ~~run from command line, must cd to directory hosting the ml exectuable~~\n            - executable version of OSX is being phased out, please use the conda install method above\n        for Windows:\n            - double click the ml.exe icon  \n\n   *or*  \n## For python installs:\n1) `pip install movinglines`\n2) at a command line, start the moving lines software by typing `ml`  \n\t\n# Quick Start: \n    1) Select the mapping profile (defaults to ORACLES), can change the map boundaries, take-off time, utc offset\n    2) wait about 30seconds\n    3) Enter date of planned flight in dialog in format yyyy-mm-dd\n    4) wait for map to initialize and excel to load\n\t5) move cursor over map to refresh map\n    6) create points, move points by clicking, or by manually entering in excel spreadsheet\n    7) Once happy save all the figures, files, excel files, kml files by either selecting each point, or by pressing the 'saveall' button\n    \n## Adding points:\n    1) click and drag on map to create new point \n    2) modify altitudes, speed, or other properties of new point in excel spreadsheet\n  *or*\n  \n    1) enter lat and lon in excel spreadsheet, optionally altitude and speed, delay time, start time\n    2) move cursor over map area to refresh *or* press green refresh button\n  *or*\n  \n    1) Press the 'add' button next to 'points:'\n    2) Follow the dialog\n  *or*\n\t\n\t1) add a flight module with the button 'flt_module'\n\t2) see below or follow dialogs\n    \n## Moving points\n    1) Click on point on map, and then drag\n*or*\n    \n    1) change coordinates in Excel spreadsheet\n    2) move cursor over map area to refresh\n*or*\n\n    1) Use the 'Move' button and select points to move, then follow dialog\n    \n## Delete points\n    1) delete line from the excel spreadsheet\n    2) move cursor over map to refresh\n    \n## Use flt modules for prepared flight plans (similarly to macros)\n    1) Select button: 'Add flt module'\n    2) select the flt module from the radiobutton list\n    3) enter the quantities demanded from the flt file\n    \n## Creating a flt module (or macro)\n    1) in the flt_module folder create a text file\n    2) the text file name should be descriptive of the macro with an extension '.flt'\n    3) first line starts with the percent sign '%' then a list of variables to be used\n    4) Comments can be included, but only at the start of the line, denoted with a hash '#' sign\n    5) each subsequent line is a move command, which can use simple math and the variables defined in the first line\n    6) format of the lines are: bearing,distance,altitude\n        where the bearing is the azimuth angle of the plane\n        where the distance is the length of that leg\n        where the altitude (which can be omitted) is the altitude of the plane for the next waypoint\n    7) enter number of points desired for macro then save in the flt_module directory. It is ready to be used in the software without the need for a restart.\n    8) if desired, make a screenshot of the resulting flt_module and save it with the same name in the flt_module folder as a .png\n    \n## Adding other planes or flight paths:\n    1) Press the 'New Flight Path' button\n    2) Enter name of new flight path. If it contains the name of a plane (e.g. p3, er2, dc8, c130,baer), will use the predefined speeds for that plane\n    3) New flight path will have different color\n\n## Adding figures and model maps:\n\t1) select add WMS\n\t2) choose which website to load the web map service. For MSS select that one which has the corresponding title\n\t3) follow dialogs for selecting the right times, layer, level, etc.\n    \n## Adding platform default information:\n    1) locate the platform.txt file.\n    2) in the file, there is a series of python dict formats with each a defined list of variables that sets the flight characteristics of the plane/platform\n    3) modify exisiting pltform dict, or create a new one based on the template and the guidance shown in the file.\n    \n## Change which flight path is active:\n    1) Press the button related to the flight path desired just above the 'New Flight Path' button\n**do not switch with Excel Spreadsheet**\n    \n## Move, zoom the map around:\n    1) Buttons at the bottom of the map are used for navigation\n    2) from left to right: Home screen (first image seen), Previous view, Next view, Pan, Zoom, subplots properties, save map\n\t3) Can use the scroll in to zoom into point, or scroll out.\n**If zoom is selected, draw rectangle to desired location, will not be able to make new points until zoom unselected**\n    \n## Saving flight paths for sharing\n    1) Press the 'Save all' button to create all figures and save them\n    2) Follow dialog to find the desired saving location\n    \n## Opening previously saved flight plans:\n    1) Press the Excel File: 'Open' button. \n    2) select the Excel file\n    3) will take some time to populate the flight paths\n    4) Might need to press refresh button after loading\n    \n## Save flight plans:\n    1) Press the 'Save' button next to Excel File\n*or*\n\n    1) Save the Excel file, from Excel using normal dialog\n    \n## Change definitions of platform speeds, and altitudes\n    1) open the platform.txt file\n    2) follow the documentation in the header for creating or modifying any line defining the platform\n    3) save the file as platform.txt and share\n    4) put the new platform.txt in the sam folder as the ml.py script or ml executable\n    \n# Notes and tips about usage:\n\n    - clicking on the first point will create a waypoint to it\n    - second point to be added will have the default transit altitude for that aircraft (if available)\n    - when holding down the mouse button, range circles will appear, along with the sun's azimuthal location at that time denoted by the yellow star and dashed lines\n    - Saving to: ICT button will create a sample ict file with 60 seconds points interpolated between each waypoint\n    - plots of solar angle and altitude profiles is created with the Plots buttons\n    \n# Requirements:\n\n## Windows:\n        - compiled version run windows 64 bit, (32 bit not tested) (Windows 7,8,10)\n        - Microsoft Excel\n        - optionally Google Earth\n    \n## OSX:\n        - compiled version tested on El Capitan Mac OSX v10.11, 64bit (others not tested)\n        - Microsoft Excel\n        - optionally Google Earth\n    \n## source:\n        - Python 3.9\n        - Numpy\n        - Scipy\n        - matplotlib\n        - ~~basemap from matplotlib (http://matplotlib.org/basemap/)~~ cartopy\n        - Tkinter (usually included in python)\n        - simplekml, pykml\n        - gpxpy\n        - owslib\n        - xlwings\n        - Pysolar (distributed with source)\n        - See requirements.txt for full modules dependencies\n        \n# Required files (included in distribution):\n\n    - labels.txt : csv files with points on map to be labelled. Each line represent one point, Format: name, longitude, latitude, marker and color symbol\n    - aeronet_locations.txt: csv files with location of aeronet sites. found from : http://aeronet.gsfc.nasa.gov/aeronet_locations.txt\n    - sat.tle: Selected data for satellite tracks in form of Two Line Element set from http://www.celestrak.com\n    - profiles.txt: text file containing dictionary assignment for map setup defaults. each profile linked to a field mission, python dict format.\n    - platform.txt: text file containing dictionary assignment for details on each platform: max altitude, max speed, speed profile, vertical speed profile, turning rate\n    - WMS.txt: list of possible WMS servers for getting map images from the internet.\n    - arc.ico: icon file\n    - file.rc: plotting defaults file (python matplotlib.rc format)\n    - map_icons: folder with icons for use on google earth (optional)\n    - flt_modules: folder with multiple flt files. To use when creating the flt_module paths. \n    - ~~map_???.pkl: files to enable faster initial loading of the basemap~~\n    \n# Source files:\n\n    - ml.py : Main program. Used to setup the interface, link to the excel spreadsheet and start the program\n    - map_interactive.py: Basemap plotting and interactive map clicking support\n    - excel_interface.py: interfaces with Excel, Core of the calculations, *contains speed and altitude calculations*\n    - gui.py: Handling the button events and functions. Has the saving routines interfaces\n    - map_utils.py: various map utilities, like bearing calculations, great circle calculations\n    - write_utils.py: writing utitlies, expecially for ICT file creation\n    - load_utils.py: loading of various format utilities and conversion of input formats\n    - aeronet.py: loading and presenting the aeronet real time AOD on the map\n\n# To do/wish list:\n\n    - add platform info button next to flight paths (to change its settings)\n    - add ship tracks, or position of ships\n    - add capabilities to load hdf files and put contour as background\n    - add remove flight button\n\n# Known Bugs:\n\n    - Sometime slow starting up, especiallly when excel is not open \n\t- Adding figures when not in platecaree / cylindrical / mercator projections is buggy\n    \n# Modification History:\n\n    Written: Samuel LeBlanc, 2015-08-07, at NASA Ames Research Center, from Santa Cruz, CA\n                Copyright 2015 Samuel LeBlanc \n    Modified (v0.7b): Samuel LeBlanc, NASA Ames, 2015-09-06\n                       Initial presentation of software. Added smooth dragging and some calculations, with image overlay\n    Modified (v0.8b): Samuel LeBlanc, NASA Ames, 2016-06-15\n                       Corrected speed trace. \n                       Added sun position calculations\n                       Modified some gui placement\n                       Added ICT file creation, and save all button\n    Modified (v0.9b): Samuel LeBlanc, NASA Ames, 2016-06-22\n                       Added flt_module command for creating parts of flights via macros\n    Modified (v0.95b): Samuel LeBlanc, NASA Ames, in transit to WFF, 2016-07-11\n                       Added platform information file to facilitate modification of\n                        default platform parameters (cruising altitude, speed profile, climb time, turning rate)\n                       Added button to remove the satellite tracks\n                       updated the sat.tle file \n                       bug fix for recognizing platform after excel file load, tried to fix bug in altitude and speed calculations\n                       Added selections for altitude in feet/meter and distance in nm/km for flt_module loading.\n    Modified (v0.97b): Samuel LeBlanc, NASA Ames, at Santa Cruz, CA, 2016-07-18\n                       bug fix for improper parallels and meridians drawing. \n                       Some speed improvements\n                       updated aeronet site locations and sat.tle satellite predictions and icon\n    Modified (v1.00): Samuel LeBlanc, NASA Ames, CA, 2016-07-22\n                       bug fix to sza and azimuth calculations\n                       bug fix to aircraft bearing calculations\n                       new icons and kmz saving\n                       new modes for WMS loading with GEOS and other\n                       extracted definitions of platform speeds and altitude to a seperate file\n    Modified (v1.03): Samuel LeBlanc, NASA Ames, CA, 2016-07-22\n                       bug fix to excel file loading and improper time zone correction\n                       new Special Use Airspace button\n                       generalized WMS interface for loading maps from the internet\n                       special excel spreadsheet fiel saving for pilots \n    Modified (v1.1): Samuel LeBlanc, NASA \n                       bug fixes to presentation and file saving\n                       faster updating of the map screen and draggable legend\n                       User modifiable default aircraft propeties (platform.txt) and map properties (profiles.txt)\n                       Included loading of special map severs (special use airspace, WMS, GEOS)\n    Modified (v1.2): Samuel LeBlanc, Sao Tom\u00e9, 2017-08-16\n                        for_pilots spreadsheet now can be configured to save either in decimal minutes or decimal seconds (defaults to decimal minutes)\n                        bug fix in add point button\n                        saveall button on mac now has error control\n    Modified (v1.21): Samuel LeBlanc, Sao Tom\u00e9, 2017-08-16         \n                        map plotting bug fixes, and Special Use Airspace (SUA) error mitigation. Bug fix when using 'save all' button\n    Modified (v1.22): Samuel LeBlanc, 2019-06-03, Santa Cruz, CA\n                        - Bug fixes for line picking and climb time calculations.\n    Modified (v1.23): Samuel LeBlanc, 2019-08-05, Bathurst, NB, Canada\n                        - added one line saving for pilots.\n    Modified (v1.25): Samuel LeBlanc, 2021-04-08, Santa Cruz, CA\n                        - added buttons for quick adding the IMPACTS \"tropicaltidbits.com\" imagery\n\tModified (v1.28): Samuel LeBlanc, v1.28, 2021-11-08, Santa Cruz, CA  \n\t\t\t\t\t\t- bug fix for deletion points\n\tModified (v1.29): Samuel LeBlanc, v1.29, 2022-01-11, Santa Cruz, CA\n\t\t\t\t\t\t- bug fix for saving multiple excel sheets\n\t\t\t\t\t\t- adding scroll to zoom \n\t\t\t\t\t\t- adding custom color to labels.txt points\n\tModified: Samuel LeBlanc, v1.30, 2022-02-03, Santa Cruz, CA\n\t\t\t- bug fix to for_pilots excel spreadsheet\n\tModified: Samuel LeBlanc, v1.40, 2023-05-30, Santa Cruz, CA\n\t\t\t- added new projections\n\t\t\t- added new variables to the profiles.txt format\n\tModified: Samuel LeBlanc, v1.41, 2023-06-08, Santa Cruz, CA\n\t\t\t- added surface elevation to elevation plots\n\t\t\t- added plotting of select kml files\n\t\t\t- added FIR boundaries plotting.\n\t\t\t- added the AERONET v3 debugging and defaults\n\t\t\t- modified plotting of satellite tracks for esthetics\n\tModified: Samuel LeBlanc, v1.42, 2023-07-20, Santa Cruz, CA \n\t\t\t- added support for the MSWMS from MSS\n\t\t\t- added extra selections options for the WMS loading.\n\tModified: Samuel LeBlanc, v1.43, 2023-07-27, Hampton, VA \n\t\t\t- bugfix for Mac OS laoding of files, and pkl map files.\n\tModified: Samuel LeBlanc, v1.44, 2023-08-04, Snta Cruz, CA \n\t\t\t- Adding the loading and compatibility with setuptools for pip integration and reglar python modules\n    Modified: Samuel LeBlanc, v1.45, 2023-08-10, Santa Cruz, CA\n                - Debugging and change of folder systems for pip install\n    Modified: Samuel LeBlanc, v1.46, 2023-08-15, Santa Cruz, CA\n                - Debugging for MACos and newer matplotlibs\n\t\t\t\t- Added conda deployment\n    Modified: Samuel LeBlanc, v1.47, 2023-11-03, Santa Cruz, CA \n                - adding simple version output from command line (used for testing on conda deployments)\n    Modified: Samuel LeBlanc, v1.48, 2024-02-22, Santa Cruz, CA\n                - bug fix for forcing max speed, and base speed as start.\n                - Added error handling during 'save all'\n                - sped up interactivity and point adding\n                - Added init time parsing for the MSS models in WMS.\n                - upgraded plotting of figures under map for better viewing of text\n                - added plot vs alt for all combined platforms and highlight of coordinated points\n                - refined speed parameters for G3 and Learjet\n\tModified: Samuel LeBlanc, v1.49, 2024-04-09, Santa Cruz, CA\n                - bug fix for speeds of turns and timing\n                - bug fix for missing comments\n                - Added file format outputs in csv for FOREFLIGHT and UFP\n\tModified: Samuel LeBlanc, v1.50, 2024-04-10, Santa Cruz, CA\n\t\t\t\t- general speedup of software\n                - new pilot files bug fix for waypoint naming (only 5 digits) and lat/long flip\n                - added file output for honeywell FMS for GIII\n\t\t\t\t- added better handling of satellite tracks defaulting to not visible for speed\n                - speeded up interactions with changing labels update\n\t\t\t\t- added snapping to labeled points\n\t\t\t\t- added midpoint between 2 points\n\t\t\t\t- added waypoint name row in excel\n\t\t\t\n# To cite:\n\nCite as:\n\nSamuel LeBlanc and millercommamatt (2024) \u201csamuelleblanc/fp: Moving Lines: Turn speed bug fix and new pilot formats\u201d. (v1.49) Zenodo. doi: 10.5281/zenodo.10951716.\n\nBibTex:\n@misc{samuel_leblanc_2023_1478125,\nauthor = {LeBlanc, Samuel},\ndoi = {10.5281/zenodo.1478125},\npublisher = {Zenodo},\ntitle = {{samuelleblanc/fp: Moving Lines: NASA airborne research flight planning tool release (v1.44)}},\nurl = {https://doi.org/10.5281/zenodo.1478125},\nyear = {2023}\n}\n",
    "bugtrack_url": null,
    "license": "GPL-3.0",
    "summary": "Moving Lines - Research flight planner",
    "version": "1.50",
    "project_urls": {
        "Homepage": "https://github.com/samuelleblanc/fp"
    },
    "split_keywords": [
        "ml"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "db519441fdc9bbebabd18e2b53545c1024b73f3df6c5782dbd8dd993f91667d5",
                "md5": "f03606e2724f77261ddcb6661378b815",
                "sha256": "fad51560b8d62d55131cfc3b0496bece4a8f8defdd7a32a1782a54b5199ea740"
            },
            "downloads": -1,
            "filename": "movinglines-1.50.tar.gz",
            "has_sig": false,
            "md5_digest": "f03606e2724f77261ddcb6661378b815",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 6823436,
            "upload_time": "2024-04-13T07:41:19",
            "upload_time_iso_8601": "2024-04-13T07:41:19.680676Z",
            "url": "https://files.pythonhosted.org/packages/db/51/9441fdc9bbebabd18e2b53545c1024b73f3df6c5782dbd8dd993f91667d5/movinglines-1.50.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-13 07:41:19",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "samuelleblanc",
    "github_project": "fp",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "movinglines"
}
        
Elapsed time: 0.23934s