Description

A user defined data loader. This is a thin wrapper around the real loader implementation, storing the relevant settings to make it user definable (namely name and import settings).

Definition at line 23 of file UserDefinedDataLoader1D.h.

Inheritance diagram for UserDefinedDataLoader1D:

[legend]

Collaboration diagram for UserDefinedDataLoader1D:

[legend]

Signals
void	contentsProcessed ()
	Emitted whenever contents have been processed. More...

void	importSettingsChanged ()
	Emitted whenever an import setting changed. More...

Public Member Functions
	UserDefinedDataLoader1D (AbstractDataLoader1D *wrappedLoader, QString name, QByteArray defaultProperties)

virtual void	applyImportSettings ()
	Read all values from the properties UI into the internal variables. More...

AbstractDataLoader *	clone () const override
	Create a complete clone, including all internal states. More...

virtual AbstractDataLoaderResultModel *	createResultModel () const
	Create a table model which contains the import information like original file content, raw content, processed content. The returned pointer will be owned by the caller. This base class' implementation does nothing (return nullptr). More...

virtual QByteArray	defaultImportSettings () const
	Return the default import settings. More...

void	deserialize (const QByteArray &data) override
	Initialize from serialization data. If any error occurred, then a DeserializationException has to be thrown. The complete state has to be restored. Therefore if e.g. errors occurred in the former serialization, but errors are not serialized, then they have to be regenerated/ recalculated in here. More...

virtual QByteArray	fileContent () const
	Returns the original file content. If not available any more (like for legacy project file import), then an empty array will be returned. More...

void	guessSettings () override
	Guess appropriate settings (for example the separator in a CSV file). Is called only once, directly after setting the file content. More...

void	initWithDefaultImportSettings () override
	Set import settings to defaults. More...

virtual QStringList	lineUnrelatedErrors () const
	Errors not related to a particular line. More...

QString	name () const override
	The name shown in the format selection combo. More...

virtual int	numErrors () const
	Number of errors found while processing the content. An error means that either a particular content (line) can't be used or may be suspicious (line related error), or that the whole content can't be used (e.g. only 1 line present). More...

virtual int	numLineRelatedErrors () const
	Number of errors related to a specific line. Such an error means that a particular content (line) can't be used or may be suspicious. More...

QString	persistentClassName () const override
	A name which can be used for save/load purposes (which will not change ever more) More...

void	populateImportSettingsWidget (QWidget *parent) override
	Fills the widget on the import dialog pane. The implementation here in the base class does nothing (meaning "no editable properties"). More...

void	processContents () override
	Process the file contents. Can be called more than once, e.g. if the import settings have changed. Any error has to be stored in the loader (see numErrors()). More...

RealDataItem *	realDataItem ()
	The real data item on which the import shall work. More...

const RealDataItem *	realDataItem () const
	The real data item on which the import shall work. More...

QByteArray	serialize () const override
	Returns every internal setting so it can be restored completely. More...

void	setFileContents (const QByteArray &fileContent) override
	Sets the file contents to be imported. If the file was a compressed file, then the decompressed content will be handed over already here. More...

void	setRealDataItem (RealDataItem *item)
	Define the real data item on which the import shall work. More...

Protected Attributes
RealDataItem *	m_item
	The real-data-item which owns this loader. Never delete this! More...

Private Attributes
QByteArray	m_defaultProperties

QString	m_name

AbstractDataLoader1D *	m_wrappedLoader

Constructor & Destructor Documentation

◆ UserDefinedDataLoader1D()

UserDefinedDataLoader1D::UserDefinedDataLoader1D	(	AbstractDataLoader1D *	wrappedLoader,
		QString	name,
		QByteArray	defaultProperties
	)

Definition at line 19 of file UserDefinedDataLoader1D.cpp.

     : m_name(std::move(name))
     , m_wrappedLoader(wrappedLoader)
     , m_defaultProperties(std::move(defaultProperties))
 {
     connect(m_wrappedLoader, &AbstractDataLoader1D::importSettingsChanged, this,
             &AbstractDataLoader1D::importSettingsChanged);
 }

