Использование сторонних заголовочных файлов с Rcpp

у меня есть файл заголовка под названием coolStuff.h, который содержит функцию awesomeSauce(arg1) что я хотел бы использовать в моем исходном файле cpp.

Каталог Структуру:

• RworkingDirectory
  • sourceCpp
    • theCppFile.cpp
  • cppHeaders
    • coolStuff.h

Код:

#include <Rcpp.h>
#include <cppHeaders/coolStuff.h>
using namespace Rcpp;

// [[Rcpp::export]]
double someFunctionCpp(double someInput){

 double someOutput = awesomeSauce(someInput);

return someOutput;
}

я получаю ошибка:

 theCppFile.cpp:2:31: error: cppHeaders/coolStuff.h: No such file or directory

я переместил файл и каталог повсюду и, похоже, не могу заставить это работать. Я вижу примеры по всему месту использования сторонних заголовков, которые говорят, что просто сделайте это:

#include <boost/array.hpp>

(это из Hadley/devtools)

https://github.com/hadley/devtools/wiki/Rcpp

так что это дает? Я искал все утро и не могу найти ответ на то, что мне кажется простым вещь.

обновление 01.11.12

теперь, когда я понял, как создавать пакеты, которые используют Rcpp в Rstudio, позвольте мне перефразировать вопрос. У меня есть автономный файл заголовка coolStuff.h, который содержит функцию, которую я хочу использовать в коде cpp.

1) где я должен разместить coolStuff.h в структуре каталогов пакета, поэтому функция, которую он содержит, может использоваться theCppFile.cpp?

2) Как мне вызвать coolStuff.h в файлах cpp? Спасибо снова за вашу помощь. Я многому научился из последнего разговора.

Примечание: я прочитал виньетку "написание пакета, который использует Rcpp", и она не объясняет, как это сделать.

Ответ:

OK позвольте мне резюмировать ответ на мой вопрос, так как он разбросан по этой странице. Если я получу деталь неправильно, не стесняйтесь редактировать это или дайте мне знать, и я отредактирую его:

Итак, вы нашли .h или , который содержит функция или какой-либо другой бит кода, который вы хотите использовать в .cpp файл, который вы пишете, чтобы использовать с Rcpp.

давайте продолжать называть этот найденный код coolStuff.h и вызвать функцию, которую вы хотите использовать awesomeSauce(). Позволяет вызвать файл, который вы пишете theCppFile.cpp.

(я должен отметить здесь, что код в .H-файлы и в .cpp-файлы - это весь код C++, и разница между ними заключается в том, что программист C++ держит вещи организованными надлежащим образом. Я оставлю обсуждение разница здесь, но простой поиск здесь на SO приведет вас к обсуждению разницы. Для вас R-программист должен использовать немного кода, который вы нашли, нет никакой реальной разницы.)

КОРОЧЕ: вы можете использовать файл как coolStuff.h при условии, что он не вызывает никаких других библиотек, либо вырезать и вставить в theCppFile.cpp, или если вы создаете пакет, вы можете поместить файл в С theCppFile.cpp файл и использовать #include "coolStuff.h" в верхней части файла ты пишешь. Последнее является более гибким и позволяет использовать функции coolStuff.h в другой .cpp файлы.

детали:

1) coolStuff.h не следует вызывать другие библиотеки. Таким образом, это означает, что он не может иметь никаких операторов include вверху. Если это так, то, что я подробно расскажу ниже, вероятно, не сработает, и использование найденного кода, вызывающего другие библиотеки, выходит за рамки этого ответа.

2) Если вы хотите скомпилировать файл с sourceCpp() нужно вырезать и вставить coolStuff.h на theCppFile.cpp. Мне говорили, что бывают исключения, но sourceCpp() предназначен для компиляции одного .cpp файл, так что это лучший маршрут.

(примечание: Я не гарантирую, что простой вырезать и вставить будет работать из коробки. Возможно, вам придется переименовать переменные или, скорее всего, переключить используемые типы данных в соответствии с используемыми в theCppFile.cpp. Но до сих пор cut-and-paste работал с минимальной суетой для меня с 6 разные простые .h файлы)

3) Если вам нужно использовать код coolStuff.h на theCppFile.cpp и нигде больше, тогда вы должны вырезать и вставить его в theCppFile.cpp.

(опять же, я не даю никаких гарантий см. Примечание выше о вырезании и вставке)

4) Если вы хотите использовать код, содержащийся в coolStuff.h на theCppFile.cpp и другие .cpp файлы, вам нужно изучить создание пакета. Это не сложно, но может быть немного сложно, потому что информация там о построение пакетов с Rcpp варьируется от исчерпывающей тщательной документации, которую вы хотите с любым пакетом R (но это выше вашей головы как новичка), и чувствительных введений новичка (которые могут оставить деталь вы случись нужда).

вот что я предлагаю:

A) сначала получите версию theCppFile.cpp С кодом от coolStuff.h вырезать-и-вставить в theCppFile.cpp, что составляет с sourceCpp() и работает, как вы ожидаете. Это не обязательно, но если вы новичок в Rcpp или пакетах, приятно убедиться, что ваш код работает в этой простой ситуации, прежде чем перейти к более сложному случаю ниже.

B) Теперь создайте свой пакет, используя Rcpp.package.skeleton() или используйте функцию сборки в RStudio (настоятельно рекомендуется). Вы можете найти подробную информацию об использовании Rcpp.package.skeleton() на Хэдли/инструменты разработчика или Виньетка Атрибутов Rcpp. Полная документация для написания пакетов с Rcpp находится в написание пакета что использует Rcpp, однако это предполагает, что вы знаете свой путь вокруг C++ довольно хорошо, и не использует новый способ "атрибуты" делать Rcpp.

не забудьте "построить и перезагрузить", если используете RStudio или compileAttributes() если вы не в RStudio.

C) теперь вы должны увидеть в своем каталоге R файл с именем RcppExports.R. Открой и проверь. В RcppExports.R вы должны увидеть функции оболочки R для всех .cpp-файлы у вас в папке . Хорошенький сладкий.

D) попробуйте функцию R, соответствующую функции, которую вы написали в theCppFile.cpp. Это работает? Если да, то двигайтесь дальше.

E) с вашим пакетом построен вы можете двигаться coolStuff.h на С theCppFile.cpp.

F) теперь вы можете удалить код вырезания и вставки из theCppFile.cpp и в самом верху theCppFile.cpp (и любых других .cpp-файл, который вы хотите использовать из coolStuff.з) поставить #include "coolStuff.h" сразу после #include <Rcpp.h>. Обратите внимание, что нет скобок вокруг рядовой.h, скорее есть"". Это c++ конвенции, включая локальные файлы, предоставленные пользователем, а не файл библиотеки, как Rcpp или STL и т. д...

G) Теперь вам нужно перестроить пакет. В RStudio это просто "Build & Reload" в меню сборки. Если вы не используете RStudio, вы должны запустить compileAttributes()

H) теперь попробуйте функцию R снова, как и на шаге D), надеюсь, она работает.