naiad:Plugins - Revision history

Denis.spiridonov at 09:52, 14 January 2013

2013-01-14T09:52:42Z

← Older revision		Revision as of 09:52, 14 January 2013
Line 40:		Line 40:

	Для правильной обработки переменной time, к ней необходимо необходимо прибывить значение 347155200.		Для правильной обработки переменной time, к ней необходимо необходимо прибывить значение 347155200.
		+
		+
		+
		+	Для правильной работы плагина необходимо внести изменения в файл pluginMatching.xml и при необходимости добавить продукт.
		+
		+	Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic
		+
		+	Все переменные продукта можно увидеть через сервер OPeNDAP, открыв необходимый файл.
		+
		+	Рассмотрим на примере продукта ASI-AMSRE. При открытии через OPeNDAP видим две группы "Global Attributes" и "Variables". Все атрибуты из группы "Global Attributes" обрабатываются в функции buildGlobalAttributeList, которая вызывается в функции buildGranule. Все переменные из группы "Variables" обрабатываются в функции buildVariableList. Среди них должны быть lat, lon и time (иначе необходимо создать виртуальные переменные).
		+
		+	Для разработки плагина продукта необходимо..
		+
		+	'''Виртуальные переменные'''

	Если среди переменных продукта отсутствуют longitude, latitude или time, то необходимо создать виртуальную переменную (виртуальные переменные). Для этого в директории с плагином [qdione_install_dir]/src/plugins/collections/[plugin_name] необходимо создать директорию virtual, а в ней директории с именами необходимых переменных, например "lat", "lon", "time".		Если среди переменных продукта отсутствуют longitude, latitude или time, то необходимо создать виртуальную переменную (виртуальные переменные). Для этого в директории с плагином [qdione_install_dir]/src/plugins/collections/[plugin_name] необходимо создать директорию virtual, а в ней директории с именами необходимых переменных, например "lat", "lon", "time".
Line 84:		Line 98:
	int Date = pluginConfigList.at(pluginConfigIndex)->Date->valueAsInt(i);		int Date = pluginConfigList.at(pluginConfigIndex)->Date->valueAsInt(i);
	[/code]		[/code]
-
-	Для правильной работы плагина необходимо внести изменения в файл pluginMatching.xml и при необходимости добавить продукт.
-
-	~~Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic~~
-
-	~~Все переменные продукта можно увидеть через сервер OPeNDAP, открыв необходимый файл.~~
-
-	Рассмотрим на примере продукта ASI-AMSRE. При открытии через OPeNDAP видим две группы "Global Attributes" и "Variables". Все атрибуты из группы "Global Attributes" обрабатываются в функции buildGlobalAttributeList, которая вызывается в функции buildGranule. Все переменные из группы "Variables" обрабатываются в функции buildVariableList. Среди них должны быть lat, lon и time (иначе необходимо создать виртуальные переменные).
-
-	~~Для разработки плагина продукта необходимо..~~

	--[[User:Denis.spiridonov\|Denis.spiridonov]] 09:42, 14 January 2013 (UTC)		--[[User:Denis.spiridonov\|Denis.spiridonov]] 09:42, 14 January 2013 (UTC)

Denis.spiridonov at 09:42, 14 January 2013

2013-01-14T09:42:53Z

← Older revision		Revision as of 09:42, 14 January 2013
Line 88:		Line 88:

	Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic		Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic
		+
		+	Все переменные продукта можно увидеть через сервер OPeNDAP, открыв необходимый файл.
		+
		+	Рассмотрим на примере продукта ASI-AMSRE. При открытии через OPeNDAP видим две группы "Global Attributes" и "Variables". Все атрибуты из группы "Global Attributes" обрабатываются в функции buildGlobalAttributeList, которая вызывается в функции buildGranule. Все переменные из группы "Variables" обрабатываются в функции buildVariableList. Среди них должны быть lat, lon и time (иначе необходимо создать виртуальные переменные).

	Для разработки плагина продукта необходимо..		Для разработки плагина продукта необходимо..

-	--[[User:Denis.spiridonov\|Denis.spiridonov]] 12:36, 11 January 2013 (UTC)	+	--[[User:Denis.spiridonov\|Denis.spiridonov]] 09:42, 14 January 2013 (UTC)

Denis.spiridonov at 12:36, 11 January 2013

2013-01-11T12:36:15Z

