Main class of the Solar System Editor plug-in which allows editing (add, delete, update) of the minor bodies. More...

#include <SolarSystemEditor.hpp>

Public Types
enum	UpdateFlag { UpdateNameAndNumber = 0x01, UpdateType = 0x02, UpdateOrbitalElements = 0x04, UpdateMagnitudeParameters = 0x08 }
	Flags to control the updateSolarSystemConfigurationFile() function. More...

Public Types inherited from StelModule
enum	StelModuleSelectAction { AddToSelection, ReplaceSelection, RemoveFromSelection }
	Enum used when selecting objects to define whether to add to, replace, or remove from the existing selection list. More...

enum	StelModuleActionName { ActionDraw, ActionUpdate, ActionHandleMouseClicks, ActionHandleMouseMoves, ActionHandleKeys }
	Define the possible action for which an order is defined. More...

Public Slots
void	resetSolarSystemToDefault ()
	Resets the Solar System configuration file and reloads the Solar System. More...

Signals
void	solarSystemChanged ()

Public Member Functions
virtual void	init ()
	called when the plug-in is loaded. More...

virtual void	deinit ()
	called before the plug-in is un-loaded. More...

virtual void	update (double deltaTime)
	Does nothing.

virtual void	draw (StelCore *core)
	draws on the view port. More...

virtual double	getCallOrder (StelModuleActionName actionName) const
	Return the value defining the order of call for the given action For example if stars.callOrder[ActionDraw] == 10 and constellation.callOrder[ActionDraw] == 11, the stars module will be drawn before the constellations. More...

virtual bool	configureGui (bool show)
	called when the "configure" button in the "Plugins" tab is pressed

SsoElements	readMpcOneLineCometElements (QString oneLineElements) const
	Reads a single comet's orbital elements from a string. More...

SsoElements	readMpcOneLineMinorPlanetElements (QString oneLineElements) const
	Reads a single minor planet's orbital elements from a string. More...

QList< SsoElements >	readMpcOneLineCometElementsFromFile (QString filePath) const
	Reads a list of comet orbital elements from a file. More...

QList< SsoElements >	readMpcOneLineMinorPlanetElementsFromFile (QString filePath) const
	Reads a list of minor planet orbital elements from a file. More...

bool	appendToSolarSystemConfigurationFile (SsoElements object)
	Adds a new entry at the end of the user solar system configuration file. More...

bool	appendToSolarSystemConfigurationFile (QList< SsoElements >)
	Adds new entries at the end of the user solar system configuration file. More...

bool	updateSolarSystemConfigurationFile (QList< SsoElements > objects, UpdateFlags flags)
	Updates entries in the user solar system configuration file. More...

QHash< QString, QString >	getDefaultSsoIdentifiers () const
	Returns the names of the objects listed in the default ssystem_major.ini. More...

QHash< QString, QString >	listAllLoadedSsoIdentifiers () const
	Lists the objects listed in the current user ssystem.ini. More...

bool	removeSsoWithName (QString name)
	Removes an object from the user Solar System configuration file. More...

bool	copySolarSystemConfigurationFileTo (QString filePath)
	Export current minor bodies file from user data directory (if it exists) to filePath. Return true on success.

bool	replaceSolarSystemConfigurationFileWith (QString filePath)
	Replace current minor bodies file in the user data directory. More...

bool	addFromSolarSystemConfigurationFile (QString filePath)
	(new 0.16) Loads all new objects from filePath (an .ini file). More...

QString	getCustomSolarSystemFilePath () const
	returns the path

Public Member Functions inherited from StelModule
virtual QString	getModuleVersion () const
	Get the version of the module, default is stellarium main version.

virtual QString	getAuthorName () const
	Get the name of the module author.

virtual QString	getAuthorEmail () const
	Get the email adress of the module author.

virtual void	handleMouseClicks (class QMouseEvent *)
	Handle mouse clicks. More...

virtual void	handleMouseWheel (class QWheelEvent *)
	Handle mouse wheel. More...

virtual bool	handleMouseMoves (int x, int y, Qt::MouseButtons b)
	Handle mouse moves. More...

