mmg

MMG - Remessas de superfície e volume

Software de código aberto para superfície bidimensional e tridimensional Remeshing de volume

---

Ramo Master (liberação)
Desenvolver ramo

---

MMG fornece 3 aplicativos e 4 bibliotecas:

• O aplicativo e biblioteca MMG2D : geração de malha de um conjunto de arestas, adaptação e otimização de uma triangulação bidimensional e discretização de isovaluato;
• A aplicação e biblioteca MMGS : adaptação e otimização de uma triangulação de superfície e discretização de isovaluato;
• A aplicação e biblioteca MMG3D : adaptação e otimização de uma malha tetraédrica, discretização de isovaluato e movimento lagrangiano;
• A biblioteca MMG coletando as bibliotecas MMG2D , MMGS e MMG3D .

Obtenha e compilar o projeto MMG

Ferramentas necessárias

Para obter e construir MMG, você precisará:

• Git : para baixar o código, você precisará usar um gerente Git. Você pode instalar um gerenciador git a partir do link abaixo, mas existem muitos outros clientes Git que você pode usar:

  • Cliente Git oficial (programa de linha de comando)
  • Gitkraken
  • Sourcetree

  Observe que, se você usa o Microsoft Visual Studio (Windows OS), poderá simplesmente ativar o módulo Git do aplicativo.

• CMake : MMG usa o sistema de construção do CMake que pode ser baixado na página da web a seguir: https://cmake.org/download/. No sistema operacional do Windows, depois que o cmake for instalado, não se esqueça de marcar a opção:

       Add CMake to the system PATH for all users
  

MMG Download e compilação

OS do tipo Unix (Linux, MacOS ...)

1. Obtenha o repositório:

      wget https://github.com/MmgTools/mmg/archive/master.zip

ou

      git clone https://github.com/MmgTools/mmg.git

As fontes do projeto estão disponíveis no SRC/ diretório, consulte:

• src/ mmg2d/ para arquivos relacionados ao aplicativo MMG2D;
• src/ mmgs/ para arquivos relacionados ao aplicativo MMGS;
• src/ mmg3d/ para arquivos relacionados ao aplicativo MMG3D;
• SRC/ Common/ para arquivos relacionados aos três.