← Older revision		Revision as of 12:36, 11 January 2013
Line 91:		Line 91:
	Для разработки плагина продукта необходимо..		Для разработки плагина продукта необходимо..

-	--[[User:Denis.spiridonov\|Denis.spiridonov]] 12:29, 11 January 2013 (UTC)	+	--[[User:Denis.spiridonov\|Denis.spiridonov]] 12:36, 11 January 2013 (UTC)

Denis.spiridonov at 12:35, 11 January 2013

2013-01-11T12:35:57Z

← Older revision		Revision as of 12:35, 11 January 2013
Line 87:		Line 87:
	Для правильной работы плагина необходимо внести изменения в файл pluginMatching.xml и при необходимости добавить продукт.		Для правильной работы плагина необходимо внести изменения в файл pluginMatching.xml и при необходимости добавить продукт.

-	~~===============~~
	Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic		Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic

Denis.spiridonov at 12:35, 11 January 2013

2013-01-11T12:35:23Z

← Older revision		Revision as of 12:35, 11 January 2013
Line 84:		Line 84:
	int Date = pluginConfigList.at(pluginConfigIndex)->Date->valueAsInt(i);		int Date = pluginConfigList.at(pluginConfigIndex)->Date->valueAsInt(i);
	[/code]		[/code]
		+
		+	Для правильной работы плагина необходимо внести изменения в файл pluginMatching.xml и при необходимости добавить продукт.

	===============		===============

Denis.spiridonov at 12:29, 11 January 2013

2013-01-11T12:29:09Z

← Older revision		Revision as of 12:29, 11 January 2013
Line 40:		Line 40:

	Для правильной обработки переменной time, к ней необходимо необходимо прибывить значение 347155200.		Для правильной обработки переменной time, к ней необходимо необходимо прибывить значение 347155200.
		+
		+	Если среди переменных продукта отсутствуют longitude, latitude или time, то необходимо создать виртуальную переменную (виртуальные переменные). Для этого в директории с плагином [qdione_install_dir]/src/plugins/collections/[plugin_name] необходимо создать директорию virtual, а в ней директории с именами необходимых переменных, например "lat", "lon", "time".
		+
		+	Также можно создавать произвольные виртуальные переменные, при необходимости произведения определённых вычислений или получении данных, отсутствующих в продукте.
		+
		+	Разберём пример создания виртуальной переменной на переменной "time" продукта aquarius_l3_sss_smi_7day. Создадим директорию [qdione_install_dir]/src/plugins/collections/aquarius_l3_sss_smi_7day/virtual/time. В ней создадим файл проекта time.pro (в случае использования Qt Creator файл проекта создаётся автоматически при создании нового проекта) со следующим содержимым:
		+
		+	[code]
		+	include(../../../../../../qdione_config.pri)
		+	PRODUCT = aquarius_l3_sss_smi_7day
		+	PLUGIN_NAME = time
		+
		+	TEMPLATE = lib
		+	TARGET = $${PLUGIN_NAME}_plugin
		+	DEPENDPATH += . ../../../../../libqdione
		+	INCLUDEPATH += . ../../../../../libqdione
		+	INCLUDEPATH += $${NETCDF_INCLUDEPATH} $${GDAL_INCLUDEPATH} $${DAP_INCLUDEPATH} $${HDF4_INCLUDEPATH}
		+	DESTDIR = ../../../../../../lib/plugins/collections/$${PRODUCT}/virtual/
		+
		+	CONFIG += plugin
		+
		+	LIBS += $${NETCDF_LIBS} $${GDAL_LIBS} $${DAP_LIBS} $${HDF4_LIBS} -ldapclient -L../../../../../../lib -lqdione -Wl,-rpath
		+
		+	# Input
		+	SOURCES += $${PLUGIN_NAME}.cpp
		+	[/code]
		+
		+	И файл исходных текстов time.cpp, описывающий структуру PluginConfig и содержащий реализации двух функции: init и compute.
		+
		+	Список PluginConfigList содержит конфигурации, связанные с каждым из экземпляров плагина (плагин может быть запущен несколько раз).
		+
		+	Функции инициализации init заполняет структуру PluginConfig входными данными сохраняет её в списке PluginConfigList.
		+
		+	unsigned int init(DioneGranule* granule, DioneVariableInfo * variableInfo, DioneType * type);
		+
		+	Функция compute производит все необходимые вычисления и возвращает значение виртуальной переменной (типа QVariant).
		+
		+	QVariant compute(unsigned int pluginConfigIndex, const Iterator& i);
		+
		+	Для вычислений используются значения, сохранённые в текущем pluginConfig, например:
		+
		+	[code]
		+	int Date = pluginConfigList.at(pluginConfigIndex)->Date->valueAsInt(i);
		+	[/code]

	===============		===============