virtual void	handleKeys (class QKeyEvent *e)
	Handle key events. More...

virtual bool	handlePinch (qreal scale, bool started)
	Handle pinch gesture events. More...

Additional Inherited Members
Protected Member Functions inherited from StelModule
class StelAction *	addAction (const QString &id, const QString &groupId, const QString &text, QObject target, const char slot, const QString &shortcut="", const QString &altShortcut="")
	convenience methods to add an action (call to slot) to the StelActionMgr object. More...

class StelAction *	addAction (const QString &id, const QString &groupId, const QString &text, const char *slot, const QString &shortcut="", const QString &altShortcut="")
	convenience methods to add an action (call to own slot) to the StelActionMgr object. More...

Detailed Description

Author: Bogdan Marinov, Georg Zotti (0.16 changes)

Solar System bodies are identified by their names in Stellarium, but entries in the configuration file are identified by their group (section) names. This makes the detection of duplicates more difficult.

Member Enumeration Documentation

◆ UpdateFlag

enum SolarSystemEditor::UpdateFlag

Enumerator
UpdateNameAndNumber	Update the name and minor planet number, if any.
UpdateType	Update objects that lack the "type" parameter.
UpdateOrbitalElements	Update the orbital elements, including the orbit function.
UpdateMagnitudeParameters	Update the values in the two parameter system, or add them if they are missing and the type allows.

Member Function Documentation

◆ addFromSolarSystemConfigurationFile()

bool SolarSystemEditor::addFromSolarSystemConfigurationFile ( QString filePath )

Default proposal is ssystem_1000comsts.ini in the installation dir.

◆ appendToSolarSystemConfigurationFile() [1/2]

bool SolarSystemEditor::appendToSolarSystemConfigurationFile ( SsoElements object )

This function writes directly to the file. See the note on why QSettings was not used in the description of appendToSolarSystemConfigurationFile(QList<SsoElements>) Duplicates are removed: If any section in the file matches the "section_name" value of the inserted entry, it is removed.

◆ appendToSolarSystemConfigurationFile() [2/2]

bool SolarSystemEditor::appendToSolarSystemConfigurationFile ( QList< SsoElements > )

This function writes directly to the file. QSettings was not used, as:

Using QSettings with QSettings::IniFormat causes the list in the "color" field (e.g. "1.0, 1.0, 1.0") to be wrapped in double quotation marks (Stellarium requires no quotation marks). (Has been fixed by using StelIniFormat)
Using QSettings with StelIniFormat causes unaccepptable append times when the file grows (>~40 entries). This most probably happens because StelIniParser uses QMap internally for the entry list. QMap orders its keys (in the case of strings - alphabetically) and it has to find the appropriate place in the ordering for every new key, which takes more and more time as the list grows. (0.16pre: This problem seems to have been solved: I (GZ) have changed this plugin to use StelIniParser, and loading 1000comets takes about 4 seconds. This is very acceptable, and avoids tons of problems with the default QSettings::IniFormat)