References AbstractDataLoader::importSettingsChanged(), and m_wrappedLoader.

Referenced by clone().

Member Function Documentation

◆ applyImportSettings()

void AbstractDataLoader::applyImportSettings ( )

virtualinherited

Read all values from the properties UI into the internal variables.

Reimplemented in QREDataLoader.

Definition at line 20 of file AbstractDataLoader.cpp.

20 {}

Referenced by cloneAsUserDefinedLoader(), and SpecularDataImportWidget::onPropertiesChanged().

◆ clone()

AbstractDataLoader * UserDefinedDataLoader1D::clone ( ) const

overridevirtual

Create a complete clone, including all internal states.

Implements AbstractDataLoader.

Definition at line 59 of file UserDefinedDataLoader1D.cpp.

 {
     auto* cloned = dynamic_cast<AbstractDataLoader1D*>(m_wrappedLoader->clone());
     auto* loader = new UserDefinedDataLoader1D(cloned, m_name, m_defaultProperties);
     return loader;
 }

References UserDefinedDataLoader1D(), AbstractDataLoader::clone(), m_defaultProperties, m_name, and m_wrappedLoader.

Here is the call graph for this function:

◆ contentsProcessed

void AbstractDataLoader::contentsProcessed ( )

signalinherited

Emitted whenever contents have been processed.

Referenced by AutomaticDataLoader1D::processContents(), QREDataLoader::processContents(), and RealDataItem::setDataLoader().

◆ createResultModel()

AbstractDataLoaderResultModel * AbstractDataLoader::createResultModel ( ) const

virtualinherited

Create a table model which contains the import information like original file content, raw content, processed content. The returned pointer will be owned by the caller. This base class' implementation does nothing (return nullptr).

Reimplemented in QREDataLoader, and AutomaticDataLoader1D.

Definition at line 55 of file AbstractDataLoader.cpp.

 {
     return nullptr;
 }

Referenced by SpecularDataImportWidget::updatePreview().

◆ defaultImportSettings()

QByteArray AbstractDataLoader::defaultImportSettings ( ) const

virtualinherited

Return the default import settings.

Definition at line 31 of file AbstractDataLoader.cpp.

 {
     std::unique_ptr<AbstractDataLoader> cloned(clone());
     cloned->initWithDefaultImportSettings();
     return cloned->serialize();
 }

References AbstractDataLoader::clone().

Here is the call graph for this function:

◆ deserialize()

void UserDefinedDataLoader1D::deserialize ( const QByteArray & data )

overridevirtual

Initialize from serialization data. If any error occurred, then a DeserializationException has to be thrown. The complete state has to be restored. Therefore if e.g. errors occurred in the former serialization, but errors are not serialized, then they have to be regenerated/ recalculated in here.

Reimplemented from AbstractDataLoader.

Definition at line 54 of file UserDefinedDataLoader1D.cpp.

 {
     m_wrappedLoader->deserialize(data);
 }

References AbstractDataLoader::deserialize(), and m_wrappedLoader.

Referenced by initWithDefaultImportSettings().

Here is the call graph for this function:

◆ fileContent()

QByteArray AbstractDataLoader::fileContent ( ) const

virtualinherited

Returns the original file content. If not available any more (like for legacy project file import), then an empty array will be returned.

Reimplemented in QREDataLoader, and AutomaticDataLoader1D.

Definition at line 60 of file AbstractDataLoader.cpp.

 {
     return {};
 }

Referenced by SpecularDataImportWidget::onFormatSelectionChanged(), and setFileContents().

◆ guessSettings()

void UserDefinedDataLoader1D::guessSettings ( )

overridevirtual

Guess appropriate settings (for example the separator in a CSV file). Is called only once, directly after setting the file content.

Reimplemented from AbstractDataLoader.

Definition at line 71 of file UserDefinedDataLoader1D.cpp.

 {
     m_wrappedLoader->guessSettings();
 }

References AbstractDataLoader::guessSettings(), and m_wrappedLoader.

Here is the call graph for this function:

◆ importSettingsChanged

void AbstractDataLoader::importSettingsChanged ( )

signalinherited