Line 46:		Line 90:
	Для разработки плагина продукта необходимо..		Для разработки плагина продукта необходимо..

-	--[[User:Denis.spiridonov\|Denis.spiridonov]] 10:18, 11 January 2013 (UTC)	+	--[[User:Denis.spiridonov\|Denis.spiridonov]] 12:29, 11 January 2013 (UTC)

Denis.spiridonov at 10:18, 11 January 2013

2013-01-11T10:18:06Z

← Older revision		Revision as of 10:18, 11 January 2013
Line 1:		Line 1:
	Все исходные файлы плагинов продуктов находятся в директории [qdione_install_dir]/src/plugins/collections .		Все исходные файлы плагинов продуктов находятся в директории [qdione_install_dir]/src/plugins/collections .

-	Каждый плагин представляет собой дерево директорий. Корневая директория имеет название, аналогичное названию плагина. В ней располагаются следующие директории:	+	Каждый плагин представляет собой дерево директорий. Корневая директория имеет название, аналогичное названию плагина. В ней располагаются следующие директории: main (обязательно), filtering, aggregation и virtual.
-	* main (обязательно),	+
-	* filtering,	+
-	* aggregation и	+
-	* virtual.	+

	Плагины написаны на языке С++ с использованием библиотек Qt4. (Для удобства используйте среду разработки QtCreator.)		Плагины написаны на языке С++ с использованием библиотек Qt4. (Для удобства используйте среду разработки QtCreator.)
Line 13:		Line 9:
	Функция buildConstraintExpression создаёт строку (ограничений для каждой переменной) для отправления на OPeNDAP сервер. Строка имеет вид:		Функция buildConstraintExpression создаёт строку (ограничений для каждой переменной) для отправления на OPeNDAP сервер. Строка имеет вид:

-	~~<source lang="cpp">~~variable_name1[min:stride:max],variable_name2[min:stride:max],...~~</source>~~	+	'''variable_name1[min:stride:max],variable_name2[min:stride:max],...''',

-	где [min:stride:max] - формат записи ограничений (для каждой переменной ограничения могут быть разными), variable_name[1,2] - имена переменных. Например,	+	где [min:stride:max] - формат записи ограничений (для каждой переменной ограничения могут быть разными), variable_name[1,2] - имена переменных. Например, "wvc_row_time[0:1:1623],wvc_lon[0:1:1623][0:1:75],wvc_lat[0:1:1623]"
-	~~<source lang=~~"~~cpp">~~wvc_row_time[0:1:1623],wvc_lon[0:1:1623][0:1:75],wvc_lat[0:1:1623]~~</source>~~	+

-	Общий вид функции ~~<source lang="cpp">~~extern "C" QString buildConstraintExpression(QStringList & nativeVariableStringList, QString xOffset, QString yOffset, QString zOffset, DioneDapDataFile* dapfile);~~</source>~~	+	Общий вид функции '''extern "C" QString buildConstraintExpression(QStringList & nativeVariableStringList, QString xOffset, QString yOffset, QString zOffset, DioneDapDataFile* dapfile);'''

	Переменная nativeVariableStringList хранит список имён переменных, для которых необходимо создать ограничения ([min:stride:max]);		Переменная nativeVariableStringList хранит список имён переменных, для которых необходимо создать ограничения ([min:stride:max]);
Line 26:		Line 21:
	Функция buildGranule строит структуру гранул в QDione из OPeNDAP файла. Возвращает true, если гранула построена правильно, иначе false.		Функция buildGranule строит структуру гранул в QDione из OPeNDAP файла. Возвращает true, если гранула построена правильно, иначе false.

-	Общий вид функции ~~<source lang="cpp">~~extern "C" bool buildGranule(DioneDapDataFile* dapfile, DioneGranule * granule);~~</source>~~	+	Общий вид функции '''extern "C" bool buildGranule(DioneDapDataFile* dapfile, DioneGranule * granule);'''

	Переменная dapfile - указатель на OPeNDAP файл;		Переменная dapfile - указатель на OPeNDAP файл;