2. Compilação rápida (Build MMG2D , MMGS , MMG3D , a biblioteca estática MMG2D ( libmmg3d.a ), a biblioteca estática MMGS ( libmmgs.a ), a biblioteca estática mmg3d ( libmmg3d.a ) e a mmg static library (library libmmg .

      cd mmg
      mkdir build
      cd build
      cmake ..
      make
      make install

Se o comando make install falhar, tente executar o comando sudo make install . Se você não tiver acesso root, consulte a seção de instalação do guia de configuração.

Os aplicativos MMG2D , MMGS e MMG3D estão disponíveis nos comandos mmg2d_O3 , mmgs_O3 e mmg3d_O3 .

Observe que, se você usar algumas opções específicas e desejar defini -las facilmente, poderá usar um script de shell para executar os comandos anteriores. Um exemplo é fornecido aqui.

Windows OS

A compilação a seguir pode ser realizada em qualquer versão moderna do Windows (também conhecida como 7, 8, 8.1 e 10). Um conhecimento básico do Windows é assumido (execute comandos no CMD, Criar diretórios, etc ...).

Compilar com o VisualStudio

Desenvolvimento universal da plataforma do Windows

1. Obtenha o software do Visual Studio : ele pode ser baixado aqui;

2. Se não for feito durante a etapa anterior, faça o download dos compiladores C/C ++ : na zona de pesquisa do Visual Studio, pesquise C compilador e instale os compiladores e bibliotecas visuais C ++ (componente individual) e o componente msbuild;

3. Na zona de pesquisa do Visual Studio, pesquise a palavra git e selecione a instalação da extensão do GitHub para o VisualStudio ;

4. Fique no VisualStudio e clone o repositório MMG a partir do seguinte URL: https://github.com/mmgtools/mmg.git;

5. Use o cmake para configurar e gerar seu projeto. Isso pode ser feito com o modo gráfico do CMake (você deve selecionar o gerador "VisualStudio") ou com uma linha de comando. Nesse caso, é altamente recomendável especificar que você pretende criar um projeto VisualStudio. Por exemplo, se você estiver usando o VisualStudio 2017:

  cmake -G "Visual Studio 15 2017 Win64" ^
  configure

Observe que você pode usar um script para facilitar esta etapa (um exemplo de script é fornecido aqui).

Depois que o script de configuração terminar sem erros, um arquivo mmg.sln será gerado no diretório cmake_build.

6. Clique duas vezes neste arquivo e o projeto do Visual Studio será aberto. Em seguida, escolha a configuração do projeto (liberação, depuração ...) e verifique se o projeto está definido como Win32 ou X64. Por fim, para compilar o MMG, clique com o botão direito do mouse no projeto INSTALL e selecione a BUILD da opção.

Compilar com Mingw

1. Obtenha um compilador C :

   • Mingw pode ser baixado aqui. Recomendamos instalar os pacotes Mingw-Developer-Tools , Mingw32-Base , Mingw32-GCC-Fortran , Mingw32-GCC-G ++ e MSYS-BASE ;
   • Edite as variáveis ​​de ambiente e adicione Mingw na sua variável de caminho . Isso pode ser feito no painel de configurações avançadas do sistema . (Observe que você deve modificar a variável do caminho , não o caminho );
   • Os binários Mingw estão provavelmente em C:MinGWbin
   • O terminal Mingw está em C:MinGWmsys1.0msys

2. Clone o repositório MMG a partir do seguinte URL: https://github.com/mmgtools/mmg.git;

3. Pare e reinicie o aplicativo CMake para levar em consideração a modificação do caminho e use o CMake para configurar e gerar seu projeto (selecione o gerador Mingw Makefiles do CMake). Se você instalou as bibliotecas escocesas, precisará definir explicitamente os caminhos das bibliotecas;

4. Construa os aplicativos MMG: no prompt de Mingw ( C:MinGWmsys1.0msys ) Run:

       mingw32-make

Novamente, se você usar algumas opções específicas e desejar facilitar a etapa de configuração do CMake, poderá usar um script em lote. Um exemplo de script é fornecido aqui.

Documentação

Página da web do projeto

Realidades do projeto e tutoriais de software podem ser encontrados na página da web do MMGTools.

Fórum

Compartilhe seus comentários e problemas com outros membros da comunidade MMG no fórum MMG.

Github Wiki

Informações mais detalhadas sobre a compilação e configuração dos aplicativos MMG estão disponíveis no Wiki do projeto.

Páginas de homem

As páginas do homem estão disponíveis dentro do diretório Doc/Man :

• Para ver a página do MMG2D Man, basta executar man ./doc/man/mmg2d.1.gz
• Para ver a página MMGS Man, Run man ./doc/man/mmgs.1.gz
• Para ver a página MMG3D Man, Run man ./doc/man/mmg3d.1.gz

Código documentação

Execute o comando make doc para criar a documentação doxygen, depois de executar cmake com a opção -DBUILD_DOC=yes se você ainda não o fez. Você pode querer adaptar build/Doxyfile ao seu gosto.

• Para ver a documentação do MMG , abra o arquivo <build>/doc/index.html .

Plataformas

Os aplicativos MMG são testados no OS X e na maioria das plataformas Linux.

Contribuindo

Suas contribuições para o projeto MMG são bem -vindas. Você pode nos ajudar a melhorar nosso código por muitos meios:

• Solicitações de puxar: Siga as diretrizes sobre o wiki;
• Solicitações de recursos: use o fórum MMG;
• Relatórios de bug: use o rastreador de problemas do github;

Sobre a equipe

Os atuais desenvolvedores e mantenedores da MMG são Charles Dapogny, Cécile Dobrzynski, Pascal Frey e Algiane Froehly.

Contato: [email protected]

Licença e direitos autorais

O código está sob os termos da licença pública geral de GNU menor.

Copyright © BX INP/INRIA/UBORDEAUX/UPMC, 2004-.

Referência

Recreação tetraédrica no contexto de simulação numérica em larga escala e computação de alto desempenho- G. Balarac, F. Basile, P. Bénard, F. Bordeu, J.-B. Chapelier, L. Cirrotola, G. Caumon, C. Dapogny, P. Frey, A. Froehly, G. Ghigliotti, R. Laraufie, G. Lartigue, C. Legentil, R. Mercier, V. Moureau, C. Nardoni, S. Pertent e M. Zakari - subtido (2021)

Remesas de domínio adaptativo tridimensional, malha de domínio implícito e aplicações para problemas de limite livre e comovente - C. Dapogny, C. Dobrzynski e P. Frey - 1 de abril de 2014 - JCP