LabPlot/ImportExport/ImportFromProjects: Difference between revisions

From KDE UserBase Wiki
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 4: Line 4:


==Import from LabPlot Project Files==
==Import from LabPlot Project Files==
When the Import Project dialog opens, the structure of the selected project is displayed and the user can select which objects to import:
[[File:LabPlot project import.png |500px|thumb|center]]
The dependencies between the different objects are properly tracked and '''the dependent objects are automatically selected''' if not already done. For example, when selecting a worksheet with multiple visualizations, the dependent spreadsheets that serve as the data source for the visualizations are automatically selected and ready for import.
The user can specify the target folder where to import into which can be the top-level project folder or one of its sub-folders.


==Import Origin Project Files==
==Import Origin Project Files==
Importing from Origin files is similar to importing from LabPlot projects, except that only a subset of objects in Origin are supported and can be imported into LabPlot. Also, given the different philosophies and UX of the two applications, the usual problems with an undocumented and closed source proprietary file format, and the different feature sets implemented in LabPlot and Origin, such an import is neither perfect nor complete, but we try to achieve the best possible results.
Importing from Origin files is similar to importing from LabPlot projects, except that only '''a subset of objects in Origin are supported''' and can be imported into LabPlot. Also, given the different philosophies and UX of the two applications, the usual problems with an undocumented and closed source proprietary file format, and the different feature sets implemented in LabPlot and Origin, such an import is neither perfect nor complete, but we try to achieve the best possible results. [https://invent.kde.org/education/labplot/-/wikis/Import/OPJ The gallery of imported Origin files] contains multiple examples which show the quality of the results after the import.


The current list of supported objects is:
'''The current list of supported objects is:'''
* Folder
* Folder
* Workbook
* Workbook
Line 20: Line 26:
* Histogram
* Histogram


Since the terminology and the structure of objects, especially for worksheet elements, is different in many cases, the names and the properties are mapped to those available in LabPlot. For example, for a Graph in Origin we create a Worksheet in Labplot, for a Line Plot we create an XY-Curve, etc.
Since the terminology and the structure of objects, especially for worksheet elements, is different in many cases, '''the names and the properties are mapped to those available in LabPlot'''. For example, for a Graph in Origin we create a Worksheet in Labplot, for a Line Plot we create an XY-Curve, etc.
 
[https://invent.kde.org/education/labplot/-/wikis/Import/OPJ The gallery of imported Origin files] contains multiple examples which show the quality of the results after the import.
 
An additional note of caution must be paid to the multi-layers in Origin, which are used to implement either multiple plots or multiple axes on the same plot.The following picture from [https://www.originlab.com/doc/Origin-Help/MultiLayer-Graph Origin's documentation] summarizes the situation:


An additional note of caution must be paid to the '''multi-layers in Origin''', which are used to implement either multiple plots or multiple axes on the same plot.The following picture from [https://www.originlab.com/doc/Origin-Help/MultiLayer-Graph Origin's documentation] summarizes the situation:
[[File:LabPlot project import origin multi-layer.png |500px|thumb|center]]


This logic is implemented differently in LabPlot and in order to be able to properly import the multi-layers correctly in both variations mentioned above, we introduce an additional parameter in the "Import Project" dialog to allow the user to control how the multi-layers are to be imported:
This logic is implemented differently in LabPlot and in order to be able to properly import the multi-layers correctly in both variations mentioned above, we introduce an additional parameter in the "Import Project" dialog to allow the user to control how the multi-layers are to be imported:
[[File:LabPlot project import multi-layer options.png |500px|thumb|center]]


To handle Origin projects where both variants are used at the same time, the user must import the different objects separately using the appropriate import setting for them.
To handle Origin projects where both variants are used at the same time, the user must import the different objects separately using the appropriate import setting for them.

Latest revision as of 07:51, 18 July 2024

Unlike importing data from external files or databases, importing from project files allows you to import entire project artefacts such as data containers, visualisations, etc. into the project that is currently open in LabPlot. This is useful if only a part of another project (e.g. the spreadsheets with the data) is needed, or if the results of another project need to be merged into the current project.

Currently only import from LabPlot native and Origin projects is supported.

Import from LabPlot Project Files

When the Import Project dialog opens, the structure of the selected project is displayed and the user can select which objects to import:

The dependencies between the different objects are properly tracked and the dependent objects are automatically selected if not already done. For example, when selecting a worksheet with multiple visualizations, the dependent spreadsheets that serve as the data source for the visualizations are automatically selected and ready for import.

The user can specify the target folder where to import into which can be the top-level project folder or one of its sub-folders.

Import Origin Project Files

Importing from Origin files is similar to importing from LabPlot projects, except that only a subset of objects in Origin are supported and can be imported into LabPlot. Also, given the different philosophies and UX of the two applications, the usual problems with an undocumented and closed source proprietary file format, and the different feature sets implemented in LabPlot and Origin, such an import is neither perfect nor complete, but we try to achieve the best possible results. The gallery of imported Origin files contains multiple examples which show the quality of the results after the import.

The current list of supported objects is:

  • Folder
  • Workbook
  • Spreadsheet
  • Matrix
  • Note
  • Graph
  • Line plot, scatter plot, etc.
  • Bar plot
  • Box plot
  • Histogram

Since the terminology and the structure of objects, especially for worksheet elements, is different in many cases, the names and the properties are mapped to those available in LabPlot. For example, for a Graph in Origin we create a Worksheet in Labplot, for a Line Plot we create an XY-Curve, etc.

An additional note of caution must be paid to the multi-layers in Origin, which are used to implement either multiple plots or multiple axes on the same plot.The following picture from Origin's documentation summarizes the situation:

This logic is implemented differently in LabPlot and in order to be able to properly import the multi-layers correctly in both variations mentioned above, we introduce an additional parameter in the "Import Project" dialog to allow the user to control how the multi-layers are to be imported:

To handle Origin projects where both variants are used at the same time, the user must import the different objects separately using the appropriate import setting for them.