Line 32:		Line 27:

	В этой функции необходимо обработать глобальные атрибуты и переменные. Для этого применяются функции buildGlobalAttributeList и buildVariableList. В случае ошибка хотя бы при одной переменной функция вернёт false.		В этой функции необходимо обработать глобальные атрибуты и переменные. Для этого применяются функции buildGlobalAttributeList и buildVariableList. В случае ошибка хотя бы при одной переменной функция вернёт false.
		+
		+	Переменные latitude и longitude должны называться lat и lon. Иначе, перед добавлением в гранулы их необходимо переименовать, например:
		+
		+	[code]
		+	if (name == "longitude" \|\| name == "latitude")
		+	{
		+	name = (baseTypeVariable->name() == "longitude") ? "lon" : "lat";
		+	}
		+	var = granule->addVariable(name, dioneTypeFromDapType(arrayVariable->var()->type()), list,
		+	granule->getVariable(granule->indexOfVariable("time")));
		+	[/code]
		+
		+	Для правильной обработки переменной time, к ней необходимо необходимо прибывить значение 347155200.
		+
	===============		===============
	Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic		Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic

	Для разработки плагина продукта необходимо..		Для разработки плагина продукта необходимо..
-	--[[User:Denis.spiridonov\|Denis.spiridonov]] 10:50, ~~26 December 2012~~ (UTC)	+
		+	--[[User:Denis.spiridonov\|Denis.spiridonov]] 10:18, 11 January 2013 (UTC)

Denis.spiridonov at 09:26, 11 January 2013

2013-01-11T09:26:28Z

← Older revision		Revision as of 09:26, 11 January 2013
Line 31:		Line 31:
	Переменная granule - указатель на гранулу, которую необходимо построить.		Переменная granule - указатель на гранулу, которую необходимо построить.

		+	В этой функции необходимо обработать глобальные атрибуты и переменные. Для этого применяются функции buildGlobalAttributeList и buildVariableList. В случае ошибка хотя бы при одной переменной функция вернёт false.
	===============		===============
	Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic		Плагины, которые могут быть использованы любой коллекцией, находятся в директории [qdione_install_dir]/src/plugins/generic

Admin at 11:51, 27 December 2012

2012-12-27T11:51:28Z

← Older revision		Revision as of 11:51, 27 December 2012
Line 26:		Line 26:
	Функция buildGranule строит структуру гранул в QDione из OPeNDAP файла. Возвращает true, если гранула построена правильно, иначе false.		Функция buildGranule строит структуру гранул в QDione из OPeNDAP файла. Возвращает true, если гранула построена правильно, иначе false.

-	Общий вид функции ~~'''~~extern "C" bool buildGranule(DioneDapDataFile* dapfile, DioneGranule * granule);~~'''~~	+	Общий вид функции <source lang="cpp">extern "C" bool buildGranule(DioneDapDataFile* dapfile, DioneGranule * granule);</source>

	Переменная dapfile - указатель на OPeNDAP файл;		Переменная dapfile - указатель на OPeNDAP файл;

Admin at 11:51, 27 December 2012

2012-12-27T11:51:01Z

← Older revision		Revision as of 11:51, 27 December 2012
Line 15:		Line 15:
	<source lang="cpp">variable_name1[min:stride:max],variable_name2[min:stride:max],...</source>		<source lang="cpp">variable_name1[min:stride:max],variable_name2[min:stride:max],...</source>

-	где [min:stride:max] - формат записи ограничений (для каждой переменной ограничения могут быть разными), variable_name[1,2] - имена переменных. Например, "wvc_row_time[0:1:1623],wvc_lon[0:1:1623][0:1:75],wvc_lat[0:1:1623]"	+	где [min:stride:max] - формат записи ограничений (для каждой переменной ограничения могут быть разными), variable_name[1,2] - имена переменных. Например,
		+	<source lang="cpp">wvc_row_time[0:1:1623],wvc_lon[0:1:1623][0:1:75],wvc_lat[0:1:1623]</source>

	Общий вид функции <source lang="cpp">extern "C" QString buildConstraintExpression(QStringList & nativeVariableStringList, QString xOffset, QString yOffset, QString zOffset, DioneDapDataFile* dapfile);</source>		Общий вид функции <source lang="cpp">extern "C" QString buildConstraintExpression(QStringList & nativeVariableStringList, QString xOffset, QString yOffset, QString zOffset, DioneDapDataFile* dapfile);</source>