Emitted whenever an import setting changed.

Referenced by UserDefinedDataLoader1D(), SpecularDataImportWidget::onFormatSelectionChanged(), QREDataLoader::populateImportSettingsWidget(), and SpecularDataImportWidget::setItem().

◆ initWithDefaultImportSettings()

void UserDefinedDataLoader1D::initWithDefaultImportSettings ( )

overridevirtual

Set import settings to defaults.

Reimplemented from AbstractDataLoader.

Definition at line 39 of file UserDefinedDataLoader1D.cpp.

 {
     deserialize(m_defaultProperties);
 }

References deserialize(), and m_defaultProperties.

Here is the call graph for this function:

◆ lineUnrelatedErrors()

QStringList AbstractDataLoader::lineUnrelatedErrors ( ) const

virtualinherited

Errors not related to a particular line.

Reimplemented in QREDataLoader, and AutomaticDataLoader1D.

Definition at line 50 of file AbstractDataLoader.cpp.

 {
     return {};
 }

Referenced by SpecularDataImportWidget::updatePreview().

◆ name()

QString UserDefinedDataLoader1D::name ( ) const

overridevirtual

The name shown in the format selection combo.

Implements AbstractDataLoader.

Definition at line 29 of file UserDefinedDataLoader1D.cpp.

 {
     return m_name;
 }

References m_name.

◆ numErrors()

int AbstractDataLoader::numErrors ( ) const

virtualinherited

Number of errors found while processing the content. An error means that either a particular content (line) can't be used or may be suspicious (line related error), or that the whole content can't be used (e.g. only 1 line present).

Reimplemented in QREDataLoader, and AutomaticDataLoader1D.

Definition at line 40 of file AbstractDataLoader.cpp.

 {
     return 0;
 }

Referenced by RealDataItem::hasImportErrors(), and SpecularDataImportWidget::updatePreview().

◆ numLineRelatedErrors()

int AbstractDataLoader::numLineRelatedErrors ( ) const

virtualinherited

Number of errors related to a specific line. Such an error means that a particular content (line) can't be used or may be suspicious.

Reimplemented in QREDataLoader.

Definition at line 45 of file AbstractDataLoader.cpp.

 {
     return 0;
 }

◆ persistentClassName()

QString UserDefinedDataLoader1D::persistentClassName ( ) const

overridevirtual

A name which can be used for save/load purposes (which will not change ever more)

Implements AbstractDataLoader.

Definition at line 44 of file UserDefinedDataLoader1D.cpp.

 {
     return m_wrappedLoader->persistentClassName();
 }

References m_wrappedLoader, and AbstractDataLoader::persistentClassName().

Here is the call graph for this function:

◆ populateImportSettingsWidget()

void UserDefinedDataLoader1D::populateImportSettingsWidget ( QWidget * parent )

overridevirtual

Fills the widget on the import dialog pane. The implementation here in the base class does nothing (meaning "no editable properties").

Reimplemented from AbstractDataLoader.

Definition at line 34 of file UserDefinedDataLoader1D.cpp.

 {
     m_wrappedLoader->populateImportSettingsWidget(parent);
 }

References m_wrappedLoader, and AbstractDataLoader::populateImportSettingsWidget().

Here is the call graph for this function:

◆ processContents()

void UserDefinedDataLoader1D::processContents ( )

overridevirtual

Process the file contents. Can be called more than once, e.g. if the import settings have changed. Any error has to be stored in the loader (see numErrors()).

Implements AbstractDataLoader.

Definition at line 76 of file UserDefinedDataLoader1D.cpp.

 {
     m_wrappedLoader->processContents();
 }

References m_wrappedLoader, and AbstractDataLoader::processContents().

Here is the call graph for this function:

◆ realDataItem() [1/2]

RealDataItem * AbstractDataLoader::realDataItem ( )

inherited

The real data item on which the import shall work.

Definition at line 70 of file AbstractDataLoader.cpp.

 {
     return m_item;
 }

References AbstractDataLoader::m_item.

◆ realDataItem() [2/2]

const RealDataItem * AbstractDataLoader::realDataItem ( ) const

