Blocos de construção de encadeamento intel oneAPI

Informações do produto

um API Threading Building Blocks (um TB)

oneAPI Threading Building Blocks (oneTBB) é um modelo de programação paralela baseado em tempo de execução para código C++ que usa threads. É uma biblioteca de tempo de execução baseada em modelo projetada para ajudar a aproveitar o desempenho latente de processadores multi-core. O oneTBB simplifica a programação paralela dividindo a computação em tarefas de execução paralela. O paralelismo é realizado dentro de um único processo por meio de threads, um mecanismo do sistema operacional que permite que o mesmo ou diferentes conjuntos de instruções sejam executados simultaneamente.

O oneTBB pode ser baixado como um produto independente ou como parte do Intel(R) oneAPI Base Toolkit. O produto vem com um conjunto de requisitos de sistema que devem ser atendidos antes da instalação.

Requisitos do sistema

• Consulte os requisitos do sistema oneTBB.

Instalação

• Baixe o oneTBB como um produto independente ou como parte do Intel(R) oneAPI Base Toolkit.
• Consulte o Guia de instalação para obter uma versão autônoma (sistema operacional Windows* e Linux*) e o Guia de instalação dos kits de ferramentas oneAPI Intel(R).

Instruções de uso

• • Depois de instalar o oneTBB, defina as variáveis ​​de ambiente acessando o diretório de instalação do oneTBB. Por padrão, o diretório de instalação é o seguinte:

Para sistema operacional Linux*: /opt/intel/Konami/tab/latest/env/vars.sh

Para sistema operacional Windows*: %ProgramaFiles(x86)%InteloneAPItbblatestenvvars.bat

• • Compile um programa usando oneTBB no sistema operacional Linux* e macOS* usando a ferramenta pkg-config. Forneça o caminho completo para pesquisar incluindo files e bibliotecas ou forneça uma linha simples como esta:

g++ -o test test.cpp $(pkg-config –libs –guia flags)

• Para o sistema operacional Windows*, use adicionalmente o sinalizador de opção –msvc-syntax que converte os sinalizadores de compilação e vinculação em um modo apropriado.
• Consulte o Guia do desenvolvedor e a Referência da API no GitHub para obter notas detalhadas, problemas conhecidos e alterações.

Comece com um API Threading Building Blocks (um TB)

• oneAPI Threading Building Blocks (oneTBB) é um modelo de programação paralela baseado em tempo de execução para código C++ que usa threads. Ele consiste em uma biblioteca de tempo de execução baseada em modelo para ajudá-lo a aproveitar o desempenho latente de processadores multi-core.
  O oneTBB permite que você simplifique a programação paralela dividindo a computação em tarefas de execução paralela.
• Dentro de um único processo, o paralelismo é realizado por meio de threads, um mecanismo do sistema operacional que permite que o mesmo ou diferentes conjuntos de instruções sejam executados simultaneamente.
• Aqui você pode ver uma das possíveis execuções de tarefas por threads.

Use uma guia para escrever aplicativos escaláveis ​​que:

• Especifique a estrutura paralela lógica em vez de threads
• Enfatize a programação paralela de dados
• Aproveitetage de coleções simultâneas e algoritmos paralelos
• oneTBB suporta paralelismo aninhado e balanceamento de carga. Isso significa que você pode usar a biblioteca sem se preocupar com o excesso de assinaturas de um sistema. O oneTBB está disponível como um produto independente e como parte do Intel® oneAPI Base Toolkit.

Requisitos do sistema

• Consulte os requisitos do sistema oneTBB.

Baixe os blocos de construção de encadeamento Intel(R) oneAPI (oneTBB)

• Baixe o oneTBB como um produto independente ou como parte do Intel(R) oneAPI Base Toolkit. Consulte o Guia de instalação para obter uma versão independente (sistema operacional Windows* e Linux*) e o Guia de instalação dos kits de ferramentas oneAPI Intel(R).

Antes de começar

Depois de instalar o oneTBB, você precisa definir as variáveis ​​de ambiente:

1. Vá para o diretório de instalação do oneTBB ( ). Por padrão, é o seguinte:
   1. No SO Linux*:
   2. Para superusuários (root): /opt/intel/Konami
   3. Para usuários comuns (não root): $HOME/intel/Konami
   4. No sistema operacional Windows*:
   5. <Program Files>\Intel\oneAPI
2. Defina as variáveis ​​de ambiente, usando o script em , Correndo
   • No SO Linux*: vars.{sh|csh} em /tbb/mais recente/env
   • No sistema operacional Windows*: vars.bat em /tbb/mais recente/env

Example
Abaixo você pode encontrar um ex típicoample para um algoritmo oneTBB. o sample calcula uma soma de todos os números inteiros de 1 a 100.

oneAPI Threading Building Blocks (oneTBB) e ferramenta pkg-config

• A ferramenta pkg-config é usada para simplificar a linha de compilação recuperando informações sobre pacotes de
  metadados especiais files. Isso ajuda a evitar grandes caminhos codificados e torna a compilação mais portátil.

