{"id":13724362,"url":"https://github.com/GreenDelta/olca-app","last_synced_at":"2025-05-07T18:31:46.120Z","repository":{"id":10331107,"uuid":"12462033","full_name":"GreenDelta/olca-app","owner":"GreenDelta","description":"Source code of openLCA","archived":false,"fork":false,"pushed_at":"2024-10-23T12:19:06.000Z","size":63688,"stargazers_count":194,"open_issues_count":29,"forks_count":43,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-10-29T16:17:21.982Z","etag":null,"topics":["eclipse-rcp","java","openlca"],"latest_commit_sha":null,"homepage":"openlca.org","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GreenDelta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2013-08-29T14:14:54.000Z","updated_at":"2024-10-23T09:53:15.000Z","dependencies_parsed_at":"2024-04-13T10:54:05.430Z","dependency_job_id":null,"html_url":"https://github.com/GreenDelta/olca-app","commit_stats":{"total_commits":4242,"total_committers":19,"mean_commits":"223.26315789473685","dds":0.3517208863743517,"last_synced_commit":"2358fec09bc1ab35e6f13c1875ee5dd14a4fb827"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreenDelta%2Folca-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreenDelta%2Folca-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreenDelta%2Folca-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreenDelta%2Folca-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GreenDelta","download_url":"https://codeload.github.com/GreenDelta/olca-app/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222246905,"owners_count":16955119,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["eclipse-rcp","java","openlca"],"created_at":"2024-08-03T01:01:55.645Z","updated_at":"2024-11-14T14:30:39.632Z","avatar_url":"https://github.com/GreenDelta.png","language":"Java","readme":"# openLCA\nThis repository contains the source code of [openLCA](http://openlca.org).\nopenLCA is a Java application that runs on the Eclipse Rich Client Platform\n([Eclipse RCP](http://wiki.eclipse.org/index.php/Rich_Client_Platform)). This\nproject depends on the [olca-modules](https://github.com/GreenDelta/olca-modules)\nproject which is a plain [Maven](http://maven.apache.org/) project that contains\nthe core functionalities of openLCA (e.g. the model, database access,\ncalculations, data exchange, and database updates). \n\nThis repository has the following sub-projects:\n\n* [olca-app](./olca-app): contains the source code of the openLCA RCP \n  application.\n* [olca-app-build](./olca-app-build): contains the build scripts for compiling\n  openLCA and creating the installers for Windows, Linux, and macOS.\n* [olca-app-html](./olca-app-html): contains the source code for the HTML views\n  in openLCA (like the start page or the report views).\n* [olca-refdata](./olca-refdata): contains the current reference data (units,\n  quantities, and flows) that are packaged with openLCA.\n\nSee also the README files that are contained in these sub-projects.\n\n## Building from source\nopenLCA is an Eclipse RCP application with parts of the user interface written\nin HTML5 and JavaScript. To compile it from source you need to have the\nfollowing tools installed:\n\n* [Git](https://git-scm.com/) (optional)\n* a [Java Development Kit \u003e= v17](https://adoptium.net)\n* [Maven](http://maven.apache.org/)\n* the [Eclipse package for RCP developers](https://www.eclipse.org/downloads/packages/)\n* [Node.js](https://nodejs.org/) \n\nWhen you have these tools installed you can build the application from source\nvia the following steps:\n\n#### Install the openLCA core modules\nThe core modules contain the application logic that is independent from the user\ninterface and can be also used in other applications. These modules are plain\nMaven projects and can be installed via `mvn install`. See the\n[olca-modules](https://github.com/GreenDelta/olca-modules) repository for more\ninformation.\n\n#### Get the source code of the application\nWe recommend to use Git to manage the source code but you can also download\nthe source code as a [zip file](https://github.com/GreenDelta/olca-app/archive/master.zip).\nCreate a development directory (the path should not contain whitespaces):\n\n```bash\nmkdir olca\ncd olca\n```\n\nand get the source code:\n\n```bash\ngit clone https://github.com/GreenDelta/olca-app.git\n```\n\nYour development directory should now look like this:\n\n```\nolca-app\n  .git\n  olca-app\n  olca-app-build\n  olca-app-html\n  olca-refdata\n  ...\n```\n\n#### Building the HTML pages\nTo build the HTML pages of the user interface navigate to the\n[olca-app-html](./olca-app-html) folder:\n\n```bash\ncd olca-app/olca-app-html\n```\n\nThen install the Node.js modules via [npm](https://www.npmjs.com/) (npm is a\npackage manager that comes with your Node.js installation):\n\n```\nnpm install\n```\n\nThis also installs a local version of `webpack` which is used to create the\ndistribution package. The build of this package can be invoked via:\n\n```bash\nnpm run build\n```\n\nThe output is generated in the `dist` folder of this directory and packaged\ninto a zip file that is copied to the `../olca-app/html` folder.\n\n#### Prepare the Eclipse workspace\nDownload the current Eclipse package for RCP and RAP developers (to have\neverything together you can extract it into your development directory). Create\na workspace directory in your development directory (e.g. under the eclipse\nfolder to have a clean structure):\n\n```\neclipse\n  ...\n  workspace\nolca-app\n  .git\n  olca-app\n  olca-app-build\n  olca-app-html\n  olca-app-refdata\n  ...\n```\n\nAfter this, open Eclipse and select the created workspace directory. Import the\nprojects into Eclipse via `Import \u003e General \u003e Existing Projects into Workspace`\n(select the `olca/olca-app` directory). You should now see the `olca-app`, \n`olca-app-build`, projects in your Eclipse workspace.\n\n#### Loading the target platform \nThe file `platform.target` in the `olca-app` project contains the definition of\nthe [target platform](https://help.eclipse.org/oxygen/index.jsp?topic=%2Forg.eclipse.pde.doc.user%2Fconcepts%2Ftarget.htm)\nof the openLCA RCP application. Just open the file with the `Target Editor`\nand click on `Set as target platform` on the top right of the editor.\n\nThis will download the resources of the target platform into your local\nworkspace and, thus, may take a while. Unfortunately, setting up and\nconfiguring Eclipse can be quite challenging. If you get errors like\n`Unable locate installable unit in target definition`,\n[this discussion](https://stackoverflow.com/questions/10547007/unable-locate-installable-unit-in-target-definition)\nmay help. \n\n#### Copy the Maven modules\nGo back to the command line and navigate to the \n`olca-app/olca-app` folder:\n\n```bash\ncd olca-app/olca-app\n```\n\nand run \n\n```bash\nmvn package\n```\n\nThis will copy the installed openLCA core modules and dependencies (see above)\nto the folder `olca-app/olca-app/libs`.\n\n#### Test the application\nRefresh your Eclipse workspace (select all and press `F5`). Open the file\n[olca-app/openLCA.product](./olca-app/openLCA.product) within  Eclipse and click\non the run icon inside the `openLCA.product` tab. openLCA should now start.\n\nIf you want to build an installable product, see the description in the \n[olca-app-build](./olca-app-build) sub-project or simply use the Eclipse export\nwizard (Export/Eclipse product).     \n\n#### Build the database templates\nThe openLCA application contains database templates that are used when the user\ncreates a new database (empty, with units, or with all reference data). There\nis a Maven project `olca-refdata` that creates these database templates and\ncopies them to the `olca-app/olca-app/db_templates` folder from which openLCA\nloads these templates. To build the templates, navigate to the refdata project\nand run the build:\n\n```bash\ncd olca-app/olca-refdata\nmvn package\n```\n\n## License\nUnless stated otherwise, all source code of the openLCA project is licensed\nunder the [Mozilla Public License, v. 2.0](http://mozilla.org/MPL/2.0/). Please\nsee the LICENSE.txt file in the root directory of the source code.\n","funding_links":[],"categories":["Carbon Footprint (EEIO or LCA models)","Industrial Ecology"],"sub_categories":["Life Cycle Assessment"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGreenDelta%2Folca-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGreenDelta%2Folca-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGreenDelta%2Folca-app/lists"}