Duplicates are removed: If any section in the file matches the "section_name" value of a new entry, it is removed. Invalid entries in the list (that don't contain a value for "section_name" or it is an empty string) are skipped and the processing continues from the next entry.

◆ deinit()

virtual void SolarSystemEditor::deinit ( )

inlinevirtual

Useful for stopping processes, unloading textures, etc.

Reimplemented from StelModule.

◆ draw()

virtual void SolarSystemEditor::draw ( StelCore * core )

inlinevirtual

Dialog windows don't need explicit drawing, it's done automatically.

Reimplemented from StelModule.

◆ getCallOrder()

virtual double SolarSystemEditor::getCallOrder ( StelModuleActionName actionName ) const

virtual

Parameters

actionName the name of the action for which we want the call order

Returns: the value defining the order. The closer to 0 the earlier the module's action will be called

Reimplemented from StelModule.

◆ getDefaultSsoIdentifiers()

QHash<QString,QString> SolarSystemEditor::getDefaultSsoIdentifiers ( ) const

inline

The default solar system configuration file is assumed to be the one in the installation directory.

◆ init()

virtual void SolarSystemEditor::init ( )

virtual

All initializations should be done here.

Implements StelModule.

◆ listAllLoadedSsoIdentifiers()

QHash<QString,QString> SolarSystemEditor::listAllLoadedSsoIdentifiers ( ) const

As the name suggests, the list is compiled when the function is run.

◆ readMpcOneLineCometElements()

SsoElements SolarSystemEditor::readMpcOneLineCometElements ( QString oneLineElements ) const

This function converts a line of comet orbital elements in MPC format to a hash in Stellarium's ssystem.ini format. The MPC's one-line orbital elements format for comets is described on their website: http://www.minorplanetcenter.org/iau/info/CometOrbitFormat.html

Returns: an empty hash if there is an error or the source string is not a valid line in MPC format.

◆ readMpcOneLineCometElementsFromFile()

QList<SsoElements> SolarSystemEditor::readMpcOneLineCometElementsFromFile ( QString filePath ) const

This function reads a list of comet orbital elements in MPC's one-line format from a file (one comet per line) and converts it to a list of hashes in Stellarium's ssystem.ini format. Example source file is the list of observable comets on the MPC's site: http://www.minorplanetcenter.org/iau/Ephemerides/Comets/Soft00Cmt.txt readMpcOneLineCometElements() is used internally to parse each line.

◆ readMpcOneLineMinorPlanetElements()

SsoElements SolarSystemEditor::readMpcOneLineMinorPlanetElements ( QString oneLineElements ) const

This function converts a line of minor planet orbital elements in MPC format to a hash in Stellarium's ssystem.ini format. The MPC's one-line orbital elements format for minor planets is described on their website: http://www.minorplanetcenter.org/iau/info/MPOrbitFormat.html

Returns: an empty hash if there is an error or the source string is not a valid line in MPC format.

◆ readMpcOneLineMinorPlanetElementsFromFile()

QList<SsoElements> SolarSystemEditor::readMpcOneLineMinorPlanetElementsFromFile ( QString filePath ) const

This function reads a list of minor planets orbital elements in MPC's one-line format from a file (one comet per line) and converts it to a list of hashes in Stellarium's ssystem.ini format. Example source file is the list of bright asteroids on the MPC's site: http://www.minorplanetcenter.org/iau/Ephemerides/Bright/2010/Soft00Bright.txt readMpcOneLineMinorPlanetElements() is used internally to parse each line.

◆ removeSsoWithName()

bool SolarSystemEditor::removeSsoWithName ( QString name )

Reloads the Solar System on successful removal.

name true name of the object ("name" parameter in the configuration file)
Returns
true if the entry has been removed successfully or there is no such entry

false if there was an error

◆ replaceSolarSystemConfigurationFileWith()

bool SolarSystemEditor::replaceSolarSystemConfigurationFileWith ( QString filePath )

Writes warning to logfile and returns false in case of problems.

◆ resetSolarSystemToDefault

void SolarSystemEditor::resetSolarSystemToDefault ( )

slot

◆ updateSolarSystemConfigurationFile()

bool SolarSystemEditor::updateSolarSystemConfigurationFile	(	QList< SsoElements >	objects,
		UpdateFlags	flags
	)

Parameters

objects	a list of data for already existing objects (non-existing ones are skipped);
flags	flags controlling what is being updated. See UpdateFlag.

Returns: false if the operation has failed completely for some reason.

Public Types

Public Slots

Signals

Public Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ UpdateFlag

Member Function Documentation

◆ addFromSolarSystemConfigurationFile()

◆ appendToSolarSystemConfigurationFile() [1/2]

◆ appendToSolarSystemConfigurationFile() [2/2]

◆ deinit()

◆ draw()

◆ getCallOrder()

◆ getDefaultSsoIdentifiers()

◆ init()

◆ listAllLoadedSsoIdentifiers()

◆ readMpcOneLineCometElements()

◆ readMpcOneLineCometElementsFromFile()

◆ readMpcOneLineMinorPlanetElements()

◆ readMpcOneLineMinorPlanetElementsFromFile()

◆ removeSsoWithName()

◆ replaceSolarSystemConfigurationFileWith()

◆ resetSolarSystemToDefault

◆ updateSolarSystemConfigurationFile()