Compilar um programa usando pkg-config

• Para compilar um programa de teste test.cpp com oneTBB no sistema operacional Linux* e macOS*, forneça o caminho completo para pesquisar por include files e bibliotecas ou forneça uma linha simples como esta:

Onde:

• cflags fornece a biblioteca oneTBB incluindo o caminho:
• libs fornecem o nome da biblioteca Intel(R) oneTBB e o caminho de pesquisa para localizá-la:
• OBSERVAÇÃO Para o sistema operacional Windows*, use adicionalmente o sinalizador de opção –msvc-syntax que converte os sinalizadores de compilação e vinculação em um modo apropriado.

Descubra mais

• um TBB Fórum da Comunidade
• Perguntas frequentes sobre produtos
• Pedidos de suporte
• Use esses recursos se precisar de suporte com oneTBB.
• Notas de Lançamento Encontre informações atualizadas sobre o produto, incluindo notas detalhadas, problemas conhecidos e alterações.
• Documentação: Guia do desenvolvedor e referência de API
• Aprenda a usar o oneTBB.
• GitHub* Encontre a implementação oneTBB em código aberto.

Avisos e isenções de responsabilidade

• As tecnologias Intel podem exigir ativação de hardware, software ou serviço habilitada.
• Nenhum produto ou componente pode ser absolutamente seguro.
• Seus custos e resultados podem variar.
• © Intel Corporation. Intel, o logotipo Intel e outras marcas Intel são marcas comerciais da Intel Corporation ou de suas subsidiárias. Outros nomes e marcas podem ser reivindicados como propriedade de terceiros.
• Nenhuma licença (expressa ou implícita, por preclusão ou de outra forma) para quaisquer direitos de propriedade intelectual é concedida por este documento.
• Os produtos descritos podem conter defeitos de projeto ou erros conhecidos como errata que podem fazer com que o produto se desvie das especificações publicadas. As erratas caracterizadas atuais estão disponíveis mediante solicitação.
• A Intel se isenta de todas as garantias expressas e implícitas, incluindo, sem limitação, as garantias implícitas de comercialização, adequação a uma finalidade específica e não infração, bem como qualquer garantia decorrente do curso de desempenho, curso de negociação ou uso no comércio.

Instale o oneTBB no sistema operacional Windows*

• Esta seção descreve como você pode implantar a biblioteca oneAPI Threading Building Blocks (oneTBB) em uma máquina com sistema operacional Windows*.
• Se você planeja instalar o oneTBB como parte do Intel® oneAPI Base Toolkit, consulte a seção correspondente do Intel(R) oneAPI Toolkits Installation Guide.
• Se você planeja instalar o oneTBB como um produto autônomo, siga as instruções abaixo, usando a GUI do instalador ou um gerenciador de pacotes de sua escolha.
• Aprenda a instalar o oneTBB com GUI e gerenciador de pacotes: * Instalar com GUI * Instalar com um gerenciador de pacotes

Instalar com GUI

Etapa 1. Selecione o instalador preferido

1. Vá para a página de download. Uma lista de instaladores disponíveis é exibida.
2. Decida o tipo de instalador do Windows que você usará:
   • O instalador online tem um tamanho menor file tamanho, mas requer uma conexão permanente com a Internet durante a execução.
   • O instalador offline tem um tamanho maior file tamanho, mas requer uma conexão com a Internet apenas para baixar o instalador filee, em seguida, é executado offline.
3. Tendo decidido o tipo de instalador, clique no link correspondente para iniciar o download.
4. Aguarde a conclusão do download.

Etapa 2. Prepare o instalador

Para instaladores off-line:

1. Execute o .exe file você baixou. O extrator do pacote de instalação será iniciado.
2. Especifique o caminho onde extrair o pacote – o padrão é C:\Users\ \Downloads\w_tbb_oneapi_p_ _desligada.
3. Se necessário, selecione a opção Remover extração temporária files após a caixa de seleção de instalação.
4. Clique em Extrair.
   Para o instalador online, o download começa automaticamente depois que você executa o .exe file.

Etapa 3. Execute a configuração

1. Se você estiver executando o instalador offline, clique em Continuar para continuar. O instalador online prosseguirá automaticamente.
2. Na etapa Resumo, marque a caixa de seleção Aceito os termos do contrato de licença.
3. Selecione o modo de instalação:

• Para usar as configurações de instalação padrão, selecione Instalação recomendada. oneTBB será instalado no local padrão: %Program FIles (x86)%\Intel\oneAPI\. Clique em Continuar e prossiga para a etapa Integrar IDE.
• Para modificar as configurações de instalação, selecione Instalação personalizada e clique em Personalizar. Você prosseguirá para a etapa Selecionar componentes. No entanto, nenhum outro componente além de um TBB pode ser selecionado devido à natureza da solução. Nesse modo, você pode alterar o local de instalação padrão clicando em Alterar no canto inferior esquerdo da janela.