inherited

The real data item on which the import shall work.

Definition at line 75 of file AbstractDataLoader.cpp.

 {
     return m_item;
 }

References AbstractDataLoader::m_item.

◆ serialize()

QByteArray UserDefinedDataLoader1D::serialize ( ) const

overridevirtual

Returns every internal setting so it can be restored completely.

Reimplemented from AbstractDataLoader.

Definition at line 49 of file UserDefinedDataLoader1D.cpp.

 {
     return m_wrappedLoader->serialize();
 }

References m_wrappedLoader, and AbstractDataLoader::serialize().

Here is the call graph for this function:

◆ setFileContents()

void UserDefinedDataLoader1D::setFileContents ( const QByteArray & fileContent )

overridevirtual

Sets the file contents to be imported. If the file was a compressed file, then the decompressed content will be handed over already here.

Implements AbstractDataLoader.

Definition at line 66 of file UserDefinedDataLoader1D.cpp.

 {
     m_wrappedLoader->setFileContents(fileContent);
 }

References AbstractDataLoader::fileContent(), m_wrappedLoader, and AbstractDataLoader::setFileContents().

Here is the call graph for this function:

◆ setRealDataItem()

void AbstractDataLoader::setRealDataItem ( RealDataItem * item )

inherited

Define the real data item on which the import shall work.

Definition at line 65 of file AbstractDataLoader.cpp.

 {
     m_item = item;
 }

References AbstractDataLoader::m_item.

Referenced by GUI::View::ImportDataUtils::Import1dData(), and SpecularDataImportWidget::onFormatSelectionChanged().

Member Data Documentation

◆ m_defaultProperties

QByteArray UserDefinedDataLoader1D::m_defaultProperties

private

Definition at line 43 of file UserDefinedDataLoader1D.h.

Referenced by clone(), and initWithDefaultImportSettings().

◆ m_item

RealDataItem* AbstractDataLoader::m_item

protectedinherited

The real-data-item which owns this loader. Never delete this!

Definition at line 124 of file AbstractDataLoader.h.

Referenced by AutomaticDataLoader1D::createResultModel(), AutomaticDataLoader1D::processContents(), QREDataLoader::processContents(), AbstractDataLoader::realDataItem(), and AbstractDataLoader::setRealDataItem().

◆ m_name

QString UserDefinedDataLoader1D::m_name

private

Definition at line 41 of file UserDefinedDataLoader1D.h.

Referenced by clone(), and name().

◆ m_wrappedLoader

AbstractDataLoader1D* UserDefinedDataLoader1D::m_wrappedLoader

private

Definition at line 42 of file UserDefinedDataLoader1D.h.

Referenced by UserDefinedDataLoader1D(), clone(), deserialize(), guessSettings(), persistentClassName(), populateImportSettingsWidget(), processContents(), serialize(), and setFileContents().

The documentation for this class was generated from the following files:

/home/build/builds/o5h8MZZm/0/mlz/bornagain/GUI/View/Loaders/UserDefinedDataLoader1D.h
/home/build/builds/o5h8MZZm/0/mlz/bornagain/GUI/View/Loaders/UserDefinedDataLoader1D.cpp

Description

Signals

Public Member Functions

Protected Attributes

Private Attributes

Constructor & Destructor Documentation

◆ UserDefinedDataLoader1D()

Member Function Documentation

◆ applyImportSettings()

◆ clone()

◆ contentsProcessed

◆ createResultModel()

◆ defaultImportSettings()

◆ deserialize()

◆ fileContent()

◆ guessSettings()

◆ importSettingsChanged

◆ initWithDefaultImportSettings()

◆ lineUnrelatedErrors()

◆ name()

◆ numErrors()

◆ numLineRelatedErrors()

◆ persistentClassName()

◆ populateImportSettingsWidget()

◆ processContents()

◆ realDataItem() [1/2]

◆ realDataItem() [2/2]

◆ serialize()

◆ setFileContents()

◆ setRealDataItem()

Member Data Documentation

◆ m_defaultProperties

◆ m_item

◆ m_name

◆ m_wrappedLoader