1. Na etapa Integrar IDE, o programa verifica se é possível implantar o oneTBB totalmente integrado ao IDE Microsoft Visual Studio – para isso, a versão do IDE suportada deve estar instalada na máquina de destino. Se não estiver instalado, você pode sair da configuração e reiniciá-lo após instalar o IDE ou continuar sem integração.
2. Na etapa Programa de Melhoria de Software, selecione a opção de sua preferência. Em seguida, clique em Instalar para iniciar a instalação.
3. Aguarde a conclusão do processo. Em seguida, clique em Concluir para fechar o instalador ou Ir para Produtos Instalados para verificar se há atualizações ou executar outras ações.

OBSERVAÇÃO Lembre-se de configurar as variáveis ​​de ambiente após a instalação. Consulte a seção Antes de começar para saber mais sobre isso.

Instalar com um gerenciador de pacotes

• Para instalar o oneTBB com um gerenciador de pacotes, execute o comando correspondente descrito na documentação:
• Conda
• Pipa
• NuGet
• OBSERVAÇÃO Lembre-se de configurar as variáveis ​​de ambiente após a instalação. Consulte a seção Antes de começar para saber mais sobre isso.

Atualizando o oneTBB

• A atualização contínua é compatível com oneTBB 2021.1 e versões posteriores. Para atualizar o oneTBB para a versão mais recente, execute a configuração, conforme descrito acima.
• Se você costumava trabalhar com versões mais antigas (TBB), considere que as novas versões do oneTBB não fornecem compatibilidade com versões anteriores. Ver TBB Revamp: Antecedentes, Alterações e Modernização para obter detalhes. Além disso, consulte
• Migrando do TBB para obter mais informações sobre como migrar para o oneTBB.

Desinstalando o OneTBB

• Para desinstalar o oneTBB, use Aplicativos e Recursos ou Programas e Recursos.

Instale o oneTBB no SO Linux*

• Esta seção descreve como você pode implantar a biblioteca oneAPI Threading Building Blocks (oneTBB) em uma máquina Linux*. Escolha a forma preferida:
• Instale o oneTBB usando a linha de comando
• Instale o oneTBB usando os gerenciadores de pacotes de sua escolha:
• Conda
• APT
• DELÍCIA
• PIP
• NuGet
• OBSERVAÇÃO Você também pode instalar um TB em uma máquina com sistema operacional Linux* usando GUI. Consulte o Guia de instalação do Intel(R) oneAPI para saber mais.

Instale o oneTBB usando a linha de comando

• Para instalar o oneTBB, execute um dos seguintes comandos de acordo com sua função:
• raiz:
• usuário:

Onde:

• silencioso – Execute o instalador no modo não interativo (silencioso).
• eula – Aceite ou recuse o Contrato de licença de usuário final (EULA), valores aceitos: aceite ou recuse (padrão).
• componentes - Permite personalizar os componentes instalados.

Por exemploampem:

Instale o oneTBB usando gerenciadores de pacotes

• Siga as instruções, usando um gerenciador de pacotes de sua escolha.

Conda

• Esta seção fornece instruções gerais sobre como instalar os OneAPI Threading Building Blocks (oneTBB) por meio do
• Gerenciador de pacotes Conda*. Para obter notas de instalação adicionais, consulte a documentação do Conda.
• Para instalar o oneTBB, execute o seguinte comando:
• Você também pode usar: conda install -c intel/label/intel tbb-devel
• OBSERVAÇÃO Consulte o Guia de instalação do Intel(R) oneAPI para saber como configurar o Conda.

APT

• Para instalar o oneTBB usando APT*, execute:
• Por exemploampem:

OBSERVAÇÃO Consulte o Guia de instalação do Intel(R) oneAPI para saber como configurar o YUM.

Para instalar o oneTBB usando PIP*, execute:

Por exemploampem:

NuGet

Para instalar o oneTBB do NuGet* usando a linha de comando, faça o seguinte:

1. Ir para nuget.org
2. Correr:

OBSERVAÇÃO Consulte o Guia de instalação do Intel(R) oneAPI para saber como configurar o NuGet*.
OBSERVAÇÃO Lembre-se de configurar as variáveis ​​de ambiente após a instalação. Consulte a seção Antes de começar para saber mais sobre isso.

• A atualização contínua é compatível com oneTBB 2021.1 e versões posteriores. Para atualizar o oneTBB para a versão mais recente, execute a configuração, conforme descrito acima.
• Se você costumava trabalhar com versões mais antigas (TBB), considere que as novas versões do oneTBB não fornecem compatibilidade com versões anteriores. Ver TBB Revamp: Antecedentes, Alterações e Modernização para obter detalhes. Além disso, consulte Migrando do TBB para obter mais informações sobre a migração para um TB.

Documentos / Recursos

Blocos de construção de encadeamento intel oneAPI [pdf] Guia do Usuário OneAPI Threading Building Blocks, Threading Building Blocks, Building Blocks, Blocks

Referências

• Manual do usuário